# Fehlerbehebung beim MCP: 401, 403, fehlende Tools

_Claude / Codex verbinden · 3 Min. Lesezeit · Aktualisiert 2026-11-08 · https://lanachat.ai/guides/de/ai-troubleshooting/_

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: Bearer ` lauten, gefolgt vom token. Das Wort `Bearer` und 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.

1. Klicken Sie unter **Users › API & MCP** beim token auf **Edit**.
2. Haken Sie das Kästchen an, das die Aktion braucht (siehe die Tabelle in [Ihren MCP-token erstellen](https://lanachat.ai/guides/de/ai-create-mcp-token/)).
3. 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](https://lanachat.ai/guides/mcp-tool-reference/).
- 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.

> Tip: 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.

## Verwandte Artikel

- [Ihren token sicher aufbewahren](https://lanachat.ai/guides/de/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: einen KI-Assistenten verbinden](https://lanachat.ai/guides/de/api-mcp/)