Referenz

MCP-Upload-Fehler bei PlayDrop und wie du sie behebst

Die Fehlerform der MCP-Tools von PlayDrop, wann du es mit derselben requestId erneut versuchst, und die Lösung für jeden häufigen Fehlercode.

Jeder Fehler eines PlayDrop-MCP-Tools behält seinen stabilen error-Code und alle Details wie path, field, name oder expected und ergänzt:

message: was schiefgelaufen ist, in einfachen Worten.
retryable: nur dann true, wenn derselbe Aufruf später gelingen kann.
nextAction: die konkrete Korrektur.
docsUrl und documentationTopic: die passende Anleitung, auch über get_documentation verfügbar.

Wiederholen oder korrigieren

Wiederholbare Fehler (vorübergehende Ausfälle, Ratenlimits, ein unterbrochener Abschluss): Wiederhole nach kurzer Wartezeit denselben Aufruf mit derselben requestId. Erstelle keine weitere Version.
Verlorene Antwort: Du kannst nicht wissen, ob es geklappt hat, also sende den identischen Inhalt mit derselben requestId erneut. PlayDrop gibt das ursprüngliche Ergebnis zurück, statt doppelt zu veröffentlichen.
Abgelehnte Eingabe: Korrigiere zuerst das genannte Feld oder die genannte Datei. Geänderter Inhalt braucht eine neue requestId; eine unveränderte Eingabe scheitert erneut.
Teilergebnisse bei Paketen: Abgeschlossene Einträge bleiben veröffentlicht. Eine korrigierte Anfrage sollte nur die noch offene Arbeit enthalten.
send_feedback hat keinen Wiederholungsschlüssel. Sende nach einem unklaren Fehlschlag nicht automatisch erneut: Die erste Nachricht ist vielleicht schon angekommen.

Häufige Fehler

Code	Was zu tun ist
`advanced_upload_required`	Das Spiel nutzt das SDK, einen Server, separate Dateien oder Felder, die nur für Pakete gelten. Behalte diese Funktionen und lade ein Paket mit einer neuen `requestId` hoch.
`invalid_html_file`	Das HTML ist leer oder größer als 10 MiB. Nutze für größere Spiele ein Paket.
`visibility_required`	Eine App im Paket hat keine Sichtbarkeit. Setze `visibility` in der Anfrage oder bei der App: `public`, `unlisted` oder `private`.
`invalid_visibility`	Verwende `public`, `unlisted` oder `private`.
`visibility_conflict`	Die Anfrage und ein App-Eintrag verlangen unterschiedliche Sichtbarkeiten. Gib nur eine an, damit das Publikum nie stillschweigend geändert wird.
`expected_current_version_required`	Trage den Namen jeder App in `expectedCurrentVersion` ein: `null` für ein neues Spiel, sonst die aktuelle Version aus `list_games`.
`current_version_changed`	Jemand hat eine neuere Version veröffentlicht. Rufe `list_games` auf, bestätige das Ziel mit deinem Menschen und lade dann mit der aktuellen Version und einer neuen `requestId` hoch.
`game_exists_use_id`, `game_not_found`	Rufe `list_games` auf, verwende die richtige `gameId` oder den richtigen Namen und behalte den bestehenden Namen des Spiels.
`request_id_content_conflict`	Diese `requestId` gehört bereits zu anderem Inhalt. Verwende eine neue ID oder sende den ursprünglichen Inhalt unverändert erneut.
`catalogue_file_missing_or_invalid`	Eine Datei wurde nicht hochgeladen oder ihre Bytes stimmen nicht überein. Rufe `prepare_catalogue_upload` erneut mit identischer Eingabe und derselben `requestId` auf, lade die fehlenden Dateien per PUT hoch und schließe dann erneut ab.
`catalogue_files_unclaimed`	Einige Dateien werden von keinem Katalogeintrag verwendet. Verweise auf sie, gib Dateien für den Spieleintrag `role: "LISTING"` und `app` oder entferne sie.
`entry_point_missing`	`apps[].file` nennt eine Datei, die nicht hochgeladen wurde. Ohne `file` ist der Standard für die Einstiegsseite `<name>.html`.
`archive_catalogue_required`	Lege catalogue.json ins Stammverzeichnis der ZIP-Datei, nicht in einen Ordner.
`archive_too_large`	Über 20 MiB komprimiert: Entpacke die Datei und lade den Ordner mit signierten Dateien hoch, was bis zu 50 MiB pro Datei erlaubt. Über 200 MiB entpackt: Das Spiel selbst ist zu groß für eine Version; komprimiere oder entferne Assets.
`procedural_module_validation_unavailable`	Ausführbare prozedurale 3D-Modelle oder Modelle in eigenem Format können nicht über MCP hochgeladen werden. Backe sie vorab oder verweise auf ein veröffentlichtes Asset.
`upload_expired`, `upload_cancelled`	Bereite den Upload mit einer neuen `requestId` erneut vor und schließe ihn innerhalb von 30 Minuten ab.
`invalid_token`, `insufficient_scope`	Verbinde das PlayDrop-Konto in deiner KI-App neu und erlaube das Veröffentlichen.

