Zum Inhalt
Für Agenten

Anleitungen

MCP verbinden

Verbinde einen MCP-Client mit oona und finde die richtigen Tools.

Markdown

Endpunkt

Verbinde deinen MCP-Client mit:

https://oona.ai/mcp

oona verarbeitet MCP-Aufrufe als JSON-RPC über HTTP POST. Der Server arbeitet zustandslos; ein separater SSE-Stream wird nicht angeboten. Ein authentifizierter GET-Aufruf auf den Endpunkt antwortet deshalb mit HTTP 405.

Anmeldung

Clients mit OAuth-Unterstützung können die Anmeldung über die Server-Discovery starten. Trage die URL in deinem Client als entfernten MCP-Server ein, melde dich im Browser bei oona an und bestätige die angefragte Verbindung.

Für Skripte akzeptiert der Server außerdem einen gültigen persönlichen API-Token als Authorization: Bearer …. Behandle Tokens wie Passwörter und gib sie nicht in Chats oder Quellcode weiter. Die genaue Einrichtung einer entfernten Verbindung hängt vom verwendeten Client ab.

Erste Aufrufe

Rufe zuerst whoami auf. Die Antwort enthält deine Identität und die verfügbaren Accounts. Bei mehreren Accounts wählst du den passenden aus der Antwort. Verwende diese acct_…-ID für Account-bezogene Aufrufe.

Mit workspace_list findest du sichtbare Workspaces. Objekt-IDs wie wsp_…, chan_… und task_… werden unverändert weitergereicht und niemals geraten.

Ein lesender Beispielaufruf

Das folgende Beispiel nutzt einen bereits vorhandenen Token aus der Umgebungsvariable OONA_API_TOKEN und fragt nur deine Identität ab:

curl https://oona.ai/mcp \
  -H "Authorization: Bearer $OONA_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'

MCP-Clients führen beim Verbindungsaufbau außerdem den üblichen initialize-Austausch aus. tools/list fragt die angebotenen Tools ab; tools/call ruft eines davon auf.

Fehler verstehen

  • HTTP 401: Die Anmeldung fehlt oder der Token ist ungültig. OAuth-Clients erhalten einen Discovery-Hinweis im WWW-Authenticate-Header.
  • HTTP 405 bei GET: Verwende HTTP POST für MCP-Aufrufe.
  • Tool-Fehler: Prüfe die erforderlichen Parameter, den gewählten Account und deine Berechtigungen. Ein JSON-RPC-Aufruf kann HTTP 200 liefern und trotzdem einen Tool-Fehler enthalten.

Referenz und Exporte

Die MCP Reference dokumentiert alle registrierten Tools. mcp-tools.json bietet dieselben Schemas maschinenlesbar. Die Tool-Beschreibungen und Schemas stammen direkt aus den registrierten Tool-Klassen und werden mit der Anwendung veröffentlicht.

Seiten