MCP server
MCP (Model Context Protocol) est un protocole ouvert initié par Anthropic pour connecter des assistants et des agents IA à des sources de données et à des actions.
Insourcia expose un serveur MCP officiel : https://mcp.insourcia.io/mcp. Il sert, en protocole MCP natif, quasiment le même catalogue d’outils que /v1/rpc/tools : les écarts sont listés dans Outils disponibles. Le serveur utilise uniquement le transport Streamable HTTP : ajoutez-le par son URL, sans programme local à lancer.
Deux adresses : complète et répertoires
Section intitulée « 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 (connecteur personnalisé), clients MCP | 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 outils d’analyse et de veille, 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. Les outils absents de cette version sont listés dans Outils disponibles. |
Si vous avez ajouté Insourcia depuis le répertoire de ChatGPT ou de Claude, vous utilisez la seconde. Pour la version complète, ajoutez un connecteur personnalisé avec https://mcp.insourcia.io/mcp. Une connexion OAuth vaut pour les deux adresses.
Deux méthodes d’authentification
Section intitulée « Deux méthodes d’authentification »| Méthode | URL MCP | Quand l’utiliser |
|---|---|---|
| OAuth | https://mcp.insourcia.io/mcp | Clients qui prennent en charge OAuth (claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor). Le client ouvre une fenêtre d’autorisation au premier appel : aucune clé en clair dans la configuration. |
| Clé API dans l’URL | https://mcp.insourcia.io/isk_VOTRE_CLE | Clients sans OAuth (Le Chat, n8n, scripts). Aucune étape de connexion. |
Pour générer ou retrouver votre clé API (isk_…), ouvrez Paramètres > API / MCP.
Clients compatibles
Section intitulée « Clients compatibles »- Claude (claude.ai et Claude Desktop)
- Claude Code
- ChatGPT
- Le Chat (Mistral)
- Cursor
- Windsurf
- Continue (extension VS Code et JetBrains)
- Cline (extension VS Code)
- Gemini CLI
- n8n
- tout client MCP qui prend en charge Streamable HTTP
Claude et Claude Desktop
Section intitulée « Claude et Claude Desktop »- Settings → Connectors → Add custom connector
- Nom :
Insourcia. URL :https://mcp.insourcia.io/mcp(OAuth), ouhttps://mcp.insourcia.io/isk_VOTRE_CLE(clé dans l’URL). - Add. En OAuth, autorisez l’accès au premier appel ; avec la clé dans l’URL, la connexion est immédiate.
Claude Code
Section intitulée « Claude Code »claude mcp add --transport http insourcia https://mcp.insourcia.io/mcpAu premier appel, Claude Code ouvre la fenêtre de connexion OAuth (commande /mcp pour la relancer).
Dans ~/.cursor/mcp.json (ou .cursor/mcp.json à la racine d’un projet) :
{ "mcpServers": { "insourcia": { "url": "https://mcp.insourcia.io/mcp" } }}Windsurf
Section intitulée « Windsurf »Dans mcp_config.json (Settings → Cascade → MCP Servers → View raw config) :
{ "mcpServers": { "insourcia": { "serverUrl": "https://mcp.insourcia.io/mcp" } }}Continue
Section intitulée « Continue »Dans votre fichier de configuration YAML de Continue :
mcpServers: - name: Insourcia type: streamable-http url: https://mcp.insourcia.io/mcpSi votre client ne gère pas OAuth, remplacez l’URL par https://mcp.insourcia.io/isk_VOTRE_CLE.
Configuration par client
Section intitulée « Configuration par client »Choisissez votre méthode d’authentification (OAuth ou clé API), puis copiez l’URL ou la commande de votre client :
La clé est intégrée à l'URL MCP. Aucune étape de connexion, pour les clients sans OAuth.
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 --transport http insourcia 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 l'interrupteur.
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.
Outils disponibles
Section intitulée « Outils disponibles »21 outils annoncés par le serveur MCP.
Absents de la version listée dans les répertoires de ChatGPT et de Claude : set_list_monitoring, reveal_director_email, get_account.
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é |
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 |
set_list_monitoring | Activer ou couper la veille d'une liste |
get_news | Fil de veille |
mark_news_read | Signaux traités |
Contact
| Tool | Action |
|---|---|
reveal_director_email | Email professionnel d'un dirigeant |
Compte
| Tool | Action |
|---|---|
get_account | État du compte |
Les outils de lot de la surface Tools RPC (get_companies, get_financials_batch…) ne sont pas annoncés ici : get_company, get_financials, get_credit_risk, get_directors, get_events et get_company_graph acceptent directement une liste de SIREN (paramètre sirens).
Exemples d’usage
Section intitulée « Exemples d’usage »Dans Claude Code :
> Trouve-moi les 10 plus grosses sociétés de logiciels en Île-de-France qui n'ont pas levé de fonds depuis 3 ans
[Claude appelle search_companies]> Donne-moi le bilan 2023 de Vinci
[Claude appelle search_companies, puis get_financials]MCP ou Tools RPC
Section intitulée « MCP ou Tools RPC »| MCP | Tools RPC | |
|---|---|---|
| Protocole | MCP (JSON-RPC sur Streamable HTTP) | HTTP standard |
| Public | Clients MCP | Tout client HTTP |
| Liste des outils | tools/list | GET /v1/rpc/tools |
| Authentification | OAuth ou clé API | Bearer (clé API) |
Si votre client prend en charge MCP, utilisez MCP : le modèle voit les outils directement, sans OpenAPI à coller. Sinon, Tools RPC.
Chaque appel d’outil est débité en crédits, au même coût que l’appel REST équivalent. Coûts par opération, règles de décompte et erreurs de solde : Tarification et crédits.
Besoin d’aide ?
Section intitulée « Besoin d’aide ? »Une connexion qui échoue, un outil qui ne répond pas comme attendu, une question sur les crédits : écrivez à support@insourcia.io. 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.