Fehler bei Katalogfeldern, etwa ein ungültiger Tag, eine falsche Controller-Angabe oder ein falscher Spielermodus, verweisen auf die catalogue.json-Referenz.

Verbindung und Anhänge

Abgelaufene Verbindung: Eine aktive Verbindung erneuert sich selbst, solange sie genutzt wird. Eine Verbindung, die 30 Tage lang nicht genutzt wurde oder schon vor Einführung dieser Regel abgelaufen ist, muss neu hergestellt werden.
Anhang abgelehnt: PlayDrop lädt Dateien nur vom eigenen Anhangsdienst des Hosts herunter. Das ist eine Einschränkung des Datei-Hosts, keine Länderbeschränkung. Übergib den vom Host aufgelösten Anhang oder lade die Dateien über signierte URLs hoch. Erfinde niemals eine download_url oder file_id.

Problem melden

Wenn ein Fehler falsch aussieht oder die nächste Aktion nicht funktioniert, rufe send_feedback einmal auf, mit dem Tool-Namen, dem Fehlercode, dem, was du gesendet hast (ohne Tokens oder signierte URLs), und dem, was du erwartet hast.

Wiederholen oder korrigieren

Wiederholbare Fehler (vorübergehende Ausfälle, Ratenlimits, ein unterbrochener Abschluss): Wiederhole nach kurzer Wartezeit denselben Aufruf mit derselben requestId. Erstelle keine weitere Version.
Verlorene Antwort: Du kannst nicht wissen, ob es geklappt hat, also sende den identischen Inhalt mit derselben requestId erneut. PlayDrop gibt das ursprüngliche Ergebnis zurück, statt doppelt zu veröffentlichen.
Abgelehnte Eingabe: Korrigiere zuerst das genannte Feld oder die genannte Datei. Geänderter Inhalt braucht eine neue requestId; eine unveränderte Eingabe scheitert erneut.
Teilergebnisse bei Paketen: Abgeschlossene Einträge bleiben veröffentlicht. Eine korrigierte Anfrage sollte nur die noch offene Arbeit enthalten.
send_feedback hat keinen Wiederholungsschlüssel. Sende nach einem unklaren Fehlschlag nicht automatisch erneut: Die erste Nachricht ist vielleicht schon angekommen.

Häufige Fehler

