# Uppladdningsfel i PlayDrops MCP och hur du åtgärdar dem

Formatet på felen som PlayDrops MCP-verktyg returnerar, när du ska försöka igen med samma requestId och åtgärden för varje vanlig felkod.

Source: https://www.playdrop.ai/sv/create/learn/errors

Varje fel från ett MCP-verktyg i PlayDrop behåller sin stabila `error`-kod och eventuella detaljer som `path`, `field`, `name` eller `expected`, och lägger till:

- `message`: vad som gick fel, med enkla ord.
- `retryable`: `true` bara när exakt samma anrop kan lyckas senare.
- `nextAction`: den konkreta rättelsen.
- `docsUrl` och `documentationTopic`: guiden att läsa, som också finns via `get_documentation`.

## Försök igen eller rätta

- **Fel som går att försöka igen** (tillfälliga fel, hastighetsbegränsningar, ett avbrutet slutförande): gör exakt samma anrop igen med samma `requestId` efter en kort stund. Skapa ingen ny version.
- **Förlorat svar:** du kan inte veta om det fungerade, så skicka exakt samma innehåll igen med samma `requestId`. PlayDrop returnerar det ursprungliga resultatet i stället för att publicera två gånger.
- **Avvisad indata:** rätta först det namngivna fältet eller den namngivna filen. Ändrat innehåll kräver ett nytt `requestId`; att försöka igen med oförändrad indata misslyckas igen.
- **Delvisa paketresultat:** slutförda poster förblir publicerade. En rättad förfrågan ska bara innehålla det arbete som inte är klart.
- **`send_feedback`** har ingen nyckel för nya försök. Efter ett oklart fel ska du inte skicka igen automatiskt: det första meddelandet kan ha kommit fram.

## Vanliga fel

| Kod | Vad du ska göra |
|---|---|
| `advanced_upload_required` | Spelet använder SDK:t, en server, separata filer eller fält som bara finns för paket. Behåll de funktionerna och ladda upp ett [paket](https://www.playdrop.ai/sv/create/learn/packaging) med ett nytt `requestId`. |
| `invalid_html_file` | HTML-filen är tom eller större än 10 MiB. Använd ett paket för större spel. |
| `visibility_required` | En app i ett paket saknar synlighet. Ange `visibility` i förfrågan eller i appen: `public`, `unlisted` eller `private`. |
| `invalid_visibility` | Använd `public`, `unlisted` eller `private`. |
| `visibility_conflict` | Förfrågan och posten för en app begär olika synlighet. Ange en, så att publiken aldrig ändras i tysthet. |
| `expected_current_version_required` | Lägg till varje apps namn i `expectedCurrentVersion`: `null` för ett nytt spel, annars den aktuella versionen från `list_games`. |
| `current_version_changed` | Någon har publicerat en nyare version. Anropa `list_games`, bekräfta målet med din användare och ladda sedan upp med den aktuella versionen och ett nytt `requestId`. |
| `game_exists_use_id`, `game_not_found` | Anropa `list_games`, använd rätt `gameId` eller namn och behåll spelets befintliga namn. |
| `request_id_content_conflict` | Det här `requestId` hör redan till annat innehåll. Använd ett nytt ID eller skicka det ursprungliga innehållet igen oförändrat. |
| `catalogue_file_missing_or_invalid` | En fil laddades inte upp eller dess byte stämmer inte. Anropa `prepare_catalogue_upload` igen med identisk indata och samma `requestId`, gör PUT på de saknade filerna och slutför sedan igen. |
| `catalogue_files_unclaimed` | Vissa filer används inte av någon katalogpost. Referera till dem, ge filer för spelsidan `role: "LISTING"` och `app`, eller ta bort dem. |
| `entry_point_missing` | `apps[].file` anger en fil som inte laddades upp. Utan `file` är startsidan som standard `<name>.html`. |
| `archive_catalogue_required` | Lägg catalogue.json i roten av ZIP-filen, inte i en mapp. |
| `archive_too_large` | Över 20 MiB komprimerat: packa upp och ladda upp mappen med signerade filer, vilket tillåter upp till 50 MiB per fil. Över 200 MiB uppackat: själva spelet är för stort för en version; komprimera eller ta bort assets. |
| `procedural_module_validation_unavailable` | Körbara procedurella 3D-modeller eller modeller i eget format kan inte laddas upp via MCP. Baka dem eller referera till en publicerad asset. |
| `upload_expired`, `upload_cancelled` | Förbered uppladdningen igen med ett nytt `requestId` och slutför den inom 30 minuter. |
| `invalid_token`, `insufficient_scope` | Anslut PlayDrop-kontot igen i din AI-app och tillåt publicering. |

Fel i katalogfält, som en ogiltig tagg, deklaration av handkontroller eller spelarläge, hänvisar till [referensen för catalogue.json](https://www.playdrop.ai/sv/create/learn/catalogue-json).

## Anslutning och bilagor

- **Utgången anslutning:** en aktiv anslutning förnyas av sig själv medan den används. En anslutning som inte har använts på 30 dagar, eller en som gick ut före den här regeln, måste anslutas igen.
- **Avvisad bilaga:** PlayDrop laddar bara ner filer från värdens egen bilagetjänst. Det är en begränsning för filvärdar, inte för länder. Skicka bilagan som värden har löst upp, eller ladda upp filerna med signerade URL:er. Hitta aldrig på en `download_url` eller ett `file_id`.

## Rapportera ett problem

Om ett fel ser felaktigt ut eller nästa åtgärd inte fungerar, anropa `send_feedback` en gång med verktygets namn, felkoden, vad du skickade (utan tokens eller signerade URL:er) och vad du förväntade dig.

## Relaterade guider

- [Publicera från din AI-app](https://www.playdrop.ai/sv/create/learn/mcp-publishing): Så publicerar AI-agenter på PlayDrop via MCP: den enkla vägen och paketvägen, privat testning, publish_game_version, uppdateringar, gränser och felhantering.
- [Paketering och .play](https://www.playdrop.ai/sv/create/learn/packaging): Lägg upp en byggd spelmapp, ZIP eller .play med catalogue.json i roten, deklarera media för spelsidan och servrar och ladda upp med prepare_catalogue_upload.
- [Felsökning](https://www.playdrop.ai/sv/create/learn/troubleshooting): Lös blockerade skapandeuppgifter, otydliga prompter, saknade belöningar eller intäkter, kreditgränser och problem vid import av webbspel.