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. Les outils correspondent à des opérations API gouvernées : les lectures sont listées dans le manifeste de l'outil ; les mutations respectent l'activation des modules, les permissions et la politique d'approbation pour les outils critiques.
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 pour récupérer les manifestes. Chaque
outil inclut :
name— identifiant stable (correspond aux surfaces d'outil du registre)description— résumé destiné à l'utilisateurinputSchema— JSON Schema des argumentsmanifest.safety—read,writeoucriticalmanifest.requiresApproval—truepour les mutations critiques
Seuls les outils des modules activés et des permissions effectives de l'utilisateur connecté apparaissent.
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.