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/list veröffentlicht aufrufbare Domänen-Fassaden. Eine Fassade führt eine governten API-Operation aus: eine Lesung bleibt eine Lesung, und eine Mutation folgt weiterhin Modulaktivierung, Berechtigungen und Freigaberichtlinie.

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. Die Liste ist paginiert (nextCursor). Jeder Eintrag ist eine aufrufbare Fassade, benannt numezis.<Domäne>.<Verb> oder numezis.<Domäne>.<Familie>.<Verb>. Die Liste enthält weder numezis.load_domains, noch einen zurückgezogenen Alias, noch einen generischen Dispatcher wie sales.query. Ein zweiter Aufruf liefert dieselben Namen.

Jedes Tool enthält:

name — die Fassade für tools/call
description — der Zustimmungssatz, bevor der Host den Benutzer fragt
inputSchema — JSON Schema; eine Familien-Fassade nimmt resource und args
annotations.title — lokalisierter Titel (Domäne · Familie · Verb)
annotations.readOnlyHint und annotations.destructiveHint — der Aufruf liest nur, oder er kann Datensätze ändern

Es erscheinen nur Fassaden für aktivierte Module und effektive Berechtigungen des verbundenen Benutzers. _meta.toolAdmission ist domain_facade_catalog.

Ausführung und Freigaben

Der Client sendet tools/call mit 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.