# Fehlerbehebung

Was Sie tun können, wenn sich ein KI-Client nicht mit plnnrly verbindet, sich nicht anmelden kann oder eine Anfrage abgelehnt wird.

Suchen Sie die Meldung oder das Verhalten, das Sie sehen, und folgen Sie der Lösung. Meldungen von plnnrly stehen hier wörtlich, auf Englisch. Einige davon können in einer anderen Sprache erscheinen, etwa auf Niederländisch oder in der Sprache, in der Sie plnnrly nutzen; bei diesen steht die deutsche Fassung dabei.

## Verbinden und anmelden

| Was Sie sehen                                                                                                                       | Warum                                                                                                                                      | Was Sie tun können                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| „The MCP server is not enabled for this organisation.“ (`404`)                                                                      | MCP ist für Ihre Organisation aus. Neue Organisationen starten mit ausgeschaltetem MCP. Wird die REST-API ausgeschaltet, ist auch MCP aus. | Bitten Sie einen Administrator, es einzuschalten; siehe [Für Administratoren](https://developers.plnnrly.com/de/docs/administration/). |
| „OAuth is not available for this organisation.“ (`404`) bei der Anmeldung                                                           | Die REST-API ist aus, deshalb kann sich keine App anmelden.                                                                                | Fragen Sie einen Administrator; siehe [Für Administratoren](https://developers.plnnrly.com/de/docs/administration/).                   |
| Der Client findet den Server nicht, oder die Anmeldeseite zeigt `404`                                                               | Die Server-URL ist falsch, oder MCP ist aus.                                                                                               | Kopieren Sie die Server-URL aus dem **KI**-Bereich (das Funkel-Symbol in der oberen Leiste). Fehlt der Bereich, ist MCP aus.           |
| Der Client meldet `invalid_redirect_uri`                                                                                            | Der Client kann sich noch nicht bei plnnrly anmelden.                                                                                      | Siehe [Andere Clients](https://developers.plnnrly.com/de/docs/mcp/install/other-clients/).                                             |
| „Your role does not allow connecting apps to the REST API.“ oder „Ihre Rolle erlaubt es nicht, Apps mit der REST-API zu verbinden.“ | Die App hat auch Zugriff auf die REST-API angefordert, und Ihrer Rolle fehlt **API-Tokens verwalten**.                                     | Bitten Sie einen Administrator um das Recht, oder nutzen Sie einen Client, der nur MCP anfordert.                                      |
| Die Anmeldung wird abgelehnt (`403`), während Sie in einer Support-Sitzung arbeiten                                                 | In Support-Sitzungen lassen sich keine Apps verbinden.                                                                                     | Melden Sie sich mit Ihrem eigenen Konto an.                                                                                            |
| „This organization's access has been suspended.“ oder „Der Zugang dieser Organisation wurde gesperrt.“ (`503`)                      | Ihre Organisation ist gesperrt.                                                                                                            | Wenden Sie sich an Ihren Administrator.                                                                                                |
| „This organization is currently unavailable.“ oder „Diese Organisation ist derzeit nicht verfügbar.“ (`503`)                        | Ihre Organisation wird gerade eingerichtet oder ist archiviert.                                                                            | Wenden Sie sich an Ihren Administrator oder an den [plnnrly-Support](https://www.plnnrly.com/de/support).                              |
| Der Client bittet Sie, sich erneut anzumelden                                                                                       | Er wurde 30 Tage lang nicht benutzt, oder jemand hat ihn getrennt.                                                                         | Melden Sie sich erneut an.                                                                                                             |

## Die Tools nutzen

| Was Sie sehen                                                                                                          | Warum                                                                                                               | Was Sie tun können                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Too Many Attempts.“ (`429`)                                                                                           | Sie haben mehr als 60 MCP-Anfragen in einer Minute gesendet, gezählt über alle KI-Clients, die Sie verbunden haben. | Warten Sie eine Minute, und fragen Sie dann weniger auf einmal ab.                                                                                                                      |
| Die Antwort enthält `meta.mcp_truncated`                                                                               | Die Antwort lag über dem Limit von etwa 30.000 Zeichen und wurde gekürzt.                                           | Bitten Sie um weniger Zeilen, stellen Sie eine engere Frage, oder fragen Sie nach einem einzelnen Feld. Siehe [Antworten](https://developers.plnnrly.com/de/docs/mcp/tools/#responses). |
| Ein Löschen wird mit `forbidden-by-policy` und „This organisation does not allow AI clients to delete data.“ abgelehnt | **Destruktive Aktionen erlauben** ist für Ihre Organisation aus.                                                    | Siehe [Rechte und Sicherheit](https://developers.plnnrly.com/de/docs/mcp/permissions-and-safety/). Nur ein Administrator kann es einschalten.                                           |
| Eine Änderung wird mit `forbidden-by-policy` und einer anderen Meldung abgelehnt                                       | Ihre Rolle oder der Datensatz selbst erlaubt diese Änderung nicht. Die Meldung sagt, warum.                         | Prüfen Sie in plnnrly, ob Sie die Änderung selbst vornehmen können.                                                                                                                     |
| Ein Löschen oder Überschreiben wird mit `validation-failed` für `confirm` abgelehnt                                    | Sie haben es noch nicht bestätigt.                                                                                  | Sagen Sie dem Assistenten, dass Sie einverstanden sind, damit er den Aufruf mit Ihrer Bestätigung wiederholt.                                                                           |
| Ein Upload wird mit `endpoint-not-found` abgelehnt                                                                     | Über MCP lassen sich keine Dateien hochladen.                                                                       | Nutzen Sie die REST-API mit einem API-Token; siehe [Dateien hoch- und herunterladen (Englisch)](https://developers.plnnrly.com/en/docs/api/v2/guides/uploads/).                         |
| Für einen Datensatz, den es sicher gibt, kommt `404` zurück                                                            | Sie dürfen ihn nicht sehen, oder er gehört zu einem Bereich, den Ihre Organisation nicht nutzt.                     | Prüfen Sie in plnnrly, ob Sie ihn öffnen können. Der Assistent sieht genau das, was Sie sehen.                                                                                          |
| Die App steht noch unter **Verbundene Apps**, obwohl Sie sie im Client entfernt haben                                  | Die Anmeldung der App bleibt bis zu 30 Tage nach ihrer letzten Nutzung gültig.                                      | Klicken Sie im **KI**-Bereich auf **Trennen**.                                                                                                                                          |

## Die Tools erscheinen nicht

Prüfen Sie zuerst den Client selbst:

- **claude.ai und Claude Desktop:** Klicken Sie in einem Chat auf **+**, wählen Sie **Connectors** und prüfen Sie, ob plnnrly eingeschaltet ist; siehe [claude.ai](https://developers.plnnrly.com/de/docs/mcp/install/claude-ai/).
- **Claude Code:** Führen Sie `claude mcp list` aus oder in einer Sitzung `/mcp`; siehe [Claude Code](https://developers.plnnrly.com/de/docs/mcp/install/claude-code/).
- **ChatGPT:** Prüfen Sie, ob das Plugin installiert ist, tippen Sie dann `@` und wählen Sie plnnrly; siehe [ChatGPT](https://developers.plnnrly.com/de/docs/mcp/install/chatgpt/).
- **Cursor:** Öffnen Sie den Bereich **Output** und wählen Sie **MCP Logs**; siehe [Cursor](https://developers.plnnrly.com/de/docs/mcp/install/cursor/).
- **Gemini CLI:** Führen Sie in einer Sitzung `/mcp` aus; siehe [Gemini CLI](https://developers.plnnrly.com/de/docs/mcp/install/gemini/).

## Weiterhin Probleme?

Wenden Sie sich an den [plnnrly-Support](https://www.plnnrly.com/de/support). Hat plnnrly mit einem Fehler geantwortet, geben Sie dessen `request_id` an.
