Jak používat PolyDrobe.

Nastavte pracovní prostor, namodelujte svá aktiva a varianty, pozvěte tým a opravte chyby, které se objevují nejčastěji.

V provozu ve čtyřech krocích

Projekt, taxonomie, assety, tým. V tomto pořadí.

Vytvořit projekt

Vytvořte první projekt a nastavte jasný slug projektu.

Nakonfigurovat taxonomii

Nastavte základní konfiguraci: kategorie, rarity, štítky, měny, stavy a vydání.

Přidat assety a varianty

Přidejte aktiva a následně varianty s obrázky, cenami a volitelnými metadaty.

Pozvěte svůj tým

Pozvěte členy týmu a přiřaďte role Majitel, Editor nebo Prohlížeč podle odpovědností.

Vše, co můžete dělat

Otevřete pracovní postup a zobrazte podrobnosti.

Nastavení projektuNejdříve struktura, až potom obsah.

Vyplňte detaily projektu a ikonu.
V nastavení projektu definujte znovupoužitelnou taxonomii.

Správa aktiv a variantAktiva používejte pro položky, varianty pro jejich verze.

Doplňte metadata aktiva a přiřaďte kategorii/raritu.
K variantám připojte textury, obrázky a ceny.

Revize a vyhledáváníUdržujte katalog přehledný a snadno udržovatelný.

Použijte filtry, stav a štítky, abyste našli práci, která je před vámi.
Kontrolujte změny v historii aktivit.

Import a exportBezpečně vyměňujte data s vaším pipeline.

Exportujte data projektu do JSON nebo Excelu, nebo zaškrtněte Zahrnout mediální soubory a stáhněte ZIP balíček s obrázky, texturami a meshy.
Importujte JSON, Excel nebo ZIP balíčky. Každý import nejdřív spustí náhled, takže si změny i chyby projdete po řádcích dřív, než se cokoli uloží.

Import z Google SheetsNaimportujte aktiva, varianty a nastavení projektu z nativní tabulky Google.

Vytvořte nativní tabulku Google (ne nahraný soubor .xlsx) s jedním listem pro každý typ entity: Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
Do prvního řádku každého listu doplňte přesné názvy sloupců (záleží na velikosti písmen). List Variants potřebuje například: slug, name, asset_slug, rarity, release, currency, price, description, tags.
Entity se importují v pořadí závislostí: Currencies, Rarities, Releases, Tags, Categories, Assets a nakonec Variants. Všechno, na co se řádek odkazuje, už musí v projektu existovat, nebo se musí objevit dřív v témže běhu.
V projektu otevřete stránku Výměna dat (Import / Export v nabídce projektu), jako zdroj importu zvolte Google tabulka a připojte svůj účet Google. PolyDrobe si od Googlu vyžádá jen oprávnění drive.file, takže může číst pouze soubory, které mu sami předáte.
V části Vytvořit profil zadejte název profilu, kliknutím na Procházet vyberte tabulku v Google Pickeru, upravte názvy listů, pokud se vaše záložky jmenují jinak, a klikněte na Uložit profil.
U uloženého profilu nejdřív spusťte Náhled. Je to zkušební běh, který nahlásí chyby validace a nic přitom nezapíše. Tlačítko Importovat spustí stejný běh doopravdy.
Štítky u aktiv i variant zapisujte oddělené středníkem: starter;seasonal=winter;limited-edition.
Ceny přijímají desetinnou tečku i čárku (9.99 nebo 9,99). Rarita se páruje podle názvu, měna podle kódu a vydání podle řetězce s verzí.

Průvodci pro vývojáře

Propojte své nástroje, agenty a pipeline s PolyDrobe.

Nastavení REST APINapojte se na PolyDrobe přes standardní REST API. Dostupné v plánu Pro.

1. Vygenerujte přístupový token

