Configurer un client MCP

En bref

Connectez votre client IA au serveur MCP de la plateforme pour piloter vos donnees en langage naturel.

Avant de commencer

1. Avoir une cle API avec le preset MCP (voir Cles API)
2. Avoir un client MCP installe (Claude Desktop, VS Code, Cursor, Claude Code, ou n8n)
3. Connaitre votre Workspace ID (visible dans les parametres de votre espace)

Etapes

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-Key avec la valeur composite : VOTRE_CLE_MCP:VOTRE_WORKSPACE_ID

Format n8n
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.

Astuce securite
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 ou expiree	Regenerez une cle avec le preset MCP
403 Forbidden	Scope manquant	Ajoutez les scopes requis a votre cle
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.