Fehlerbehebung
Schnellprüfung
Abschnitt betitelt „Schnellprüfung“- Öffnen Sie Mein MCP und prüfen Sie, ob der erwartete Service sichtbar ist.
- Rufen Sie im KI-Client
gateway_accessauf. - Prüfen Sie unter Dienst-Verbindungen, ob eine persönliche Anmeldung fehlt.
- Mandanten-Admins prüfen Gruppen, direkte Freigaben, Service-Zuweisung und Status.
- Verbinden Sie den KI-Client neu, wenn er eine alte Tool-Liste zwischenspeichert.
Häufige Statuscodes
Abschnitt betitelt „Häufige Statuscodes“| Code | Bedeutung | Nächster Schritt |
|---|---|---|
401 Unauthorized |
Anmeldung fehlt, ist abgelaufen oder der Schlüssel ist ungültig | Connector trennen und erneut per OAuth verbinden; API-Schlüssel prüfen |
403 Forbidden |
Account ist bekannt, besitzt aber nicht die benötigte Freigabe | Benutzer-, Gruppen- und Tool-Rechte prüfen lassen |
404 Not found |
Route oder Artefakt existiert nicht oder ist nicht sichtbar | URL, Mandant und Eigentum prüfen |
409 Conflict |
gespeicherter Stand ist neuer oder eine erforderliche Verknüpfung fehlt | Seite neu laden und Änderung erneut anwenden |
413 Payload too large |
Datei oder gespeicherter Inhalt überschreitet ein technisches Limit | Inhalt verkleinern oder aufteilen |
428 Precondition Required |
erforderliche persönliche oder zentrale Zugangsdaten fehlen | Dienst-Verbindungen oder Mandanten-Admin öffnen |
429 Too Many Requests |
Rate-, Kapazitäts- oder Diagrammlimit wurde erreicht | später erneut versuchen oder Tariflimit prüfen |
502 Bad Gateway |
der angebundene Service antwortet fehlerhaft | Service-Status prüfen und später wiederholen |
503 Service Unavailable |
Service, Billing-Snapshot oder Abhängigkeit ist vorübergehend nicht bereit | Status prüfen, synchronisieren und später wiederholen |
Hilfreiche Diagnoseangaben
Abschnitt betitelt „Hilfreiche Diagnoseangaben“- Zeitpunkt mit Zeitzone
- betroffener Mandant und Service, ohne Secret
- ausgeführte Aktion oder Tool-Name
- HTTP-Status und kurze Fehlermeldung
- ob der Fehler im Portal, im KI-Client oder beim Drittanbieter erscheint
- ob andere freigegebene Services funktionieren
OAuth-Callback oder CSRF-Fehler
Abschnitt betitelt „OAuth-Callback oder CSRF-Fehler“Starten Sie OAuth immer aus dem Portal und verwenden Sie dasselbe Browserfenster bis zum Abschluss. Alte Callback-Links sind nicht wiederverwendbar. Löschen Sie bei wiederholtem Invalid CSRF token nur die Cookies der betroffenen MCP-Domain, melden Sie sich neu an und starten Sie den Flow erneut.