Utiliser les connecteurs MCP

Chatbotaurus utilise le Model Context Protocol (MCP) pour parler à des services externes. Un connecteur expose des outils que l'agent peut appeler.

Où vivent les connecteurs

Emplacement	Contenu
`connectors/*.yaml` (racine du dépôt)	Fiches déclaratives : adresse de base, authentification, outils. Lues par `crates/forge-mcp/src/connector/yaml_loader.rs`.
`crates/forge-mcp/src/connector/`	Code Rust commun : client HTTP, import OpenAPI, client XML-RPC Odoo, client CLI `calrs`.

Le dossier connectors/ compte 195 fiches YAML (mesure du 3 octobre 2026). Ajouter un outil HTTP se fait en ajoutant une fiche, sans écrire de Rust. Voir Créer votre premier connecteur MCP.

Exemples de fiches présentes

Chaque nom ci-dessous correspond à un fichier de connectors/.

Domaine	Fiches
ERP, gestion	`odoo`, `dolibarr`, `akaunting`, `invoiceninja`
Automatisation, rendez-vous	`n8n`, `calrs`
Analytique, recherche	`matomo`, `typesense`, `searxng`
Communication, support	`rocketchat`, `element`, `freescout`, `discourse`, `listmonk`
Fichiers, code	`nextcloud`, `forgejo`
Identité, secrets	`authentik`, `openbao`
IA, vecteurs, voix	`ollama`, `localai`, `qdrant`, `kokoro-tts`
Observabilité	`grafana`, `victoriametrics`, `victorialogs`
Données publiques UE	`cordis`, `eurostat`, `europeana`, `eurlex`, `enisa`, `europe-pmc`, `data-europa`

Pour l'ERP, odoo porte un registre de 711 outils (mesure du 3 octobre 2026) et un client XML-RPC. Voir Connecter Odoo à la passerelle MCP et la vue d'ensemble des connecteurs.

Le nombre de fiches n'est pas le nombre de services prouvés. Le catalogue public compte 108 entrées, dont 96 avec une fiche et 15 marquées « disponibles » (mesure du 3 octobre 2026).

Un connecteur lit ses secrets au moment de la requête, depuis les identifiants enregistrés sur /credentials (chiffrés en base, voir Sécurité et identifiants). Ne placez jamais une clé dans une fiche YAML : une fiche référence une variable, par exemple ${NOM_DE_VARIABLE}.

Transport MCP

Le backend expose le transport HTTP streamable (voir Architecture Chatbotaurus). La version de protocole courante du code est 2025-03-26. La route est authentifiée :

POST   /api/v1/mcp   -> JSON-RPC 2.0 (initialize, tools/list, tools/call)
GET    /api/v1/mcp   -> flux SSE de notifications
DELETE /api/v1/mcp   -> fermer la session

La session est portée par l'en-tête Mcp-Session-Id. Le transport est actif si MCP_ENABLED et API_ENABLED le sont. Voir Routes MCP.

Consulter le catalogue par l'API

Le jeton s'obtient par la connexion : voir Authentification.

# Connecteurs chargés par l'instance (jeton requis)
curl -H "Authorization: Bearer <jeton>" \
  http://localhost:3000/api/v1/mcp/catalogue

# Une entrée
curl -H "Authorization: Bearer <jeton>" \
  http://localhost:3000/api/v1/mcp/catalogue/<identifiant>

La famille /api/v1/mcp-gateway/* (par exemple /mcp-gateway/servers) porte la passerelle (Routes des gateways et de la prédiction). Le catalogue d'applications métier (Routes du catalogue métier) est sous /api/v1/mcp/catalog-business.

Déploiement : pas encore. Les routes deploy, start, stop, restart, security et secrets de /api/v1/mcp/catalog-business/{id}/... répondent 503 FEATURE_PENDING avec un en-tête Retry-After à un administrateur (un autre rôle reçoit 403, sauf security qui répond 503 à tout rôle). Elles attendent l'adaptateur Podman de forge-api (spec 16, tâche P5.5). Il n'existe pas de route /mcp/gateways/<nom>/deploy. Pour lancer un serveur aujourd'hui, utilisez le plan compose mgaas-vps2.

Voir aussi

Parcourir le catalogue de services et préparer un déploiement : ce qui marche et ce qui est en sommeil
Conception des connecteurs MCP : manifestes YAML, connecteurs natifs et contrôle de conformité UE
Connecteur Odoo : le connecteur qui porte le registre d'outils nommés et génériques
MCP et Orchestrateur : les catalogues de serveurs tels que l'application les montre
Déploiement avec Podman : lancer le plan client qui porte les serveurs
Fichiers de configuration : la structure des manifestes de connecteurs

Raccourcis clavier