MCP

Die Service API betreibt einen MCP-Server (Transport „Streamable HTTP“, zustandslos – keine Sitzungsbindung nötig) unter:

https://service.testing.nairon.cloud/mcp

Die Authentifizierung funktioniert wie bei jeder anderen Anfrage an die Service API: Authorization: Bearer nrn_sk_....

Werkzeuge

Der Server stellt heute 41 Werkzeuge bereit, mit der nächsten Version des Dienstes 42 (neu: get_context). Jedes Werkzeug entspricht einem Vorgang unter Ressourcen – dort finden Sie Anfrage- und Antwortformate und das genaue Verhalten. Die Tabelle bleibt in der Originalsprache der Schnittstelle.

Tool	Entspricht
`get_organization`	`GET /v1/organization`
`get_context` (next service release)	`GET /v1/me` — the calling key’s organization id, project id, scope, and name
`get_usage`	`GET /v1/organization/usage`, `GET /v1/projects/{projectId}/usage`, `GET /v1/orgs/{orgId}/usage` — not available yet, returns an error with code `usage_unavailable`
`get_project`	`GET /v1/projects/{projectId}`
`get_agent`	`GET /v1/projects/{projectId}/agent`
`update_agent`	`PATCH /v1/projects/{projectId}/agent`
`get_simple_agent`	`GET /v1/projects/{projectId}/agent/simple`
`update_simple_agent`	`PUT /v1/projects/{projectId}/agent/simple`
`list_skill_catalogue`	`GET /v1/catalogue/skills`
`list_conversations`	`GET /v1/projects/{projectId}/conversations`
`create_conversation`	`POST /v1/projects/{projectId}/conversations`
`get_conversation`	`GET /v1/conversations/{id}`
`update_conversation`	`PATCH /v1/conversations/{id}`
`delete_conversation`	`DELETE /v1/conversations/{id}`
`get_conversation_design`	`GET /v1/conversations/{id}/design` (active version only)
`save_conversation_design`	`PUT /v1/conversations/{id}/design`
`list_conversation_versions`	`GET /v1/conversations/{id}/versions`
`activate_conversation_version`	`POST /v1/conversations/{id}/versions/{n}/activate`
`list_knowledge`	`GET /v1/projects/{projectId}/knowledge`
`create_knowledge`	`POST /v1/projects/{projectId}/knowledge`
`get_knowledge`	`GET /v1/knowledge/{kbId}`
`delete_knowledge`	`DELETE /v1/knowledge/{kbId}`
`create_knowledge_source`	`POST /v1/knowledge/{kbId}/sources`
`delete_knowledge_source`	`DELETE /v1/knowledge/{kbId}/sources/{id}`
`list_integrations`	`GET /v1/projects/{projectId}/integrations`
`list_numbers`	`GET /v1/projects/{projectId}/numbers`
`update_number`	`PATCH /v1/numbers/{id}`
`list_web_agents`	`GET /v1/projects/{projectId}/web-sessions/agents`
`create_web_agent`	`POST /v1/projects/{projectId}/web-sessions/agents`
`update_web_agent`	`PATCH /v1/projects/{projectId}/web-sessions/agents/{id}`
`delete_web_agent`	`DELETE /v1/projects/{projectId}/web-sessions/agents/{id}`
`create_web_session`	`POST /v1/web-sessions`
`list_keys`	`GET /v1/projects/{projectId}/keys`
`create_key`	`POST /v1/projects/{projectId}/keys`
`revoke_key`	`POST /v1/keys/{id}/revoke`
`query_knowledge_base`	Queries a knowledge base’s contents
`list_flows`	`GET /v1/projects/{projectId}/flows`
`get_flow`	`GET /v1/flows/{flowId}`
`create_flow`	`POST /v1/projects/{projectId}/flows`
`update_flow`	`PATCH /v1/flows/{flowId}` (name, description, agent profile)
`save_flow_version`	`POST /v1/flows/{flowId}/versions` (saves and activates a new version)
`activate_flow_version`	`POST /v1/flow-versions/{versionId}/activate`

Standardprojekt (nächste Version des Dienstes). Jedes Werkzeug, das eine projectId erwartet, akzeptiert sie dann als optional: Lassen Sie sie weg, verwendet das Werkzeug das Projekt Ihres Schlüssels (bei get_usage, wenn weder projectId noch organizationId angegeben ist). Eine projectId eines anderen Projekts wird weiterhin mit not_found abgelehnt. REST-Pfade enthalten {projectId} weiterhin im Pfad – lesen Sie den Wert über GET /v1/me aus.

Die sechs Werkzeuge *_flow* arbeiten mit den Gesprächsabläufen eines Projekts im eigenen Format des Editors. Für neue Integrationen sollten Sie die Conversation-Werkzeuge und die portable Gesprächsgestaltung bevorzugen.

get_conversation_design liest nur die aktive Version – list_conversation_versions liefert den Versionsverlauf; die Gestaltung einer bestimmten früheren Version erhalten Sie nur über REST (GET /v1/conversations/{id}/versions/{n}/design).

Verbinden

Jeder MCP-Client, der entfernte Server über „Streamable HTTP“ unterstützt, kann sich direkt verbinden. Zum Beispiel mit dem MCP Inspector:

npx @modelcontextprotocol/inspector
# danach mit https://service.testing.nairon.cloud/mcp und einem Header „Authorization: Bearer“ verbinden

Alternativ richten Sie ihn in jedem Client, der eigene Server unterstützt, als entfernten MCP-Server ein und geben die Adresse und Ihren geheimen API-Schlüssel als Bearer-Token an.

Siehe auch

Ressourcen – die Vorgänge, die jedes Werkzeug abbildet.
Fehler – über MCP gelten dieselben Fehlercodes wie über REST; ein fehlgeschlagener Werkzeugaufruf liefert ein Fehlerergebnis mit dem Text <message> (code: <code>, requestId: <id>).