MCP-Fehlerbehebung
Finden Sie den nächsten Schritt bei einem Verbindungsproblem.
Ein gehosteter Client lässt sich nicht verbinden
Prüfen Sie, ob die konfigurierte URL https://mcp.altifigence.com/cloud-mcp lautet und der Client Streamable HTTP mit OAuth unterstützt. Folgen Sie den Verbindungshinweisen und dem aktuellen Qualifikationsstatus. Die Statusseite des Servers und OAuth-Metadaten beweisen nicht, dass ein bestimmter Client seine Autorisierung abgeschlossen hat.
Ergebnis | Nächster Schritt |
|---|---|
HTTP 401 | Verbinden Sie Altifigence Cloud erneut, wenn die Autorisierung abgelaufen oder widerrufen ist; durchlaufen Sie den Client-Autorisierungsablauf erneut |
HTTP 403 | Prüfen Sie eingewilligte Organisation, aktuellen Projektzugriff und Werkzeugrichtlinie; verbinden Sie sich mit der erforderlichen Berechtigung erneut, nachdem die Organisation das Werkzeug aktiviert hat |
Leere oder fehlende Werkzeuge | Prüfen Sie veröffentlichten Katalog, ausdrückliche Organisationsgenehmigung und neue Einwilligung je Werkzeug; das Aktualisieren eines alten Tokens kann keine Werkzeuge ergänzen |
Arbeitsbereichslesen nicht verfügbar | Prüfen Sie Arbeitsbereichsstatus und Zugriff in Cloud; versuchen Sie es nach Bereitschaft erneut |
Ausführungswerkzeuge fehlen | Fordern Sie eine neue |
Schreibwerkzeuge fehlen | Fordern Sie eine neue |
Konflikt bei Dateiänderung | Lesen Sie Manifest und Datei erneut, prüfen Sie gleichzeitige Änderungen und übermitteln Sie dann die beabsichtigte Änderung mit aktuellen Revisionen |
Projekterstellung oder Git-Änderung nicht bestätigt | Prüfen Sie vor Wiederholung Projektliste, Repository oder entfernten Zustand; wiederholtes Erstellen, Committen oder Pushen kann unbeabsichtigte Auswirkungen haben |
Projektlöschung akzeptiert | Verfolgen Sie Projekt-/Arbeitsbereichszustand bis zum Bereinigungsabschluss; akzeptiert bedeutet nicht abgeschlossen |
Git-Provider-Transfer verweigert | Prüfen Sie ausgewähltes Repository, Branch und aktuelle Providerverbindung; das Werkzeug kann Providerberechtigungen nicht umgehen |
Laufzeitoperation nicht bestätigt | Lesen Sie Laufzeitstatus und behalten Sie die Operations-ID; resume verwendet die Operations-ID der gestoppten Laufzeit |
Projektgeneration, Dateiversion oder Richtlinie geändert | Holen Sie eine neue Schätzung und prüfen Sie deren ausgewähltes Angebot und Nutzungsrichtlinie |
Übermittlung nicht bestätigt | Prüfen Sie dieselbe Job-ID; wiederholen Sie nur mit identischen Argumenten und derselben ID |
Ergebnis nicht bereit | Lesen Sie Jobstatus vor erneuter Ergebnisanforderung |
Unzureichende Credits | Prüfen Sie den Abrechnungszustand der Organisation in Cloud |
HTTP 413 | Reduzieren Sie die Anfrage auf die Argumente im erkannten Werkzeugschema |
HTTP 501 von einem lokalen Werkzeug | Die installierte Laufzeit implementiert diese Operation nicht; Erkennung allein belegt keine Unterstützung |
HTTP 503 | Warten Sie auf Wiederherstellung des Dienstes; behalten Sie den konfigurierten Endpunkt |
Eine Leseanfrage startet oder startet ein Projekt nicht neu. Unbekannte oder nicht autorisierte Werkzeugnamen aktivieren weder Bearbeitung noch Ausführung. Korrigieren Sie vor Wiederholung die Verbindungs- oder Zugriffsbedingung; geben Sie keine alternativen Zugangsdaten in Argumenten an.
Zu viele Anfragen
Enthält eine Antwort HTTP 429, warten Sie vor einem weiteren Versuch die in Retry-After angegebene Zeit. Vermeiden Sie wiederholte Registrierungs- oder Anmeldeversuche.
Support kontaktieren
Kontaktieren Sie Altifigence Support mit Clientname, Version, Problemzeit und Fehlermeldung nach Entfernung sensibler Informationen. Fügen Sie keine Zugangsdaten, Cookies oder Projektinhalte bei.
Wiederherstellen, ohne Arbeit zu duplizieren
Fehlerstelle | Vor Wiederholung prüfen |
|---|---|
Identität oder Erkennung | Clientversion, Endpunkt, Anmeldung/Sitzung und Liste eingewilligter Werkzeuge. |
Fortsetzung eines Dateilesevorgangs | Datei- und Manifestversionen; bei geändertem Snapshot neu beginnen. |
Dateischreiben, Commit oder Push | Aktuelle gespeicherte Datei, Repository und entfernter Zustand. |
Jobübermittlung | Bestehende Job-ID und Status; ursprüngliche Identität behalten. |
Terminaleingabe oder KI-Anfrage | Aktuelle Sitzung/Ausgabe; Eingabe nicht automatisch wiederholen. |
Dokumentieren Sie die kleinste reproduzierbare Anfrage mit Platzhaltern für Projektdaten. Erhalten Sie Fehlercode, HTTP-Status, angezeigte Anfragekennung und Zeitstempel. Entfernen Sie Tokens und Quellinhalte vor dem Teilen einer Diagnose.