MCP server

MCP (Model Context Protocol) est le protocole standard d’Anthropic pour connecter des LLM agentiques à des sources de données / actions.

Insourcia expose un serveur MCP officiel : https://mcp.insourcia.io. Il sert le même catalogue de tools que /v1/rpc/tools, mais en protocole MCP natif.

Le serveur est aussi listé sur le catalogue Smithery, utilisable via leur CLI (voir plus bas).

Deux adresses : complète et répertoires

Insourcia sert deux versions de son serveur MCP, sur le même domaine, avec le même compte et la même authentification :

Adresse	Pour qui	Contenu
`https://mcp.insourcia.io/mcp`	Connecteur ajouté à la main (custom connector), clients MCP, Smithery	La version complète, recommandée pour un usage direct.
`https://mcp.insourcia.io/mcp/directory`	Version listée dans les répertoires de ChatGPT et de Claude	Les mêmes outils, sans les données personnelles non nécessaires à l’analyse d’entreprise : pas de profil LinkedIn, date de naissance des dirigeants au mois, sans lieu de naissance.

Si tu as ajouté Insourcia depuis le répertoire de ChatGPT ou de Claude, tu utilises la seconde. Pour la version complète, ajoute un connecteur personnalisé avec https://mcp.insourcia.io/mcp. Une connexion OAuth vaut pour les deux adresses.

Deux méthodes d’authentification

Le serveur supporte deux façons de s’authentifier — choisis selon ton client :

Méthode	URL MCP	Quand l’utiliser
OAuth	`https://mcp.insourcia.io/mcp`	Clients qui supportent OAuth (claude.ai, Smithery, ChatGPT MCP, Cursor). Le client ouvre un flow d’autorisation au premier appel — pas de clé en clair côté config.
Clé API dans l’URL	`https://mcp.insourcia.io/{votre-cle-api}`	Clients sans OAuth (Claude Desktop ancien, Mistral Le Chat, n8n, scripts). Zéro étape de login, fonctionne partout.

Pour générer ou récupérer ta clé API (isk_…), ouvre Settings → API/MCP.

Clients supportés

Claude Code (Anthropic CLI)
Claude Desktop
Cursor (IDE)
Continue (extension VSCode/JetBrains)
Cline (extension VSCode)
Windsurf
N’importe quel client MCP-compatible

Ajouter à Claude Desktop (méthode directe)

C’est la voie la plus simple et la plus fiable, sans dépendance externe :

Claude Desktop → Settings → Connectors → Add custom connector
Nom : Insourcia. URL :
- OAuth : https://mcp.insourcia.io/mcp
- ou clé dans l’URL : https://mcp.insourcia.io/{votre-cle-api}
Add. En OAuth, autorise l’accès au premier appel ; avec la clé dans l’URL, c’est immédiat.

La même logique s’applique à Cursor, Continue, Cline, Windsurf : ajoute un serveur MCP et colle l’URL ci-dessus. Voir Configuration par client plus bas.

Via Smithery (toolbox)

Insourcia est listé sur Smithery. Smithery fonctionne désormais par toolbox : tu ajoutes Insourcia à ta toolbox (bouton Add to toolbox sur la page du serveur), puis tu connectes la toolbox à ton client. L’authentification se fait via OAuth vers app.insourcia.io — aucune clé à copier.

En ligne de commande :

npm install -g smithery
smithery mcp add insourcia/insourcia

Le détail du flow toolbox évolue côté Smithery — réfère-toi à leur documentation CLI. Si tu veux juste Insourcia dans Claude Desktop sans intermédiaire, utilise la méthode directe ci-dessus.

Configuration par client

Choisis ta méthode d’authentification (OAuth ou clé API), puis copie l’URL ou la commande correspondant à ton client :

La clé est intégrée à l'URL MCP. Aucune étape de login, fonctionne partout.

Claude Desktop

Settings → Connectors → Add custom connector.
Nom Insourcia, URL MCP :
https://mcp.insourcia.io/isk_VOTRE_CLE
Add. La connexion est immédiate, aucune authentification supplémentaire requise.

