Fehler
Häufige Listano Control MCP-Fehler und Hinweise zur Fehlerbehebung.
Listano Control MCP-Tools können Fehler aus Authentifizierung, Berechtigungen, Validierung, Veröffentlichungsbereitschaftsprüfungen oder Backend-Fetch-Fehlern zurückgeben.
Das sicherste Wiederherstellungsmuster ist:
- den Fehler prüfen
whoamiaufrufen, wenn Berechtigungen unklar sindget-offeringaufrufen, wenn der aktuelle Entwurfsstatus unklar ist- nur die spezifischen ungültigen oder fehlenden Daten korrigieren
- vor der Veröffentlichung erneut
check-offering-publish-readinessaufrufen
Berechtigungsfehler
Ein Berechtigungsfehler bedeutet, dass die authentifizierte Integration nicht über den erforderlichen Scope verfügt.
| Operation | Erforderlicher Scope |
|---|---|
| auflisten/lesen/prüfen | catalog:read |
| erstellen/aktualisieren/übersetzen/verwerfen | catalog:write |
| veröffentlichen/einstellen | catalog:publish |
Wiederherstellung:
whoamiaufrufen- gewährte Scopes bestätigen
- fehlenden Scope anfordern
Fehler „nicht gefunden"
Ein Angebot wird möglicherweise nicht gefunden, wenn:
- die
offeringIdfalsch ist - das Angebot einem anderen Unternehmen gehört
- die Integration für ein anderes Unternehmen authentifiziert ist
Wiederherstellung:
list-offeringsmit einem Titel, SKU oder anderen bekannten Bezeichner aufrufen- das ausgewählte Angebot bestätigen, bevor es geändert wird
Validierungsfehler
Validierungsfehler bedeuten normalerweise, dass die Eingabestruktur oder der Feldwert ungültig ist.
Häufige Ursachen:
| Ursache | Lösung |
|---|---|
category_id ohne category_label | Beide Felder angeben. |
| Ungültiger Sprachcode | get-supported-languages verwenden. |
| Hauptsprache in Übersetzungen enthalten | Hauptsprache aus dem Übersetzungs-Payload entfernen. |
| Ungültiger Einheitencode | Gültigen 3-Zeichen-Einheitencode verwenden. |
Attribut mit unit, aber nicht-numerischem Wert | Numerischen Wert verwenden. |
Attribut mit valueLabel, aber nicht-String-Wert | String-Wert verwenden. |
Versuch, kind oder language zu ändern | Entwurf verwerfen und neues Angebot erstellen. |
Fehler bei der Veröffentlichungsbereitschaft
check-offering-publish-readiness gibt zurück:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Wenn publishable false ist, publish-offering nicht aufrufen.
Häufige Bereitschaftsprobleme:
- fehlender Titel, fehlende Beschreibung oder Maßeinheit in der Hauptsprache
- fehlende Übersetzungen für unterstützte Nicht-Hauptsprachen
- fehlende übersetzte Kategorie-Labels
- fehlende Attributübersetzungen
- ungültige Attributwert/Einheiten-Kombination
- fehlende übersetzte Attributbeschreibungen oder Wert-Labels
Wiederherstellung:
- zurückgegebene Fehler korrigieren
- erneut
check-offering-publish-readinessaufrufen - nur veröffentlichen, wenn
publishabletrueist
Fehler im Entwurfslebenszyklus
Wenn kind oder language falsch ist, nicht versuchen, es per Patch zu korrigieren.
Diese Felder sind unveränderlich. Die korrekte Wiederherstellung besteht darin, den Entwurf mit discard-offering-draft zu verwerfen und ein neues Angebot zu erstellen.
Wenn ein Angebot bereits eine aktuelle veröffentlichte Version hat, wird durch das Verwerfen des Entwurfs die aktive Version nicht entfernt.
Veröffentlichungsfehler
publish-offering kann fehlschlagen, wenn der Entwurf unvollständig oder ungültig ist.
Wiederherstellung:
check-offering-publish-readinessaufrufen- zurückgegebene Fehler korrigieren
- erst nach bestandener Bereitschaftsprüfung veröffentlichen
Backend-Fetch-Fehler
Ein Tool kann einen Fetch-Fehler zurückgeben, wenn die Backend-Anfrage fehlschlägt, bevor eine gültige Antwort zurückgegeben wird.
Wiederherstellung:
- dieselbe Nur-Lese-Operation bei Bedarf wiederholen
- Änderungsaufrufe nicht wiederholen, ohne den aktuellen Status zuvor mit
get-offeringgeprüft zu haben - die Fehlermeldung melden, wenn der Fehler anhält