Aller au contenu

Guide pratique

Configuration

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

1 min

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

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 ou expireeRegenerez une cle avec le preset MCP
403 ForbiddenScope manquantAjoutez les scopes requis a votre cle
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.