Jak korzystać z PolyDrobe.
Skonfiguruj przestrzeń roboczą, zamodeluj swoje zasoby i warianty, zaproś zespół i napraw błędy, które pojawiają się najczęściej.
Działanie w czterech krokach
Projekt, taksonomia, zasoby, zespół. W tej kolejności.
Utwórz projekt
Utwórz pierwszy projekt i ustaw czytelny slug projektu.
Skonfiguruj taksonomię
Skonfiguruj kategorie, rzadkości, tagi, waluty, stany i wydania.
Dodaj assety i warianty
Dodaj zasoby, a następnie warianty z obrazami, cenami i opcjonalnymi metadanymi.
Zaproś swój zespół
Zaproś zespół i przypisz role Właściciel, Redaktor lub Przeglądarka.
Wszystko, co możesz zrobić
Otwórz przepływ pracy, aby zobaczyć szczegóły.
Konfiguracja projektuNajpierw struktura, potem treść.
- Uzupełnij dane projektu i ikonę.
- Zdefiniuj wielokrotnie używaną taksonomię w ustawieniach projektu.
Zarządzanie zasobami i wariantamiZasób to element bazowy, wariant to wersja.
- Dodaj metadane zasobu i przypisz kategorię/rzadkość.
- Dołącz tekstury, obrazy i ceny dla wariantów.
Przegląd i wyszukiwanieUtrzymuj katalog czytelny i łatwy w utrzymaniu.
- Użyj filtrów, stanu i tagów, żeby znaleźć pracę, która stoi przed tobą.
- Sprawdzaj zmiany w dzienniku aktywności.
Import i eksportBezpiecznie wymieniaj dane z pipeline.
- Eksportuj dane projektu do JSON lub Excela albo zaznacz Dołącz pliki multimedialne, aby pobrać paczkę ZIP z obrazami, teksturami i siatkami.
- Importuj pliki JSON, Excel lub paczki ZIP. Każdy import zaczyna się od podglądu, więc zmiany i błędy w poszczególnych wierszach sprawdzasz przed zapisaniem czegokolwiek.
Import z Google SheetsImportuj zasoby, warianty i ustawienia projektu z natywnego arkusza Google.
- Utwórz natywny arkusz kalkulacyjny Google (nie przesłany plik .xlsx) z jednym arkuszem na typ encji: Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
- Wpisz dokładne nagłówki kolumn w pierwszym wierszu każdego arkusza (wielkość liter ma znaczenie). Na przykład arkusz Variants wymaga kolumn: slug, name, asset_slug, rarity, release, currency, price, description, tags.
- Encje są importowane w kolejności zależności: Currencies, Rarities, Releases, Tags, Categories, Assets i na końcu Variants. Wszystko, do czego odwołuje się wiersz, musi już istnieć w projekcie albo pojawić się wcześniej w tym samym przebiegu.
- W swoim projekcie otwórz stronę Wymiana danych (Import / Eksport w menu projektu), wybierz Arkusz Google jako źródło importu i połącz swoje konto Google. PolyDrobe prosi o zakres drive.file, więc odczyta tylko te pliki, które mu wskażesz.
- W sekcji Utwórz profil nadaj profilowi etykietę, kliknij Przeglądaj, aby wybrać swój arkusz w Google Picker, popraw nazwy arkuszy, jeśli twoje karty nazywają się inaczej, i kliknij Zapisz profil.
- Na zapisanym profilu uruchom najpierw Podgląd. To uruchomienie testowe, które zgłasza błędy walidacji i niczego nie zapisuje; Importuj wykonuje ten sam przebieg na serio.
- Tagi zasobów i wariantów podawaj jako wartości rozdzielone średnikami: starter;seasonal=winter;limited-edition.
- Ceny przyjmują kropkę i przecinek jako separator dziesiętny (9.99 lub 9,99). Rzadkość jest dopasowywana po nazwie, waluta po kodzie, a wydanie po numerze wersji.
Przewodniki dla deweloperów
Podłącz swoje narzędzia, agentów AI i pipeline do PolyDrobe.
Konfiguracja REST APIZintegruj się z PolyDrobe przez standardowe REST API. Dostępne w planie Pro.
1. Wygeneruj token dostępu
Przejdź do Ustawienia przestrzeni roboczej > Tokeny API i utwórz nowy osobisty token dostępu. Nadaj mu opisową nazwę (np. „CI Pipeline” lub „Local Script”), zaznacz zakresy odczytu i zapisu oraz wybierz okres ważności. Skopiuj token, gdy się pojawi, bo pokazujemy go tylko raz.
# 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. Uwierzytelniaj żądania
Dołączaj token jako token Bearer w nagłówku Authorization przy każdym żądaniu.
curl -H "Authorization: Bearer pdtk_abc123..." \
https://polydrobe.app/api/v1/projects/
3. Wylistuj swoje projekty
Zwraca wszystkie projekty, w których jesteś członkiem. Odpowiedź ma standardową kopertę z kluczami data i 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. Utwórz zasób
Utwórz zasób wewnątrz projektu. Wymaga roli Redaktor lub Właściciel. Slug powstaje automatycznie z nazwy.
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. Utwórz wariant
Dodaj do zasobu wariant z ceną, rzadkością i stanem. Wszystkie odwołania do kluczy obcych używają slugów.
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. Wyszukuj zasoby
Pełnotekstowe wyszukiwanie w zasobach i wariantach oparte na mechanizmie PostgreSQL. Obsługuje frazy, OR i negację.
GET /api/v1/projects/cyber-skins/search/?q=gold+legendary&type=variant&limit=10
7. Operacje zbiorcze
Aktualizuj lub usuwaj wiele wariantów naraz. Wymaga funkcji Operacje zbiorcze, dostępnej w planie 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/
Dostępne endpointy
REST API sięga po wszystkie dane projektu, które przechowuje PolyDrobe: od samego katalogu po media, operacje zbiorcze, dziennik aktywności i webhooki. Grupy poniżej to pełny zestaw. Wszystkie endpointy używają adresów URL opartych na slugach.
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}/
Konfiguracja serwera MCPPodłącz asystentów AI (Claude, ChatGPT) do PolyDrobe przez Model Context Protocol. Dostępne w planie Pro.
1. Wygeneruj osobisty token dostępu
Przejdź do Ustawienia przestrzeni roboczej > Tokeny API i utwórz nowy token. Nazwij go od swojego klienta AI (np. „Claude Desktop” lub „Claude Code”). Zaznacz zakresy odczytu i zapisu oraz wybierz długi okres ważności (1 rok lub bez wygaśnięcia). Skopiuj token, gdy się pojawi, bo pokazujemy go tylko raz.
# 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. Podłącz Claude Desktop
Dodaj serwer MCP PolyDrobe do konfiguracji Claude Desktop. Otwórz plik claude_desktop_config.json i dopisz ten wpis.
{
"mcpServers": {
"polydrobe": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://polydrobe.app/mcp"],
"env": {
"MCP_HEADERS": "Authorization: Bearer pdtk_abc123..."
}
}
}
}
3. Podłącz Claude Code
Dodaj serwer MCP z terminala za pomocą CLI Claude Code.
claude mcp add polydrobe \ --transport http \ --url https://polydrobe.app/mcp \ --header "Authorization: Bearer pdtk_abc123..."
4. Praca lokalna (tryb stdio)
Przy pracy lokalnej uruchom serwer MCP bezpośrednio przez stdio, bez HTTP. Uwierzytelnia on z góry wskazanego użytkownika.
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. Wypróbuj
Po połączeniu zadawaj asystentowi AI pytania o dane projektu zwykłym językiem.
# 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"
Dostępne narzędzia MCP
Każda operacja odczytu, zapisu, wyszukiwania i eksportu w PolyDrobe jest wystawiona jako narzędzie. Asystent AI wykrywa przy połączeniu cały zestaw, pogrupowany w kategorie, i nie musisz nic konfigurować.
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 na produkcji (zaawansowane)
W pipeline'ach CI/CD i integracjach serwer-serwer możesz użyć przepływu client credentials OAuth 2.1 zamiast osobistych tokenów. W sprawie konfiguracji aplikacji OAuth napisz do wsparcia.
# 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.
Kto może co robić
Trzy role, wyznaczone według tego, co każdy musi zmieniać. Przeglądający pozostają bezpłatni.
Właściciel
Zarządza ustawieniami projektu, limitami planu i dostępem zespołu.
- Ustawienia projektu
- Rozliczenia
- Zarządzanie zespołem
- Utwórz lub edytuj assety
- Import i eksport
- Przeglądanie tylko do odczytu
Redaktor
Tworzy i aktualizuje zasoby, warianty oraz dane operacyjne.
- Ustawienia projektu
- Rozliczenia
- Zarządzanie zespołem
- Utwórz lub edytuj assety
- Import i eksport
- Przeglądanie tylko do odczytu
Przeglądarka
Odczytuje dane projektu do review, QA i wglądu interesariuszy.
- Ustawienia projektu
- Rozliczenia
- Zarządzanie zespołem
- Utwórz lub edytuj assety
- Import i eksport
- Przeglądanie tylko do odczytu
Często zadawane pytania
Czym jest PolyDrobe?
Jakimi rodzajami zasobów zarządza PolyDrobe?
Czy PolyDrobe obsługuje podgląd modeli 3D?
Jak PolyDrobe wypada w porównaniu z Google Sheets przy śledzeniu zasobów gry?
Czym PolyDrobe różni się od Notion albo Airtable?
Z jakimi silnikami gier działa PolyDrobe?
Czy agenci AI mogą pracować na danych w PolyDrobe?
Czym różni się REST API od serwera MCP?
Jak zdobyć token dostępu do API?
Czy PolyDrobe wspiera pracę zespołową?
Czy każdy skin powinien być zasobem czy wariantem?
Jak utrzymać spójne nazewnictwo?
Czy mogę udostępniać dane projektu na zewnątrz?
Co zawiera plan Free?
Czy miejsca w roli Przeglądarka liczą się do rozliczenia?
Czy PolyDrobe to produkt SaaS?
Czy mogę zaimportować do PolyDrobe istniejące dane o zasobach?
Jakich kolumn wymaga szablon importu z Google Sheets?
Dlaczego import z Google Sheets zgłasza „Nie udało się wczytać metadanych arkusza”?
Czy muszę łączyć konto Google osobno w każdym projekcie?
Typowe problemy
Szybkie rozwiązania najczęstszych problemów.
Brak uprawnień
Jeśli akcja jest niedostępna, sprawdź swoją rolę i poproś Właściciela o aktualizację dostępu.
Błędy walidacji importu
Przed ponownym importem sprawdź pola wymagane, slugi kategorii i wartości enum.
Problemy z uploadem mediów
Sprawdź typ pliku, rozmiar i użycie przestrzeni dyskowej względem limitów planu.
Google Sheets: „Nie udało się wczytać metadanych arkusza”
Plik jest najpewniej przesłanym .xlsx, a nie natywnym arkuszem Google. Otwórz go, wybierz File > Save as Google Sheets, a potem w profilu synchronizacji kliknij Przeglądaj i wskaż przekonwertowany plik. Sprawdź też, czy podłączone konto Google może otworzyć ten arkusz.
Google Sheets: zasoby lub warianty kończą się błędem „Tag not found” albo „Category not found”
Encje, do których się odwołujesz, muszą istnieć, zanim cokolwiek na nie wskaże. Importer przechodzi arkusze po kolei (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), więc kategoria, która się nie zaimportowała, pociąga za sobą swoje zasoby. Przeczytaj podgląd z uruchomienia testowego od góry i popraw najpierw najwcześniejszy typ encji.
Google Sheets: cena wariantu zgłasza „invalid price”
Import przyjmuje zarówno kropkę (9.99), jak i przecinek (9,99) jako separator dziesiętny. Jeśli błąd nie znika, poszukaj w komórce z ceną zbędnych znaków, symboli waluty lub spacji.