# MCP verbinden

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

## Endpunkt

Verbinde deinen MCP-Client mit:

```text
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](/docs/mcp-reference/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](/docs/mcp-reference/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:

```sh
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](/docs/mcp-reference) dokumentiert alle registrierten Tools. [mcp-tools.json](/docs/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.