MCP: OneType in Claude Code, Cursor und anderen KI-Tools nutzen

OneType ist ein MCP-Server (Model Context Protocol, Streamable HTTP). Jeder MCP-Client kann ihn mit einem API-Schlüssel aufrufen: Claude Code, Cursor, Claude Desktop oder Ihre eigenen Agenten. Es gibt zwei Server:

Server	URL	Für	Tools
Workspace	`https://api.onetype.ai/v1/mcp`	Ihr Team und Ihre eigenen Automatisierungen: Agenten und Gespräche lesen, Wissen durchsuchen, einen Agenten befragen und Agenten bauen	Lese-Tools: `list_agents`, `get_agent`, `list_conversations`, `get_conversation`, `list_messages`, `search_knowledge`, `ask_agent`. Builder-Tools: siehe Builder-Tools
Die Docs eines Agenten (von OneType bereitgestellt)	`https://api.onetype.ai/v1/mcp/agents/YOUR_AGENT_ID`	Ihre Entwickler und Kunden: dieselben belegten Antworten wie in Ihrem Chat, direkt in ihrem Editor	`search_docs`, `ask_agent`

Status: Beide Server sind Verfügbar. Beide erfordern Premium: Im Free-Tarif werden MCP-Verbindungen abgelehnt mit 422 PLAN_LIMIT.

1. Schlüssel erstellen

Workspace-Server: Erstellen Sie unter Developer › API keys einen Restricted -Schlüssel (rk_live_…) und haken Sie nur die Berechtigungen an, die Sie brauchen:
- agents.read für list_agents und get_agent
- conversations.read für list_conversations, get_conversation und list_messages
- search.debug für search_knowledge
- conversations.write für ask_agent
- für ein Builder-Tool die Berechtigung der gleichen Aktion in der App (zum Beispiel agents.update für update_agent, knowledge.write für add_website)
Die Docs eines Agenten: Öffnen Sie auf der Seite MCP die Karte des Agenten und erstellen Sie seinen Schlüssel. Der Schlüssel enthält mcp.agent und ist auf diesen einen Agenten beschränkt, sodass er sonst nichts in Ihrem Workspace lesen kann. Sie können ihn bedenkenlos an die Entwickler weitergeben, die Ihre Docs nutzen.

Schlüssel werden nur einmal angezeigt. Das Widerrufen eines Schlüssels gilt ab der nächsten Anfrage.

2. Ihren Client verbinden

Claude Code

claude mcp add --transport http onetype https://api.onetype.ai/v1/mcp \
  --header "Authorization: Bearer rk_live_…"

Die Docs eines Agenten:

claude mcp add --transport http onetype-docs https://api.onetype.ai/v1/mcp/agents/YOUR_AGENT_ID \
  --header "Authorization: Bearer rk_live_…"

Cursor (.cursor/mcp.json), Claude Desktop und andere Clients, die JSON verwenden:

{
  "mcpServers": {
    "onetype-docs": {
      "url": "https://api.onetype.ai/v1/mcp/agents/YOUR_AGENT_ID",
      "headers": { "Authorization": "Bearer rk_live_…" }
    }
  }
}

Developer › MCP zeigt beide Snippets mit Ihrer eingetragenen URL.

Fragen Sie dann in Ihrem Editor: „Using onetype-docs, how do I verify a webhook signature?“ Die Antwort kommt mit ihren Quellen.

Was jedes Tool tut

Tool	Server	Liefert	Abrechnung
`list_agents`, `get_agent`	Workspace	Agenten, wie die REST API sie zurückgibt	kostenlos
`list_conversations`, `get_conversation`, `list_messages`	Workspace	Gespräche und ihre Nachrichten	kostenlos
`search_knowledge`	Workspace	Die am besten passenden Passagen aus dem Wissen eines Agenten, mit Quellen	kostenlos
`search_docs`	ein Agent	Die am besten passenden Passagen aus dem Wissen dieses Agenten, mit Quellen	kostenlos
`ask_agent`	beide	Eine vollständige Antwort des Agenten, mit Quellenangaben	eine Antwort, wie eine Chat-Antwort

Passagen, Nachrichten und Antworten sind für das aufrufende Modell als nicht vertrauenswürdiger Inhalt markiert, sodass Text in Ihren Dokumenten die KI des Clients nicht anweisen kann: Auf beiden Servern kommt jedes Feld, das Ihre Dokumente, Ihre Besucher oder ein Modell geschrieben haben (der header und der text einer Passage, der text einer Nachricht, der title einer Quelle, der name und die instructions eines Agenten), als Objekt { "untrusted_text": "…" }, nie als bloßer String. Lesen Sie den String aus untrusted_text. Jeder Aufruf wird in Ihrem Audit-Log aufgezeichnet (mcp.tool.called). Ein Tool-Ergebnis startet nie etwas auf dem Server.

