Fehlerbehebung
Identifizieren Sie, ob das Problem beim Verbindungszugriff, bei Tool-Berechtigungen oder beim Upstream-Dienst liegt.
Automatisch aus dem Englischen übersetzt. Englischen Originaltext lesen
2 Minuten Lesezeit · Kundenleitfaden
Beginnen Sie mit der Identifizierung der fehlerhaften Phase: Hinzufügen der Verbindung, Erkennen von Tools, Ausführen eines Tools oder Überprüfen eines Schreibvorgangs. Erfassen Sie die Zeit und eine kurze Beschreibung, bevor Sie Einstellungen ändern.
Verbindung kann nicht erreicht werden#
Überprüfen Sie den genau zugewiesenen Endpunkt und ob der AI-Client seine Transport- und Authentifizierungsmethode unterstützt. Eine Plattform-Home-Adresse ist kein MCP-Endpunkt. Verwenden Sie die normale sichere Verbindung. Umgehen Sie keine Zertifikatwarnung.
Wenn dieselbe zugewiesene Verbindung zuvor funktioniert hat, melden Sie, wann sie zuletzt erfolgreich war und was sich im Client geändert hat. Vermeiden Sie es, funktionierende Verbindungsdetails zu löschen, bevor ein Ersatz überprüft wurde.
Fehlerreferenz#
| Symptom | Was zu überprüfen ist |
|---|---|
401 bei Verbindung oder Entdeckung | Fehlender, falscher, abgelaufener oder widerrufener Ausweis; Falscher Header oder Endpunkt. |
403 für eine Operation | Anmeldeinformationsbereich, Tool-Berechtigung oder Upstream-Service-Rolle; Identifizieren Sie, welche Schicht es zurückgegeben hat. |
429 | Antragszulage überschritten; Beachten Sie die Wiederholungsverzögerung und reduzieren Sie die Anforderungshäufigkeit. |
404 | Der Endpunkt oder der referenzierte Datensatz ist möglicherweise falsch oder nicht verfügbar. Überprüfen Sie den genauen Pfad und Kontext. |
5xx oder nicht verfügbar | Problem mit der Plattform oder dem vorgelagerten Dienst; Erfassungszeit und Anforderungsphase. |
| Ungültige Argumente | Erforderliches Feld, Eingabetyp, nicht unterstütztes zusätzliches Feld oder eine nicht übereinstimmende Kennung. |
| Verbunden, aber kein erwartetes Werkzeug | Zugewiesener Bereich, inaktive oder nicht überprüfte Hinzufügung oder Erkennung veralteter Clients. |
| Tools werden angezeigt, aber Anrufe schlagen fehl | Vorgelagerte Autorisierung, Kontoberechtigung oder vorgangsspezifische Eingabe. |
Dies sind diagnostische Ansatzpunkte. Die tatsächliche Quelle eines HTTP-Fehlers ist wichtig; Der Berechtigungsfehler eines Dienstes wird nicht durch Schwächung der MCP-Authentifizierung behoben.
Ein sicherer Diagnoseablauf#
Bestätigen Sie den Endpunkt, aktualisieren Sie die Toolliste, vergleichen Sie sie mit der Übergabe und führen Sie den vereinbarten schreibgeschützten Test durch. Wenn dies fehlschlägt, notieren Sie den Namen des Tools und den korrigierten Fehler. Halten Sie an, bevor Sie eine Schreibaktion wiederholen, deren Ergebnis ungewiss ist.
Was soll ich unterstützen?#
Benutzen Sie die Support-Checkliste. Fügen Sie einen Screenshot mit unkenntlich gemachten vertraulichen Angaben oder den relevanten Fehlertext bei. Verwenden Sie keinen vollständigen Gesprächsexport und keine Konfiguration, die einen Schlüssel enthält.