Otevřete Nastavení pracovního prostoru > API tokeny a vytvořte nový osobní přístupový token. Pojmenujte ho výstižně (třeba „CI Pipeline“ nebo „Lokální skript“), zvolte oprávnění pro čtení a zápis a nastavte dobu platnosti. Token si zkopírujte hned, jak se zobrazí, protože se ukáže jen jednou.

# Your token will look like this:
pdtk_a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5...

# Keep it safe. You cannot retrieve it later.
# If lost, revoke it and create a new one.

2. Ověřte požadavky tokenem

Do každého požadavku přidejte token jako Bearer token v hlavičce Authorization.

curl -H "Authorization: Bearer pdtk_abc123..." \
     https://polydrobe.app/api/v1/projects/

3. Vypište své projekty

Vrátí všechny projekty, ve kterých jste členem. Odpověď používá standardní obálku s klíči data a meta.

GET /api/v1/projects/

# Response:
{
  "data": [
    {
      "id": "...",
      "name": "Cyber Skins",
      "slug": "cyber-skins",
      "asset_count": 42,
      "my_role": "owner"
    }
  ],
  "meta": { "total": 1, "page": 1, "page_size": 25 }
}

4. Vytvořte aktivum

Vytvořte aktivum uvnitř projektu. Vyžaduje roli Editor nebo Majitel. Slug se generuje automaticky z názvu.

curl -X POST \
  -H "Authorization: Bearer pdtk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Plasma Rifle", "description": "Sci-fi weapon", "category_slug": "weapons"}' \
  https://polydrobe.app/api/v1/projects/cyber-skins/assets/

5. Vytvořte variantu

Přidejte k aktivu variantu s cenou, raritou a stavem. Všechny odkazy na cizí klíče používají slugy.

curl -X POST \
  -H "Authorization: Bearer pdtk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Gold Edition", "rarity_slug": "legendary", "price": "29.99", "currency_code": "USD"}' \
  https://polydrobe.app/api/v1/projects/cyber-skins/assets/plasma-rifle/variants/

6. Hledejte v aktivech

Fulltextové vyhledávání napříč aktivy a variantami postavené na PostgreSQL. Zvládá fráze, OR i negaci.

GET /api/v1/projects/cyber-skins/search/?q=gold+legendary&type=variant&limit=10

7. Hromadné operace

Upravte nebo smažte více variant najednou. Vyžaduje funkci Hromadné operace v plánu Pro.

curl -X POST \
  -H "Authorization: Bearer pdtk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"slugs": ["v1", "v2", "v3"], "updates": {"status_slug": "released"}}' \
  https://polydrobe.app/api/v1/projects/cyber-skins/bulk/variants/update/

Dostupné endpointy

REST API sahá na všechny zdroje projektu, které PolyDrobe ukládá, od samotného katalogu až po média, hromadné úpravy, aktivitu a webhooky. Skupiny níže tvoří kompletní seznam. Každý zdroj používá URL založené na slugu.

Projects:       GET|POST /v1/projects/
                GET|PATCH|DELETE /v1/projects/{slug}/

Assets:         GET|POST /v1/projects/{slug}/assets/
                GET|PATCH|DELETE /v1/projects/{slug}/assets/{slug}/

Variants:       GET|POST /v1/projects/{slug}/assets/{slug}/variants/
                GET|PATCH|DELETE .../assets/{slug}/variants/{slug}/
                GET /v1/projects/{slug}/variants/  (flat list)

Media:          GET .../variants/{slug}/images/
                PATCH|DELETE .../variants/{slug}/images/{uuid}/
                GET .../variants/{slug}/textures/
                DELETE .../variants/{slug}/textures/{uuid}/

Bundles:        GET|POST /v1/projects/{slug}/bundles/
                GET|PUT|PATCH|DELETE /v1/projects/{slug}/bundles/{slug}/
                GET|POST /v1/projects/{slug}/bundles/{slug}/items/
                DELETE .../bundles/{slug}/items/{variant_slug}/

