Aller au contenu

MCP du connecteur

En bref

Le serveur MCP sensaas-connecteur permet à un agent IA de découvrir et d'appeler les points d'entrée de l'API v2 du connecteur. Sa documentation complète — installation, configuration, outils exposés — est sur la page MCP « sensaas-connecteur ». Cette page-ci répond à une seule question : quand l'utiliser, et quand utiliser Sentral à la place.

Deux serveurs, deux natures d'information

Sentral MCP du connecteur
Ce qu'il sert la connaissance indexée l'API vivante
Nature statique, vérifiable authentifiée, changeante
Identifiants aucun oui — un compte sur un connecteur
Données clients jamais oui, ce sont les données réelles du dossier
Réponse à « comment ça marche », « quelle table », « quel compte » « que contient ce dossier, maintenant »

C'est la raison pour laquelle ils ne sont pas fusionnés : les mêler rendrait Sentral non déployable sans un compte sur l'API d'un client, et ferait grossir sa liste d'outils pour tous les agents, y compris ceux qui n'en ont que faire. Deux natures, deux serveurs.

Quand utiliser lequel

Utilisez Sentral quand la réponse existe déjà quelque part et ne dépend pas d'un dossier :

  • comprendre une convention de l'API (enveloppe des réponses, pagination, format d'erreur) ;
  • savoir quelle table Sage porte une donnée, quelles colonnes, quelles jointures ;
  • retrouver un article d'assistance Sage, une règle métier, un compte du plan comptable ;
  • retrouver où une classe ou une méthode est écrite dans le code.

Utilisez le MCP du connecteur quand la réponse dépend d'une installation :

  • lister les groupes et les points d'entrée réellement exposés par ce connecteur, tels que sa spécification les publie ;
  • lire le détail d'un point d'entrée : paramètres, corps attendu, réponses possibles ;
  • s'authentifier et appeler un point d'entrée pour observer sa réponse réelle sur un dossier de démonstration.

Dans une session d'intégration, on fait souvent les deux

L'ordre efficace : Sentral pour comprendre la convention et trouver la donnée côté Sage, puis le MCP du connecteur pour confirmer ce que l'installation expose vraiment. Un écart entre la documentation et l'installation est une information utile, pas un incident.

Deux catalogues de points d'entrée, et pourquoi ils diffèrent

Sentral possède lui aussi un outil sur l'API (find_endpoint), mais il ne remplace pas le MCP du connecteur : il sert un catalogue, pas une installation. Il distingue explicitement deux origines :

  • le contrat publié de l'API SenSaaS : ce que l'API promet ;
  • les routes extraites du code : ce que le code expose.

Un écart entre les deux est une information. Le MCP du connecteur, lui, lit la spécification servie par une installation, et peut l'appeler.

mcp-sensaas : le troisième serveur, non déployé

Un troisième serveur MCP existe, écrit dans le dépôt de connaissance interne : il explore l'API SenSaaS en lecture seule, en quatre étages (domaines, points d'entrée filtrés, description, appel), et ne rend jamais une réponse brute — il rend la forme des données, le nombre d'éléments et un échantillon, pour qu'un agent comprenne une API sans la déverser dans son contexte.

Il refuse toute écriture par construction, et rien n'est écrit sur disque : les réponses contiennent des données clients, elles passent dans le contexte de l'agent et n'y survivent pas.

État : en attente d'un compte de service en lecture

Ce serveur n'est pas déployé sur la machine du bureau, alors que Sentral l'est. Ce n'est pas un oubli : le centraliser changerait deux choses qu'aucun compte de développeur ne doit porter — une identité de service partagée face à l'API d'un client, et des journaux de lectures de données clients sur une machine de bureau. Il reste donc sur les postes, chacun avec ses propres identifiants. Le sujet est débloqué le jour où un compte en lecture seule existe.

Ne pas confondre les deux dans un fichier de configuration

sensaas-connecteur et mcp-sensaas explorent la même API mais sont deux programmes distincts, dans deux dépôts. Celui qui est documenté et utilisable aujourd'hui est sensaas-connecteur.

Questions fréquentes

Un agent peut-il modifier des données par ces serveurs ?

mcp-sensaas refuse toute méthode de modification, sans exception possible, et met sur liste noire les opérations qui changent un compte. Pour sensaas-connecteur, reportez-vous à sa page : il expose un outil d'appel générique, donc le périmètre dépend du compte utilisé. Utilisez un compte de démonstration.

Faut-il un connecteur installé pour s'en servir ?

Pour appeler, oui. Pour la seule découverte, le serveur sait travailler à partir d'un fichier de spécification OpenAPI, sans connecteur joignable.

Voir aussi