Agents et connaissance interne¶
En bref
SenSaaS met sa connaissance interne et son API à disposition d'agents IA par des serveurs MCP (Model Context Protocol, le protocole standard par lequel un agent déclare et appelle des outils). Un serveur sert la connaissance (Sentral), les autres servent l'API vivante du connecteur. Cette section explique lequel utiliser, qui y a accès et quelles règles s'appliquent.
À quoi sert un serveur MCP ici¶
Un agent de code — Claude Code, Cursor, ou un agent maison — ne sait rien de Sage 100 ni de SenSaaS. Il a deux façons d'apprendre : fouiller les dépôts et les écrans (lent, coûteux en jetons, souvent faux), ou appeler un outil qui lui rend la bonne information déjà vérifiée. Un serveur MCP est le catalogue de ces outils.
Deux natures d'information, donc deux familles de serveurs, et elles ne sont jamais mélangées :
- la connaissance indexée : statique, vérifiable, sans identifiant, sans donnée client — c'est Sentral ;
- l'API vivante : authentifiée, changeante, et qui renvoie de vraies données clients — c'est le MCP du connecteur.
Les mêler aurait deux effets : Sentral ne serait plus déployable sans un compte sur l'API d'un client, et sa liste d'outils grossirait pour tous les agents, y compris ceux qui n'en ont que faire.
Les serveurs MCP existants¶
| Serveur | Ce qu'il sert | Où il tourne | Qui l'appelle |
|---|---|---|---|
sentral (dépôt senkb) |
la connaissance interne : recherche documentaire et cinq registres déterministes — 25 outils | la tour du bureau, en HTTP sur le port 8101 | tout poste de l'équipe sur le réseau du bureau ; à distance, chacun monte sa propre instance |
sensaas-connecteur |
l'API v2 du connecteur : découverte des groupes et des endpoints depuis la spécification OpenAPI, puis appel authentifié | sur le poste, lancé en local par l'agent | développeur ou intégrateur qui dispose d'un connecteur joignable |
mcp-sensaas (dépôt senkb) |
exploration en lecture seule de l'API SenSaaS, en quatre étages, réponses résumées | sur le poste — non déployé | en attente d'un compte de service en lecture |
sage100-api |
la bibliothèque API100c de Sage | ||
sage100-schema |
le schéma SQL de Sage |
Deux serveurs différents pour l'API SenSaaS
sensaas-connecteur (dépôt Serveur/mcp/) et mcp-sensaas (dépôt senkb) explorent tous les
deux l'API SenSaaS, mais ce sont deux programmes distincts, écrits dans deux dépôts. Le
premier est celui qui est documenté et utilisable aujourd'hui ; le second attend un compte de
service. Ne pas les confondre dans un .mcp.json.
Qui y accède¶
Sur le réseau du bureau. Rien à installer pour Sentral : quatre lignes dans le fichier
.mcp.json d'un projet et le poste l'appelle. Ni Python, ni base de données, ni identifiant. Le
détail est sur Sentral.
À distance. Le serveur du bureau est volontairement injoignable de l'extérieur : il n'écoute que sur l'adresse du réseau local, jamais sur toutes les interfaces. Ce n'est pas une règle de pare-feu, c'est la façon dont le socket est ouvert — et c'est ce qui la rend difficile à défaire par accident. La bonne voie à distance est d'installer sa propre instance depuis un clone du dépôt.
Pas d'authentification, pas de droits par outil. Sentral sert ses 25 outils à qui l'appelle : le réseau est l'authentification. Un agent tourné vers un client ne doit donc pas voir les outils internes — et seule la liste blanche du programme qui pilote l'agent l'en empêche. Voir Règles pour les agents.
Le principe qui gouverne tout¶
On ne sert que ce qu'on peut vérifier, et on dit toujours d'où ça vient.
Une donnée non validée est annoncée comme telle dans la réponse de l'outil, pas dans une note de documentation que l'agent ne lira pas. Une valeur au découpage douteux est écartée et comptée, plutôt que servie au hasard. Un faux libellé est pire qu'un libellé absent : il se propage sans qu'on le voie.
Deux conséquences pratiques :
- un référentiel structuré ne se cherche pas comme de la prose. Un plan comptable, un schéma de tables, une liste de colonnes exigent en plus de la recherche un registre déterministe et son outil dédié. La leçon a été payée : la bonne fiche du plan comptable sortait 16ᵉ sur 9 582 passages ;
- plus de contenu n'est pas mieux. Le serveur est lu par des agents qui paient chaque jeton. Une source n'entre que si elle répond à une question qu'on ne sait pas traiter, et elle arrive avec son budget mesuré.
Où aller ensuite¶
| Vous voulez… | Page |
|---|---|
| brancher un agent sur la connaissance interne | Sentral |
| savoir quel outil répond à quelle question | Les 25 outils de Sentral |
| verser un corpus, ou savoir ce qu'on a le droit d'éditer | Les corpus |
| faire découvrir et appeler l'API v2 par un agent | MCP du connecteur |
| connaître les interdits | Règles pour les agents |