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 Ontologie
- Utiliser les outils MCP pour interagir avec vos donnees
Vocabulaire cle
| Terme | Signification |
|---|---|
| MCP | Model Context Protocol — standard ouvert pour connecter des modeles IA a des sources de donnees et outils. |
| Tool | Une action que le client IA peut executer (recherche, creation d'entite, lancement de workflow, etc.). |
| Resource | Un contenu lisible expose par le serveur (schema d'ontologie, liste de dashboards, etc.). |
| Prompt | Un template de requete pre-configure pour des cas d'usage courants. |
Avant de commencer
- Avoir une cle API avec le preset MCP (voir Cles API)
- Avoir un client MCP installe
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/mcp/sse",
"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/mcp/sse",
"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/mcp/sse",
"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
Le serveur MCP expose des outils repartis en 11 categories :
| Categorie | Exemples d'outils | Usage |
|---|---|---|
| Ontologie | Lister les entites, creer un noeud, modifier les proprietes | Manipuler votre modele metier |
| Workflow | Lister les workflows, lancer une execution | Automatiser des processus |
| Agent | Invoquer l'agent, consulter les sessions | Poser des questions en langage naturel |
| Knowledge | Rechercher dans les documents, importer | Exploiter votre base de connaissances |
| Live Data | Lister les sources, consulter les streams | Acceder aux donnees en temps reel |
| Calendrier | Creer un evenement, lister les evenements | Gerer votre calendrier |
| Dashboard | Consulter les statistiques, les KPIs | Suivre vos metriques |
| Tableurs | Lire et ecrire dans les feuilles de calcul | Manipuler des donnees tabulaires |
| Bundles | Gerer les packs de configuration | Deployer des configurations |
| Admin | Gerer les utilisateurs, les permissions | Administrer votre workspace |
| Gouvernance | Approbations, classifications, qualite des donnees | Controler et auditer |
Scopes et permissions
Les outils MCP necessitent des scopes specifiques sur votre cle API :
| Scope | Acces |
|---|---|
mcp.read | Lecture seule (lister, rechercher, consulter) |
mcp.write | Ecriture (creer, modifier, supprimer) |
mcp.workflow.execute | Lancer des executions de workflow |
mcp.agent.execute | Invoquer l'agent IA |
Le preset MCP dans la page Cles API configure automatiquement les scopes recommandes.
Resultat attendu
Votre client IA est connecte a Ontologie. Vous pouvez interroger vos donnees, lancer des workflows et rechercher des documents directement depuis Claude Desktop, VS Code ou Cursor.
Voir aussi
- Cles API — Creer une cle avec le preset MCP
- Permissions — Reference des scopes MCP
- Support et contact