Outils MCP
Surface publique des outils MCP, OAuth et exécution gouvernée pour les clients agent.
Vue d'ensemble
Numezis expose un serveur MCP distant pour Claude, ChatGPT et les autres clients
MCP. tools/list publie des façades de domaine appelables. Une façade exécute
une opération API gouvernée : une lecture reste une lecture, et une mutation
suit toujours l'activation des modules, les permissions et la politique
d'approbation.
La configuration pour l'utilisateur final (connecteurs, captures OAuth) se trouve dans le guide produit MCP. Cette page documente le contrat d'intégration pour les développeurs.
Endpoint et transport
| Élément | Valeur |
|---|---|
| URL | https://www.numezis.com/mcp |
| Transport | Streamable HTTP (JSON-RPC 2.0) |
| Auth | OAuth 2.0 avec Dynamic Client Registration |
Transmettez le contexte de portail via la session authentifiée établie au moment
de l'OAuth. L'exécution des outils utilise les mêmes règles AccessMode que le
portail entreprise (/c).
Découverte des outils
Après autorisation, appelez tools/list. La liste est paginée (nextCursor).
Chaque entrée est une façade appelable, nommée numezis.<domaine>.<verbe> ou
numezis.<domaine>.<famille>.<verbe>. La liste ne contient ni
numezis.load_domains, ni un alias retiré, ni un répartiteur générique tel que
sales.query. Un second appel renvoie les mêmes noms.
Chaque outil inclut :
name— la façade à passer àtools/calldescription— la phrase de consentement affichée avant que l'hôte demande confirmationinputSchema— JSON Schema ; une façade de famille prendresourceetargsannotations.title— titre localisé (Domaine · Famille · Verbe)annotations.readOnlyHintetannotations.destructiveHint— l'appel ne fait que lire, ou il peut modifier des enregistrements
Seules les façades des modules activés et des permissions effectives de
l'utilisateur connecté apparaissent. _meta.toolAdmission vaut
domain_facade_catalog.
Exécution et approbations
- Le client envoie
tools/callavec le nom de l'outil et des arguments validés. - Le serveur exécute les contrôles de politique (module, permission, statut de l'entreprise).
- Les outils critiques peuvent renvoyer un jeton d'approbation au lieu d'appliquer la mutation.
- L'utilisateur confirme dans l'interface Numezis ; le client réessaie avec la référence d'approbation.
Ne contournez pas les étapes d'approbation dans l'automatisation — utilisez des outils de lecture non critiques pour pré-vérifier les données, puis présentez l'UX d'approbation à l'utilisateur.
Erreurs
Les erreurs MCP reflètent la sémantique de l'API : les erreurs d'autorisation, de validation et les limites de débit sont renvoyées comme des erreurs RPC structurées. Notez les identifiants de corrélation des réponses lorsque vous ouvrez des tickets de support.