MCP-Tools
Öffentliche MCP-Tool-Oberfläche, OAuth und governte Ausführung für Agenten-Clients.
Überblick
Numezis stellt einen Remote-MCP-Server für Claude, ChatGPT und andere MCP-Clients bereit. Tools sind governten API-Operationen zugeordnet: Lesezugriffe sind im Tool-Manifest aufgeführt; Mutationen beachten Modulaktivierung, Berechtigungen und Freigaberichtlinie für kritische Tools.
Die End-User-Einrichtung (Connectoren, OAuth-Screenshots) liegt im MCP-Produktleitfaden. Diese Seite dokumentiert den Integrationsvertrag für Entwickler.
Endpunkt und Transport
| Element | Wert |
|---|---|
| URL | https://www.numezis.com/mcp |
| Transport | Streamable HTTP (JSON-RPC 2.0) |
| Auth | OAuth 2.0 mit Dynamic Client Registration |
Übergeben Sie den Portalkontext über die bei OAuth eingerichtete authentifizierte
Sitzung. Die Tool-Ausführung nutzt dieselben AccessMode-Regeln wie das
Unternehmensportal (/c).
Tool-Discovery
Rufen Sie nach der Autorisierung tools/list auf, um die Manifeste abzurufen.
Jedes Tool enthält:
name— stabiler Identifikator (entspricht den Tool-Oberflächen des Registry)description— benutzerseitige ZusammenfassunginputSchema— JSON Schema für Argumentemanifest.safety—read,writeodercriticalmanifest.requiresApproval—truefür kritische Mutationen
Es erscheinen nur Tools für aktivierte Module und effektive Berechtigungen des verbundenen Benutzers.
Ausführung und Freigaben
- Der Client sendet
tools/callmit Tool-Name und validierten Argumenten. - Der Server führt Richtlinienprüfungen aus (Modul, Berechtigung, Unternehmensstatus).
- Kritische Tools können ein Freigabe-Token zurückgeben, statt die Mutation anzuwenden.
- Der Benutzer bestätigt in der Numezis-Oberfläche; der Client wiederholt mit der Freigabereferenz.
Umgehen Sie Freigabeschritte in der Automatisierung nicht — nutzen Sie unkritische Lese-Tools zur Vorprüfung und blenden Sie dann die Freigabe-UX für den Benutzer ein.
Fehler
MCP-Fehler spiegeln die API-Semantik wider: Autorisierungsfehler, Validierungsfehler und Ratenbegrenzungen werden als strukturierte RPC-Fehler zurückgegeben. Protokollieren Sie Korrelations-IDs aus den Antworten, wenn Sie Support-Tickets eröffnen.