> ## Documentation Index
> Fetch the complete documentation index at: https://formpaste.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehebung für den MCP-Server

> Behebe Verbindungsfehler, Auth-Fehler, Scope-Verweigerungen und fehlende Tools beim Verbinden eines Agenten mit Formpaste.

Die meisten MCP-Probleme fallen in wenige Kategorien. Ordne das Symptom der Ursache unten zu.

| Symptom                                                | Wahrscheinliche Ursache                                             | Lösung                                                                                                                                                                     |
| ------------------------------------------------------ | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Client kann nicht verbinden / Verbindung abgelehnt     | Falscher Endpoint-Host                                              | Der Endpoint ist `https://api.formpaste.com/mcp` (beachte `api.`, nicht `app.`).                                                                                           |
| Tool-Aufruf gibt `unauthorized` zurück                 | Fehlendes, falsch eingegebenes oder widerrufenes Token              | Erstelle unter **Settings → API & MCP** ein neues Token und aktualisiere deine Client-Konfiguration. Das Token wird nur einmal angezeigt.                                  |
| Ein Lese-Tool gibt `forbidden` zurück                  | Ein Setup-beschränktes Token hat `list_submissions` aufgerufen      | Setup-Tokens können keine Einsendungen lesen. Verwende ein Token mit vollem Zugriff oder erstelle eines. Siehe [API-Tokens](/docs/agents/api-tokens).                           |
| Tool-Aufruf gibt `not_found` zurück                    | Falsche `formId`, oder ein Formular, das einem anderen Konto gehört | Rufe [`list_forms`](/docs/agents/list-forms) auf, um gültige IDs für das Konto des Tokens zu erhalten.                                                                          |
| `formpaste` wird nach der Installation nicht angezeigt | Client nicht neu gestartet, oder veralteter `mcp-remote`            | Starte den Client neu. Falls das Problem bestehen bleibt, leere den `mcp-remote`-Cache (`npx clear-npx-cache`) und verbinde dich erneut.                                   |
| Nur drei Tools werden angezeigt                        | Eine alte, zwischengespeicherte Verbindung                          | Verbinde dich erneut - der aktuelle Server stellt sechs Tools bereit (`create_form`, `get_snippet`, `list_forms`, `get_form`, `send_test_submission`, `list_submissions`). |

## Die Fehlerstruktur

Jeder Tool-Fehler ist ein JSON-Objekt, auf das ein Agent verzweigen kann:

```json theme={null}
{ "error": { "code": "not_found", "message": "No form with that id on your account.", "hint": "Call list_forms to see your form ids." } }
```

Der `code` ist einer aus einer festen Menge: `unauthorized`, `forbidden`, `not_found`, `invalid_input`,
`invalid_framework`, `too_many_fields`, `field_too_large`, `internal_error`.

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/docs/agents/install">
    Installationsbefehle je Client.
  </Card>

  <Card title="API-Tokens" icon="key" href="/docs/agents/api-tokens">
    Scopes für vollen Zugriff vs. Setup-Tokens.
  </Card>
</CardGroup>