Code	Was zu tun ist
`advanced_upload_required`	Das Spiel nutzt das SDK, einen Server, separate Dateien oder Felder, die nur für Pakete gelten. Behalte diese Funktionen und lade ein Paket mit einer neuen `requestId` hoch.
`invalid_html_file`	Das HTML ist leer oder größer als 10 MiB. Nutze für größere Spiele ein Paket.
`visibility_required`	Eine App im Paket hat keine Sichtbarkeit. Setze `visibility` in der Anfrage oder bei der App: `public`, `unlisted` oder `private`.
`invalid_visibility`	Verwende `public`, `unlisted` oder `private`.
`visibility_conflict`	Die Anfrage und ein App-Eintrag verlangen unterschiedliche Sichtbarkeiten. Gib nur eine an, damit das Publikum nie stillschweigend geändert wird.
`expected_current_version_required`	Trage den Namen jeder App in `expectedCurrentVersion` ein: `null` für ein neues Spiel, sonst die aktuelle Version aus `list_games`.
`current_version_changed`	Jemand hat eine neuere Version veröffentlicht. Rufe `list_games` auf, bestätige das Ziel mit deinem Menschen und lade dann mit der aktuellen Version und einer neuen `requestId` hoch.
`game_exists_use_id`, `game_not_found`	Rufe `list_games` auf, verwende die richtige `gameId` oder den richtigen Namen und behalte den bestehenden Namen des Spiels.
`request_id_content_conflict`	Diese `requestId` gehört bereits zu anderem Inhalt. Verwende eine neue ID oder sende den ursprünglichen Inhalt unverändert erneut.
`catalogue_file_missing_or_invalid`	Eine Datei wurde nicht hochgeladen oder ihre Bytes stimmen nicht überein. Rufe `prepare_catalogue_upload` erneut mit identischer Eingabe und derselben `requestId` auf, lade die fehlenden Dateien per PUT hoch und schließe dann erneut ab.
`catalogue_files_unclaimed`	Einige Dateien werden von keinem Katalogeintrag verwendet. Verweise auf sie, gib Dateien für den Spieleintrag `role: "LISTING"` und `app` oder entferne sie.
`entry_point_missing`	`apps[].file` nennt eine Datei, die nicht hochgeladen wurde. Ohne `file` ist der Standard für die Einstiegsseite `<name>.html`.
`archive_catalogue_required`	Lege catalogue.json ins Stammverzeichnis der ZIP-Datei, nicht in einen Ordner.
`archive_too_large`	Über 20 MiB komprimiert: Entpacke die Datei und lade den Ordner mit signierten Dateien hoch, was bis zu 50 MiB pro Datei erlaubt. Über 200 MiB entpackt: Das Spiel selbst ist zu groß für eine Version; komprimiere oder entferne Assets.
`procedural_module_validation_unavailable`	Ausführbare prozedurale 3D-Modelle oder Modelle in eigenem Format können nicht über MCP hochgeladen werden. Backe sie vorab oder verweise auf ein veröffentlichtes Asset.
`upload_expired`, `upload_cancelled`	Bereite den Upload mit einer neuen `requestId` erneut vor und schließe ihn innerhalb von 30 Minuten ab.
`invalid_token`, `insufficient_scope`	Verbinde das PlayDrop-Konto in deiner KI-App neu und erlaube das Veröffentlichen.

Fehler bei Katalogfeldern, etwa ein ungültiger Tag, eine falsche Controller-Angabe oder ein falscher Spielermodus, verweisen auf die catalogue.json-Referenz.

Verbindung und Anhänge

Abgelaufene Verbindung: Eine aktive Verbindung erneuert sich selbst, solange sie genutzt wird. Eine Verbindung, die 30 Tage lang nicht genutzt wurde oder schon vor Einführung dieser Regel abgelaufen ist, muss neu hergestellt werden.
Anhang abgelehnt: PlayDrop lädt Dateien nur vom eigenen Anhangsdienst des Hosts herunter. Das ist eine Einschränkung des Datei-Hosts, keine Länderbeschränkung. Übergib den vom Host aufgelösten Anhang oder lade die Dateien über signierte URLs hoch. Erfinde niemals eine download_url oder file_id.