Collections:    GET|POST /v1/projects/{slug}/collections/
                GET|PUT|PATCH|DELETE .../collections/{slug}/
                GET .../collections/{slug}/items/
                POST .../collections/{slug}/members/
                DELETE .../collections/{slug}/members/{variant_slug}/
                POST .../collections/{slug}/duplicate/

Classification: GET|POST /v1/projects/{slug}/{categories|tags|rarities|releases|currencies|statuses}/
                PATCH|DELETE /v1/projects/{slug}/{entity}/{slug}/

Favorites:      GET /v1/projects/{slug}/favorites/
                POST|PUT|DELETE /v1/projects/{slug}/favorites/{kind}/{uuid}/

Team:           GET|POST /v1/projects/{slug}/members/
                PATCH|DELETE /v1/projects/{slug}/members/{user_id}/

Bulk:           POST /v1/projects/{slug}/bulk/variants/update/
                POST /v1/projects/{slug}/bulk/variants/delete/

Search:         GET /v1/projects/{slug}/search/?q=term&type=all
Activity:       GET /v1/projects/{slug}/activity/
Export:         GET /v1/projects/{slug}/export/?format=json
Webhooks:       GET|POST /v1/projects/{slug}/webhooks/
                PATCH|DELETE /v1/projects/{slug}/webhooks/{uuid}/

Nastavení MCP serveruPřipojte k PolyDrobe asistenty AI (Claude, ChatGPT) přes Model Context Protocol. Dostupné v plánu Pro.

1. Vygenerujte osobní přístupový token

Otevřete Nastavení pracovního prostoru > API tokeny a vytvořte nový token. Pojmenujte ho podle svého klienta AI (třeba „Claude Desktop“ nebo „Claude Code“). Zvolte oprávnění pro čtení a zápis a nastavte dlouhou platnost (1 rok nebo bez omezení). Token si zkopírujte hned, jak se zobrazí, protože se ukáže jen jednou.

# Your token will look like this:
pdtk_a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5...

# Use this token in the configuration steps below.
# The same token works for both REST API and MCP server.

2. Připojte Claude Desktop

Přidejte MCP server PolyDrobe do konfigurace Claude Desktop. Otevřete claude_desktop_config.json a vložte tuto položku.

{
  "mcpServers": {
    "polydrobe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://polydrobe.app/mcp"],
      "env": {
        "MCP_HEADERS": "Authorization: Bearer pdtk_abc123..."
      }
    }
  }
}

3. Připojte Claude Code

Přidejte MCP server z terminálu pomocí CLI nástroje Claude Code.

claude mcp add polydrobe \
  --transport http \
  --url https://polydrobe.app/mcp \
  --header "Authorization: Bearer pdtk_abc123..."

4. Lokální vývoj (režim stdio)

Při lokálním vývoji spusťte MCP server přímo přes stdio bez HTTP. Předem vás přihlásí jako zadaného uživatele.

python manage.py mcp_stdio --user=your-username

# Claude Desktop config for local stdio:
{
  "mcpServers": {
    "polydrobe-local": {
      "command": "python",
      "args": ["manage.py", "mcp_stdio", "--user=your-username"],
      "cwd": "/path/to/polydrobe"
    }
  }
}

5. Vyzkoušejte si to

Jakmile je připojení hotové, ptejte se svého asistenta AI na data projektu běžnou řečí.

# Example prompts for your AI assistant:

"List all my projects"
"Show me the assets in project 'cyber-skins'"
"Create a new asset called 'Neon Jacket' in the 'outerwear' category"
"Search for legendary variants with price above 20"
"Set up categories: Headwear, Outerwear, Footwear, Accessories"
"Tag all sword assets with 'melee' and 'weapon'"
"Export the project data as JSON"
"Give me a project overview with sample thumbnails"

Dostupné nástroje MCP

Každá operace čtení, zápisu, vyhledávání a exportu v PolyDrobe je vystavená jako nástroj. Asistent AI si při připojení načte celou sadu rozdělenou do kategorií a nemusíte nic nastavovat.

