Fehlerbehebung

Häufige Probleme beim Verbinden oder Aufrufen von Tools und ihre Ursachen.

„Authentication required“ beim Verbinden

Der Server verlangt bei jeder Anfrage ein Bearer-Zugriffstoken — ein einfacher GET auf die Server-URL (z. B. im Browser geöffnet) liefert immer diese Meldung; es ist kein Fehler in Ihrer Einrichtung.

{
  "error": "Authentication required. POST with Authorization: Bearer <token>."
}

Zuvor funktionierende Anfragen schlagen plötzlich fehl

Zugriffstoken laufen nach 1 Stunde ab. Ein funktionierender Client erneuert automatisch mit seinem Refresh-Token — falls Ihrer das nicht tut, verbinden Sie ihn erneut.

Ein zuvor funktionierender Client funktioniert überhaupt nicht mehr

Jemand in Ihrer Agentur hat möglicherweise die Verbindung dieses Clients unter Einstellungen → Entwickler → MCP-Verbindungen widerrufen. Verbinden Sie ihn erneut für eine neue Berechtigung.

„Tool not found“ oder ein ähnlich benanntes Tool fehlt

Tool-Namen sind exakt und groß-/kleinschreibungsabhängig — prüfen Sie diese Referenz auf den genauen Namen. Im „Compact“- oder „Code“-Modus sind nur die Discovery-Tools (search_os_tools, call_os_tool, …) direkt aufgeführt; nutzen Sie diese, um die übrigen Tools nach Namen zu finden und aufzurufen.

Ein Tool-Aufruf wird wegen fehlendem Zugriff abgelehnt

Die Verbindung hat nur mcp:read (nur lesend) — verbinden Sie erneut und genehmigen Sie Schreibzugriff, falls das aufgerufene Tool ihn benötigt.

Ratenbegrenzung

Derzeit gibt es keine spezifische Ratenbegrenzung für MCP-Tool-Aufrufe — anders als das planbasierte Limit der REST-API pro Agentur.