Fehlerbehebung beim MCP: 401, 403, fehlende Tools
Die meisten LanaChat-MCP-Probleme kommen vom token: falsch, abgelaufen oder es fehlt ein Kästchen. Suchen Sie den Fehler, den Sie sehen, in der Tabelle, dann die Details darunter.
| Was Sie sehen | Wahrscheinliche Ursache | Lösung |
|---|---|---|
401, "unauthorized" | token falsch, abgelaufen, widerrufen oder rotiert | erneut kopieren oder Rotate, Bearer prüfen |
403, "permission", "requires …" | dem token fehlt ein Kästchen | den token mit Edit bearbeiten, Kästchen anhaken, neu starten |
| "tool not found" | Kästchen aus, Name geraten, Server nicht hinzugefügt | Kästchen anhaken, /mcp prüfen |
409, "revision" oder "hash" | das Element hat sich zwischenzeitlich geändert | neu lesen und die Änderung wiederholen |
| "request too large" | mehr als 4 MiB in einer Anfrage | Dateien im Vault oder über Drive hochladen |
| keine Antwort | Netzwerk oder ein kurzer Neustart | in einigen Minuten erneut versuchen |
401: unauthorized #
Der Server hat den token nicht akzeptiert.
- Der token wurde mit einem fehlenden oder überzähligen Zeichen kopiert. Kopieren Sie ihn erneut, von dort, wo Sie ihn gespeichert haben.
- Der Header muss genau
Authorization: Bearerlauten, gefolgt vom token. Das WortBearerund das Leerzeichen sind erforderlich. - Der token wurde widerrufen oder rotiert (der alte funktioniert sofort nicht mehr). Prüfen Sie seinen Status unter Users › API & MCP.
- Der token ist abgelaufen: token gelten 365 Tage. Klicken Sie auf Rotate (oder Renew) und tragen Sie den neuen in Ihrem Assistenten ein.
- Sie haben einen Mitarbeiter-Schlüssel (Team Management) oder ein Console-Passwort verwendet. Das MCP akzeptiert nur einen token aus API & MCP.
403: forbidden, oder "permission" #
Der token ist gültig, aber es fehlt ein Kästchen für diese Aktion.
- Klicken Sie unter Users › API & MCP beim token auf Edit.
- Haken Sie das Kästchen an, das die Aktion braucht (siehe die Tabelle in Ihren MCP-token erstellen).
- Speichern Sie, beenden Sie dann Ihren Assistenten und starten Sie ihn neu.
Zwei Sonderfälle:
- Das Zuweisen einer Lizenz wird abgelehnt: Dem token fehlt Spend the balance on licences (es braucht auch Read sales, und nur der Workspace-Inhaber kann es anhaken), oder das Daily limit for licences ist erreicht (0 bedeutet gar keine Lizenz). Die Ablehnung nennt den Grund. Beheben Sie es mit Edit am token oder weisen Sie die Lizenz in der Console zu, unter Billing › Licences.
- Playground abgelehnt: Playground-Antworten brauchen ein positives Guthaben. Laden Sie unter Billing › Top up auf oder überspringen Sie den Test.
Ein Tool fehlt, oder "tool not found" #
- Ohne Configure agency AI erhält der Assistent nur die 132 Einrichtungs-, Fan- und Verkaufs-Tools: kein AI-Brain-, Playground- oder Veröffentlichungs-Tool. Haken Sie das Kästchen an und starten Sie neu.
- Ein Tool, das aufgelistet ist, aber ablehnt ("requires can_generate", "requires the owner's can_publish permission"), bedeutet ein fehlendes Kästchen am token. Haken Sie es mit Edit an und starten Sie neu.
- Der Assistent hat einen Namen geraten. Bitten Sie ihn: "Liste die Tools von lanachat auf." Die echten Namen stehen in der Tool-Referenz.
- Der Server ist nicht verbunden: Tippen Sie in Claude Code oder Codex
/mcp; prüfen Sie in einem Editor dessen MCP-Einstellungen.
409, "revision" oder "hash" geändert #
Jemand (oder der Assistent selbst) hat zwischenzeitlich dasselbe geändert. Bitten Sie den Assistenten, das Element neu zu lesen und die Änderung mit der frischen Revision zu wiederholen. Nichts ging verloren.
Anfrage zu groß #
Eine MCP-Anfrage ist auf 4 MiB begrenzt. Fotos und Videos laufen nicht über den Chat: Laden Sie sie im Vault hoch oder geben Sie den Link zu einem öffentlichen Google-Drive-Ordner an und lassen Sie den Assistenten ihn importieren.
Der Server antwortet nicht #
- Prüfen Sie Ihre Internetverbindung.
- Versuchen Sie es in einigen Minuten erneut: Ein kurzer Neustart des Servers kann vorkommen.
- Nach 15 Minuten immer noch nicht erreichbar: Schreiben Sie uns aus der Console (Support) mit der Uhrzeit und dem Tool-Namen. Senden Sie niemals den token.
Tipp Starten Sie den Assistenten nach jeder Änderung an einem token (Edit, Rotate) neu. Er liest die Tool-Liste nur beim Verbinden.
FAQ #
Warum erscheint ein Tool in der Liste, lehnt aber die Ausführung ab? #
Jedes Tool der Familie wird aufgelistet, und die Kästchen werden bei jedem Aufruf geprüft. Eine Ablehnung, die eine Berechtigung nennt, bedeutet, dass dem token dieses Kästchen fehlt.
Mein token hat gestern funktioniert. Warum heute 401? #
Er wurde rotiert, widerrufen oder ist abgelaufen (365 Tage). Prüfen Sie seinen Status unter Users › API & MCP und tragen Sie den neuen token in Ihrem Assistenten ein.
Muss ich den Assistenten nach dem Bearbeiten des token neu starten? #
Ja. Der Assistent liest die Tool-Liste nur beim Verbinden.