Builder-Tools

Der Workspace-Server baut und betreibt außerdem Agenten. Jedes Tool funktioniert wie die gleiche Aktion in der App: mit denselben Berechtigungen, Tarifgrenzen und demselben Audit-Log.

Gruppe	Tools
Konto	`get_account`
Agenten	`list_models`, `create_agent`, `update_agent`, `publish_agent`, `take_agent_offline`, `resume_agent`, `delete_agent`
Wissen	`list_sources`, `get_source`, `add_website`, `add_pages`, `add_text`, `add_file`, `resync_source`, `remove_source`, `list_qna`, `add_qna`, `update_qna`, `delete_qna`
Chat und Website	`set_allowed_domains`, `get_look`, `update_look`, `apply_look`, `set_bubble`, `get_install_snippet`, `test_agent` (abgerechnet wie eine Chat-Antwort)
Vorlagen und Links	`list_templates`, `get_template`, `get_builder_prompt`, `get_checkout_link`, `get_connect_link`, `get_app_link`

Destruktive Aufrufe warten auf eine Person. Das Löschen eines Agenten, einer Quelle oder eines Frage-Antwort-Paars, das Veröffentlichen eines Agenten oder das Offlinenehmen sowie bei einem Live-Agenten das Veröffentlichen seines Erscheinungsbilds, das Ändern seiner erlaubten Domains oder das Ändern dessen, was Besuchern gesagt oder bei ihnen erhoben wird, beantworten wir mit needs_confirm und einem Link. Eine bei OneType angemeldete Person genehmigt es im Browser; derselbe Aufruf mit confirm , gesetzt auf die angegebene ID, geht dann einmal durch, innerhalb von 10 Minuten. Zahlung und das Anbinden weiterer Tools erfolgen ebenfalls im Browser, über die Links, die die Tools zurückgeben. Änderungen sind auf 60 pro Minute begrenzt, und create_agent auf 10 pro Stunde.

Für Entwickler anderer MCP-Clients

POST nimmt eine JSON-RPC-Nachricht entgegen. initialize antwortet mit einem Mcp-Session-Id -Header; senden Sie ihn bei späteren Anfragen mit.
Unterstützte Protokollversionen sind 2025-11-25 und 2025-06-18.
Methoden: ping, tools/list, tools/call. Benachrichtigungen antworten mit 202. DELETE beendet eine Sitzung, und GET antwortet mit 405. Sitzungen enden nach einem Tag ohne Nutzung.
tools/list bietet ein Tool nur an, wenn der Schlüssel dessen Berechtigung enthält.

Fehler

Antwort	Bedeutung	Lösung
`401`	Fehlender oder widerrufener Schlüssel	Prüfen Sie den `Authorization` -Header
`403 ORIGIN_NOT_ALLOWED`	Aus einer Browserseite aufgerufen	Rufen Sie ihn von einem Server oder einem Desktop-Client aus auf. Schlüssel gehören nie in einen Browser
`403 AGENT_SCOPED_KEY`	Der Schlüssel eines Agenten wurde auf dem Workspace-Server verwendet	Verwenden Sie die URL des Agenten oder einen Workspace-Schlüssel
`403 AGENT_OUT_OF_SCOPE`, `422 PLAN_LIMIT`	Der Schlüssel gehört nicht zu diesem Agenten, oder der Workspace ist im Free-Tarif	Verwenden Sie den Schlüssel dieses Agenten oder wechseln Sie zu Premium
`400 SESSION_REQUIRED`, `PROTOCOL_VERSION_MISMATCH` · `404 SESSION_NOT_FOUND`	Sitzungsverwaltung	Führen Sie `initialize`
JSON-RPC `-32601` / `-32602`	Unbekannte Methode oder unbekanntes Tool oder ungültige Argumente	Rufen Sie `tools/list` auf, um zu sehen, was dieser Schlüssel verwenden darf
Ein Ergebnis mit `isError: true`	Das Tool wurde abgelehnt (z. B. wegen einer fehlenden Berechtigung)	Sein Code und seine Meldung nennen den Grund

Menschen können sich auch per OAuth statt mit einem Schlüssel verbinden: claude.ai und Claude Desktop (ein benutzerdefinierter Connector) sowie ChatGPT melden sich über den Zustimmungsbildschirm von OneType an. Die Seite MCP in der App enthält die Schritte für jedes Tool.