En bref
Connectez votre client IA au serveur MCP de la plateforme pour piloter vos donnees en langage naturel.
Avant de commencer
- Creer une cle dans la carte Nouvelle cle MCP de la page Cles API
- Avoir un client MCP installe (Claude Desktop, VS Code, Cursor, Claude Code, ou n8n)
- Connaitre votre Workspace ID pour une configuration manuelle (visible dans les parametres de votre espace)
Etapes
Le serveur accepte MCP 2026-07-28 et les versions historiques 2025-11-25,
2025-06-18 et 2025-03-26 sur la meme URL. Un client recent qui prend en
charge la negociation automatique peut utiliser server/discover ; les clients
historiques continuent avec initialize. Laissez votre client construire les
en-tetes de protocole pour chaque requete.
Juste apres la creation de la cle, l'interface propose une configuration prete a copier pour Claude Code, Cursor ou Devin. Elle utilise le workspace actif et l'URL MCP de l'environnement. Les exemples ci-dessous servent aux autres clients ou a une configuration manuelle.
Claude Desktop
Ouvrez le fichier claude_desktop_config.json et ajoutez :
{
"mcpServers": {
"ontologie": {
"url": "https://api.ontologie-growthsystemes.com/api/mcp",
"headers": {
"X-API-Key": "df_VOTRE_CLE_MCP",
"x-workspace-id": "VOTRE_WORKSPACE_ID"
}
}
}
}
VS Code (extension Copilot MCP)
Ajoutez dans votre settings.json :
{
"mcp": {
"servers": {
"ontologie": {
"url": "https://api.ontologie-growthsystemes.com/api/mcp",
"headers": {
"X-API-Key": "df_VOTRE_CLE_MCP",
"x-workspace-id": "VOTRE_WORKSPACE_ID"
}
}
}
}
}
Cursor
Ouvrez Settings > MCP Servers et ajoutez :
{
"ontologie": {
"url": "https://api.ontologie-growthsystemes.com/api/mcp",
"headers": {
"X-API-Key": "df_VOTRE_CLE_MCP",
"x-workspace-id": "VOTRE_WORKSPACE_ID"
}
}
}
Claude Code
Depuis votre terminal :
claude mcp add ontologie \
--transport http \
https://api.ontologie-growthsystemes.com/api/mcp \
--header "X-API-Key: df_VOTRE_CLE_MCP" \
--header "x-workspace-id: VOTRE_WORKSPACE_ID"
Ou ajoutez dans votre fichier .mcp.json :
{
"mcpServers": {
"ontologie": {
"type": "http",
"url": "https://api.ontologie-growthsystemes.com/api/mcp",
"headers": {
"X-API-Key": "df_VOTRE_CLE_MCP",
"x-workspace-id": "VOTRE_WORKSPACE_ID"
}
}
}
}
n8n
Dans n8n, configurez un noeud MCP Client avec :
- URL :
https://api.ontologie-growthsystemes.com/api/mcp - Authentification : Credentials de type "Header Auth"
- Header
X-API-Keyavec la valeur composite :VOTRE_CLE_MCP:VOTRE_WORKSPACE_ID
- Header
n8n ne supporte qu'un seul header d'authentification. Le serveur MCP accepte le format composite
cle_api:workspace_id dans le header X-API-Key.
Stockez votre cle API dans une variable d'environnement plutot qu'en clair dans le fichier de configuration.
Resultat attendu
Votre client IA est connecte a la plateforme. Vous pouvez interroger vos donnees, lancer des workflows et rechercher des documents depuis votre interface IA.
Limites / erreurs frequentes
| Symptome | Cause probable | Solution |
|---|---|---|
401 Unauthorized | Cle API invalide, expiree ou revoquee | Creez une nouvelle cle dans la carte Nouvelle cle MCP |
403 Forbidden | Scope manquant | Ajoutez les scopes requis a votre cle |
-32020 Header mismatch | En-tete MCP moderne different de la requete | Mettez a jour le client MCP ; ne saisissez pas ces en-tetes a la main |
-32022 Unsupported protocol version | Version demandee non acceptee | Choisissez une version de supportedVersions ou activez la negociation automatique |
| Aucun outil visible | Mauvais Workspace ID | Verifiez l'identifiant dans les parametres |
| Connexion coupee | Timeout reseau | Relancez la connexion dans le client |
Besoin d'aide ?
Ecrivez-nous : Support et contact.
Vérifier la connexion et la surface effective
Utilisez en priorité la configuration proposée après création de la clé MCP dans l'application : elle reprend l'environnement et le workspace actifs. La prise en charge d'un serveur HTTP distant dépend du client et de sa version ; vérifiez son mode de connexion avant de copier un fichier d'exemple.
Après connexion, demandez au client de lister les outils disponibles. Comparez la liste au profil et aux scopes de votre clé, puis effectuez une lecture sur une donnée connue. Le catalogue complet du produit ne décrit pas nécessairement la surface exposée à cette clé.
Un outil absent peut être filtré par le profil, la publication ou les permissions. Ne contournez pas ce filtre avec une route interne. Pour les documents, consultez les outils de base de connaissances ; pour une action, vérifiez le contrat et les contrôles de préparation.
