Aller au contenu principal

MCP Server

En bref

Le serveur MCP (Model Context Protocol) permet de piloter Ontologie depuis vos clients IA — Claude Desktop, VS Code, Cursor ou tout autre client compatible. Vous pouvez interroger votre ontologie, lancer des workflows, rechercher des documents et manipuler vos donnees directement depuis votre interface IA habituelle.

Exemple concret : depuis Claude Desktop, demandez "Quels sont les fournisseurs actifs dans mon ontologie ?" et l'agent interroge directement vos donnees via MCP, sans ouvrir l'application.

Tutoriel video — Brancher le MCP a Claude Code

Ce que vous allez faire

  • Creer une cle API avec le preset MCP
  • Configurer votre client IA pour se connecter a la plateforme
  • Utiliser les outils MCP pour interagir avec vos donnees

Vocabulaire cle

TermeSignification
MCPModel Context Protocol — standard ouvert pour connecter des modeles IA a des sources de donnees et outils.
ToolUne action que le client IA peut executer (recherche, creation d'entite, lancement de workflow, etc.).
ResourceUn contenu lisible expose par le serveur (schema d'ontologie, liste de dashboards, etc.).
PromptUn template de requete pre-configure pour des cas d'usage courants.

Capacites

La surface publique par défaut expose 39 outils répartis en 3 catégories. Ce total est calculé depuis le contrat preview-stable du backend. Des outils supplémentaires peuvent apparaître sur la surface preview-full lorsque l'offre, les modules et les feature flags du workspace les autorisent.

Configuration par client

Claude Desktop

Ouvrez le fichier de configuration Claude Desktop (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 VS Code :

{
"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

Ajoutez dans la configuration MCP de Cursor (Settings > 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"
}
}
}

Astuce
Stockez votre cle API dans une variable d'environnement plutot qu'en clair dans le fichier de configuration.

Outils disponibles

La surface stable expose 39 outils dans les catégories Administration, Capacités DataForge et Ontologie. La réponse tools/list de votre client reste la source de vérité pour votre workspace, car les outils disponibles dépendent aussi des scopes, modules et flags actifs.

Scopes et permissions

Les outils MCP necessitent des scopes specifiques sur votre cle API :

ScopeAcces
mcp.readLecture seule (lister, rechercher, consulter)
mcp.writeEcriture (creer, modifier, supprimer)
mcp.workflow.executeLancer des executions de workflow
mcp.agent.executeInvoquer l'agent IA
governance.readConsulter approbations, classifications et lignee
governance.writeCreer des demandes, enregistrer la lignee
governance.approveApprouver ou rejeter des demandes
governance.adminLancer des controles qualite

Le preset MCP dans la page Cles API configure automatiquement les scopes recommandes.

Vues / modules associes

Reference complete des outils

Portail Client
La référence générée des 39 outils stables contient les schémas de sortie, scopes et exemples disponibles dans les contrats du code.

Contactez votre interlocuteur commercial ou ecrivez a support@growthsystemes.com pour obtenir vos identifiants d'acces.

Resultat attendu

Votre client IA est connecte a la plateforme. Vous pouvez interroger vos donnees, lancer des workflows et rechercher des documents directement depuis Claude Desktop, VS Code ou Cursor.

Besoin d'aide ?

Ecrivez-nous : Support et contact.