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).

Tu as déjà un compte Insourcia ?

Va sur app.insourcia.io/settings?tab=api — onglet API/MCP. Tu y trouveras les URLs prêtes à copier avec ta clé, et un toggle pour basculer entre OAuth et clé API dans l’URL.

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 :

1. Claude Desktop → Settings → Connectors → Add custom connector
2. Nom : Insourcia. URL :
   • OAuth : https://mcp.insourcia.io/mcp
   • ou clé dans l’URL : https://mcp.insourcia.io/{votre-cle-api}
3. 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

Utilise le toggle pour basculer entre les deux méthodes d’authentification, puis copie l’URL ou la commande correspondant à ton client :

Clé API dans l'URLOAuth

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

Claude Desktop

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

Claude Code

CLI

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

ChatGPT

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

Le Chat

Mistral

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

HuggingChat

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

Gemini CLI

CLI

1. Dans votre terminal :
   gemini mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLECopier
2. 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 :

• search_companies
• get_company
• get_financials
• get_directors
• search_announcements

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.