Projects:       list_projects, get_project, create_project,
                update_project, delete_project

Assets:         list_assets, get_asset, create_asset,
                update_asset, delete_asset

Variants:       list_variants, create_variant,
                update_variant, delete_variant

Bundles:        list_bundles, get_bundle, create_bundle,
                update_bundle, delete_bundle, list_bundle_items,
                add_bundle_item, remove_bundle_item,
                find_bundles_containing_variant

Collections:    collections_list, collections_get,
                collections_create, collections_update,
                collections_delete, collections_add_member,
                collections_remove_member, collections_duplicate

Classification: list_categories, create_category, update_category,
                delete_category, list_tags, create_tag, delete_tag,
                list_rarities, create_rarity, list_releases,
                create_release, list_currencies, create_currency,
                list_statuses, create_status

Tags:           add_asset_tags, remove_asset_tags,
                add_variant_tags, remove_variant_tags

Favorites:      list_favorites, add_favorite,
                remove_favorite, toggle_favorite

Team:           list_members, update_member_role, remove_member

Search:         search (full-text across assets & variants)
Activity:       get_activity_log

Images:         fetch_variant_thumbnail, fetch_variant_image,
                fetch_variant_texture, set_variant_thumbnail

Bulk:           bulk_create_variants, bulk_update_variants,
                bulk_delete_variants

Data:           export_project, import_project_data

OAuth 2.1 pro produkci (pokročilé)

Pro CI/CD pipeline a integrace mezi servery můžete místo osobních tokenů použít tok client credentials podle OAuth 2.1. O založení aplikace OAuth požádejte podporu.

# Exchange client credentials for an access token:
curl -X POST https://polydrobe.app/o/token/ \
  -d "grant_type=client_credentials" \
  -d "client_id=your-client-id" \
  -d "client_secret=your-client-secret" \
  -d "scope=read write"

# For most use cases, personal access tokens from
# Workspace Settings > API Tokens are simpler and sufficient.

Kdo co může dělat

Tři role vymezené podle toho, co kdo potřebuje měnit. Prohlížeči zůstávají zdarma.

Majitel

Spravuje nastavení projektu, limity plánu a přístup členů týmu.

Nastavení projektu
Fakturace
Správa týmu
Vytvořit nebo upravit assety
Import a export
Prohlížení pouze pro čtení

Placené místo

Editor

Vytváří a upravuje aktiva, varianty a provozní data.

Nastavení projektu
Fakturace
Správa týmu
Vytvořit nebo upravit assety
Import a export
Prohlížení pouze pro čtení

Placené místo

Prohlížeč

Pouze čte data projektu pro review, QA nebo stakeholdery.

Nastavení projektu
Fakturace
Správa týmu
Vytvořit nebo upravit assety
Import a export
Prohlížení pouze pro čtení

Bezplatné místo

Často kladené otázky

Co je PolyDrobe?

PolyDrobe je platforma pro správu herních aktiv, ve které dokumentujete a verzujete oděvní aktiva celého herního projektu a spolupracujete na nich: skiny, kosmetiku a doplňky. Místo tabulek, se kterými většina týmů začíná, dostanete strukturovanou databázi s vyhledáváním.

Jaké typy aktiv PolyDrobe spravuje?

PolyDrobe je určený pro herní oděvy a kosmetické předměty: skiny postav, outfity, doplňky, zbraně a jakoukoli položku s několika vizuálními variantami. Každé aktivum může mít víc variant, které představují barevné verze, kvalitativní stupně nebo sezónní edice.

Podporuje PolyDrobe náhled 3D modelů?

Ano. PolyDrobe má vestavěný prohlížeč 3D modelů, který vykreslí soubory .glb a .gltf přímo ve webovém prohlížeči. K aktivům připojíte soubory s meshem, k variantám textury a prohlédnete si je bez opuštění aplikace.

Jak si PolyDrobe stojí proti Google Sheets při sledování herních aktiv?