Claude Code

CLI

Dans votre terminal :
claude mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLE
La connexion est immédiate, aucune authentification supplémentaire requise.

ChatGPT

Settings → Apps → Developer mode.
Apps → Add app :
https://mcp.insourcia.io/isk_VOTRE_CLE
Enregistrez. Insourcia est disponible dans vos conversations.

Le Chat

Mistral

Intelligence → Connecteurs → Ajouter → MCP personnalisé.
Nom Insourcia, URL ci-dessous, auth désactivée :
https://mcp.insourcia.io/isk_VOTRE_CLE
Créer. La connexion est immédiate.

HuggingChat

+ → MCP Servers → Manage MCP Servers → + Add Server.
Nom Insourcia, URL :
https://mcp.insourcia.io/isk_VOTRE_CLE
Add Server → Health Check. Activez le toggle.

Gemini CLI

CLI

Dans votre terminal :
gemini mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLE
La connexion est immédiate, aucune authentification supplémentaire requise.

Pour Cursor / Continue / Cline : Settings → MCP → Add server → colle l’URL ci-dessus selon le mode choisi.

Tools disponibles

Identiques à la surface Tools RPC :

24 outils, identiques sur le serveur MCP et sur la surface Tools RPC. Référence interactive avec try-it-now sur /docs/tools.

Découverte

Tool	Action
`search_companies`	Recherche d'entreprises
`resolve_companies`	Rapprochement d'un fichier
`search_directors`	Recherche de dirigeants
`search_director_companies`	Empreinte d'un dirigeant

Profil

Tool	Action
`get_company`	Fiche société
`get_directors`	Dirigeants & mandats
`get_company_graph`	Cartographie de groupe

Finance

Tool	Action
`get_financials`	Bilans & comptes annuels
`get_credit_risk`	Score de risque crédit

Veille légale

Tool	Action
`search_events`	Recherche d'événements
`get_events`	Timeline d'une société

Traitement en lot

Tool	Action
`get_companies`	Fiches en lot
`get_financials_batch`	Historiques financiers en lot
`get_credit_risks`	Scores de risque en lot
`get_directors_batch`	Dirigeants en lot
`get_events_batch`	Événements en lot
`get_company_graphs`	Cartographies de groupe en lot

Surveillance

Tool	Action
`create_saved_search`	Recherche sauvegardée
`list_saved_searches`	Mes recherches sauvegardées
`watch_company`	Mise sous surveillance
`list_watched_companies`	Mes sociétés surveillées
`unwatch_company`	Retirer de la surveillance
`get_news`	Fil de veille
`mark_news_read`	Signaux traités

Exemples d’usage

Dans Claude Code :

> Trouve-moi les 10 plus grosses sociétés de software en Île-de-France
  qui n'ont pas reçu de fonds depuis 3 ans

[Claude appelle search_companies en interne]

> Donne-moi le bilan 2023 de Vinci

[Claude appelle search_companies → get_financials en chaîne]

MCP vs Tools RPC

	MCP	Tools RPC
Protocole	MCP (JSON-RPC over HTTP/stdio)	REST HTTP standard
Public	Clients MCP-compatibles	N’importe quel client HTTP
Discovery	`tools/list` natif	`GET /v1/rpc/tools`
Auth	Bearer / OAuth	Bearer

Si ton client supporte MCP, utilise MCP — l’expérience est plus directe (le LLM voit les tools nativement, pas besoin de coller une OpenAPI). Sinon, Tools RPC.

Besoin d’aide ?

Une connexion qui échoue, un outil qui ne répond pas comme attendu, une question sur les quotas : écrivez à [email protected]. Nous répondons sous 24 heures ouvrées.

Précisez le client utilisé (Claude, ChatGPT, Codex, n8n…) et, si vous en avez un, le nom de l’outil concerné : c’est ce qui permet de retrouver l’appel dans nos journaux.