Aller au contenu

Guide pratique

Configuration

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

4 min

En bref

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

Avant de commencer

  1. Creer une cle dans la carte Nouvelle cle MCP de la page Cles API
  2. Avoir un client MCP installe (Claude Desktop, VS Code, Cursor, Claude Code, ou n8n)
  3. 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-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

SymptomeCause probableSolution
401 UnauthorizedCle API invalide, expiree ou revoqueeCreez une nouvelle cle dans la carte Nouvelle cle MCP
403 ForbiddenScope manquantAjoutez les scopes requis a votre cle
-32020 Header mismatchEn-tete MCP moderne different de la requeteMettez a jour le client MCP ; ne saisissez pas ces en-tetes a la main
-32022 Unsupported protocol versionVersion demandee non accepteeChoisissez une version de supportedVersions ou activez la negociation automatique
Aucun outil visibleMauvais Workspace IDVerifiez l'identifiant dans les parametres
Connexion coupeeTimeout reseauRelancez 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.

Cette page vous a-t-elle permis d’atteindre votre objectif ?