# MCP-Server anbinden

miovea stellt einen MCP-Server bereit, über den ein Agent Vorgänge lesen und Fragebögen ausfüllen kann.

## Verbindung

- Server-URL: `https://app.miovea.com/api/mcp`
- Transport: Streamable HTTP (SSE ist deaktiviert)
- Anmeldung: OAuth 2.1 mit Dynamic Client Registration. Beim ersten Verbinden öffnet sich ein Browser-Login mit dem miovea-Konto des Nutzers. API-Keys gibt es nicht.

Beispiel für Claude Code:

```
claude mcp add --transport http miovea https://app.miovea.com/api/mcp
```

## Fehlercodes

| Code | Bedeutung | Was tun |
| --- | --- | --- |
| `UNAUTHORIZED` | Verbindung nicht (mehr) angemeldet | OAuth-Verbindung neu aufbauen |
| `NOT_FOUND` | Ressource existiert nicht oder gehört zu einem anderen Konto | ID prüfen, Liste erneut abrufen |
| `VALIDATION_FAILED` | Wert passt nicht zum Feldtyp oder zu den erlaubten Optionen | Wert korrigieren |
| `FORBIDDEN` | Aktion für dieses Konto nicht erlaubt | Nutzer informieren, nicht wiederholen |