Google Sheets nemá strukturované datové typy, sledování verzí, řízení rolí ani práci s médii. PolyDrobe nabízí vyhrazená pole pro raritu, stav, cenu, verzi vydání a štítky, ukládá náhledy a 3D modely přímo k záznamu a vynucuje přístup podle rolí.

Čím se PolyDrobe liší od Notionu nebo Airtable?

Notion a Airtable jsou obecné databázové nástroje, schéma pro herní aktiva si v nich postavíte sami. PolyDrobe toto schéma přináší hotové: hierarchii aktivum a varianta, prohlížeč 3D modelů, správu textur, stavy pipeline, úrovně rarity a verzování vydání.

S jakými herními enginy je PolyDrobe kompatibilní?

PolyDrobe je nezávislý na enginu. Dokumentuje a koordinuje katalog, zatímco hru pohání váš engine, takže týmy na Unity, Unreal Engine, Godotu i vlastním enginu ho používají stejně. Export do JSON a Excelu a MCP server dostanou data do vaší pipeline.

Můžou s PolyDrobe pracovat agenti AI?

Ano. PolyDrobe má server Model Context Protocol (MCP) na adrese https://polydrobe.app/mcp. Každá operace čtení, zápisu, vyhledávání a exportu je vystavená jako nástroj. Asistenti AI jako Claude a ChatGPT se připojí pomocí Bearer tokenu a potom umí vypsat projekty, spravovat aktiva, varianty, balíčky i kolekce, nastavovat klasifikace, přiřazovat štítky, hromadně upravovat záznamy a hledat v databázi běžnou řečí. Postup nastavení najdete v sekci Průvodci pro vývojáře.

Jaký je rozdíl mezi REST API a MCP serverem?

Obojí sahá na stejná data přes stejnou servisní vrstvu. REST API používá standardní metody HTTP (GET, POST, PATCH, DELETE) s obálkami v JSON, což se hodí pro skripty, CI/CD pipeline a vlastní integrace. MCP server mluví protokolem Model Context Protocol, takže asistenti AI jako Claude a ChatGPT si s vašimi daty poradí běžnou řečí. Obojí vyžaduje plán Pro a ověření přes OAuth2.

Jak získám přístupový token k API?

Otevřete Nastavení pracovního prostoru > API tokeny a klikněte na Vytvořit token. Zadejte název, zvolte oprávnění (čtení, zápis) a nastavte dobu platnosti. Token si zkopírujte hned, jak se zobrazí, protože se ukáže jen jednou. Stejný token funguje pro REST API i pro MCP server a obojí vyžaduje plán Pro.

Podporuje PolyDrobe týmovou spolupráci?

Ano. Projekty zvládnou víc členů týmu ve třech rolích: Majitel (plná kontrola včetně nastavení a fakturace), Editor (může vytvářet a upravovat aktiva a varianty) a Prohlížeč (přístup jen pro čtení kvůli QA nebo revizi ze strany stakeholderů). Kolegy pozvete e-mailem v nastavení projektu.

Mám každý skin modelovat jako aktivum nebo variantu?

Použijte jedno aktivum pro základní položku a varianty pro každý skin/verzi.

Jak udržet konzistentní názvy?

Používejte jasná pravidla pojmenování a slug URL pro stabilní reference.

Lze sdílet projektová data externě?

Ano, na plánech, které obsahují Výměnu dat. Na stránce Výměna dat vyexportujete celý projekt do JSON nebo Excelu, případně do ZIP balíčku i s mediálními soubory, a předáte ho navazujícím nástrojům, vydavateli nebo externím dodavatelům.

Co zahrnuje plán Free?

Plán Free zahrnuje 1 vlastněný projekt, až 3 členy, 1 GB úložiště pro pracovní prostor, neomezená aktiva, 100 variant na projekt a 30 dní historie aktivit.

Počítají se role Prohlížeč do účtovaných míst?

Ne. Účtovaná místa počítají pouze role Majitel a Editor. Prohlížeči zůstávají zdarma.

