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 — installation en un clic pour Claude Desktop, Cursor et Windsurf.

Tu as déjà un compte Insourcia ?

Va sur app.insourcia.io/settings — 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 (via Smithery)
• Cursor (IDE)
• Continue (extension VSCode/JetBrains)
• Cline (extension VSCode)
• Windsurf (via Smithery)
• N’importe quel client MCP-compatible

Installation via Smithery (Claude Desktop, Cursor, Windsurf)

Le moyen le plus rapide d’ajouter Insourcia à ton client MCP :

1. Va sur smithery.ai/server/@insourcia/insourcia
2. Clique Connect et choisis ton client (Claude Desktop, Cursor, Windsurf…)
3. Smithery génère la commande / la config à coller — copie-la
4. Au premier appel d’un tool, ton client ouvre un flow OAuth vers app.insourcia.io pour t’authentifier

Tu peux aussi fournir directement une clé API (isk_xxx) dans le champ apiKey au lieu d’OAuth, utile pour les clients non-interactifs.

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. Remplacez isk_VOTRE_CLE par votre vraie clé (disponible dans Settings → API/MCP).

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.