Je PolyDrobe SaaS produkt?

Ano. PolyDrobe je webová SaaS aplikace běžící na polydrobe.app. Není co instalovat. Zaregistrujte se, založte projekt a hned začněte přidávat aktiva.

Můžu do PolyDrobe naimportovat stávající data o aktivech?

Ano. PolyDrobe importuje JSON, Excel (.xlsx), ZIP balíčky, které nesou média spolu s datovým souborem, a Google Sheets. Stávající tabulku vyexportujete v očekávaném formátu a naimportujete ji na stránce Výměna dat. Každý import má nejdřív náhled: před potvrzením změn uvidíte u každého řádku, co se vytvoří, co se upraví a kde je chyba.

Jaké sloupce potřebuje šablona pro import z Google Sheets?

Každý list používá vlastní sloupce. Categories potřebují: slug, name, description, parent_slug. Tags potřebují: slug, name, value. Rarities potřebují: name, color (hex #RRGGBB), priority. Currencies potřebují: code, name, symbol. Releases potřebují: version, name, description, release_date (YYYY-MM-DD). Assets potřebují: slug, name, description, category_slug, tags. Variants potřebují: slug, name, asset_slug, rarity, release, currency, price, description, tags. U názvů sloupců záleží na velikosti písmen a musí být v prvním řádku. Synchronizace s Google Sheets pokrývá těchto sedm typů entit; balíčky a kolekce se importují přes nahrání souboru Excel nebo JSON.

Proč můj import z Google Sheets hlásí „Metadata tabulky se nepodařilo načíst“?

Nejspíš jde o nahraný soubor .xlsx otevřený v Google Sheets, ne o nativní tabulku Google. Nahraný soubor poznáte podle URL, která obsahuje „rtpof=true“. Opravíte to tak, že soubor otevřete v Google Sheets, zvolíte File > Save as Google Sheets a potom ve svém profilu synchronizace kliknete na Procházet a vyberete převedený soubor. Zkontrolujte také, že připojený účet Google umí tabulku otevřít.

Musím Google připojovat zvlášť pro každý projekt?

Ano. Každý projekt potřebuje vlastní připojení ke Google kvůli oddělení dat mezi zákazníky. Různé projekty můžou mít různé majitele a různě nastavený přístup. Stejný účet Google přitom můžete použít ve všech projektech.

Běžné problémy

Rychlá řešení nejčastějších problémů.

Chybějící oprávnění

Pokud akce není dostupná, zkontrolujte roli v projektu a požádejte majitele o úpravu přístupu.

Chyby validace při importu

Před opětovným importem ověřte povinná pole, slug kategorií a hodnoty enumů.

Problémy s uploadem médií

Zkontrolujte typ souboru, velikost souboru a využité úložiště vůči limitům plánu.

Google Sheets: „Metadata tabulky se nepodařilo načíst“

Soubor je nejspíš nahraný .xlsx, ne nativní tabulka Google. Otevřete ho, zvolte File > Save as Google Sheets a potom ve svém profilu synchronizace klikněte na Procházet a vyberte převedený soubor. Zkontrolujte také, že připojený účet Google umí tabulku otevřít.

Google Sheets: Assets nebo Variants selžou s hláškou „Tag not found“ nebo „Category not found“

Odkazované entity musí existovat dřív, než na ně může cokoli ukazovat. Import prochází listy v pořadí (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), takže kategorie, kterou se nepodařilo naimportovat, stáhne s sebou i svá aktiva. Přečtěte si náhled zkušebního běhu odshora a opravte nejdřív nejranější typ entity.

Google Sheets: u varianty se objeví „invalid price“

Import přijímá desetinný oddělovač tečku (9.99) i čárku (9,99). Pokud chyba přetrvává, hledejte v buňce s cenou přebytečné znaky, symboly měny nebo mezery.

Zeptejte se nás přímo.

Napište nám e-mail a odpoví vám člověk.

Kontaktujte nás