PolyDrobe verwenden.
Richten Sie einen Arbeitsbereich ein, modellieren Sie Ihre Assets und Varianten, laden Sie das Team ein und beheben Sie die Fehler, die am häufigsten auftreten.
In vier Schritten einsatzbereit
Projekt, Taxonomie, Assets, Team. In dieser Reihenfolge.
Projekt erstellen
Erstellen Sie Ihr erstes Projekt und vergeben Sie einen klaren Projekt-Slug.
Taxonomie konfigurieren
Konfigurieren Sie Kernbereiche: Kategorien, Seltenheiten, Tags, Währungen, Status und Veröffentlichungen.
Assets & Varianten hinzufügen
Fügen Sie Assets hinzu und erstellen Sie Varianten mit Bildern, Preisdaten und optionalen Metadaten.
Laden Sie Ihr Team ein
Laden Sie Teammitglieder ein und vergeben Sie die Rollen Eigentümer, Editor oder Zuschauer.
Alles, was Sie tun können
Öffnen Sie einen Workflow, um die Details zu sehen.
Projekt-SetupZuerst Struktur, dann Inhalte.
- Pflegen Sie Projektdetails und Icon.
- Definieren Sie wiederverwendbare Taxonomie in den Projekteinstellungen.
Asset- und VariantenverwaltungAssets für Objekte, Varianten für Versionen.
- Ergänzen Sie Asset-Metadaten und weisen Sie Kategorie/Seltenheit zu.
- Hinterlegen Sie bei Varianten Texturen, Bilder und Preise.
Review und SucheHalten Sie den Katalog übersichtlich und wartbar.
- Nutzen Sie Filter, Status und Tags, um die Arbeit zu finden, die vor Ihnen liegt.
- Prüfen Sie Änderungen im Aktivitätsprotokoll.
Import und ExportTauschen Sie Daten sicher mit Ihrer Pipeline aus.
- Exportieren Sie Projektdaten als JSON oder Excel, oder aktivieren Sie „Mediendateien einschließen“ für ein ZIP-Paket mit Bildern, Texturen und Meshes.
- Importieren Sie JSON, Excel oder ZIP-Pakete. Jeder Import startet mit einer Vorschau: Sie prüfen die Änderungen und Fehler Zeile für Zeile, bevor etwas übernommen wird.
Google-Sheets-ImportImportieren Sie Assets, Varianten und Projekteinstellungen aus einer nativen Google-Tabelle.
- Legen Sie eine native Google-Tabelle an (keine hochgeladene .xlsx) mit einem Arbeitsblatt pro Eintragstyp: Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
- Tragen Sie die exakten Spaltenüberschriften in die erste Zeile jedes Arbeitsblatts ein (Groß- und Kleinschreibung zählt). Das Blatt Variants braucht zum Beispiel: slug, name, asset_slug, rarity, release, currency, price, description, tags.
- Der Import läuft in Abhängigkeitsreihenfolge: Currencies, Rarities, Releases, Tags, Categories, Assets und zuletzt Variants. Worauf eine Zeile verweist, muss bereits im Projekt vorhanden sein oder im selben Lauf weiter oben stehen.
- Öffnen Sie in Ihrem Projekt die Seite „Datenaustausch“ (Import / Export im Projektmenü), wählen Sie Google-Tabelle als Importquelle und verbinden Sie Ihr Google-Konto. PolyDrobe fordert bei Google den Bereich drive.file an und kann damit nur die Dateien lesen, die Sie ihm übergeben.
- Vergeben Sie unter „Profil erstellen“ eine Bezeichnung, klicken Sie auf „Durchsuchen“ und wählen Sie Ihre Tabelle im Google Picker aus, passen Sie die Namen der Arbeitsblätter an, falls Ihre Tabs anders heißen, und klicken Sie auf „Profil speichern“.
- Starten Sie beim gespeicherten Profil zuerst „Vorschau“. Das ist ein Testlauf, der Validierungsfehler meldet, ohne etwas zu schreiben; „Import“ führt denselben Lauf anschließend echt aus.
- Tags an Assets oder Varianten trennen Sie mit Semikolon: starter;seasonal=winter;limited-edition.
- Preise akzeptieren Punkt und Komma als Dezimaltrennzeichen (9.99 oder 9,99). Die Seltenheit wird über den Namen zugeordnet, die Währung über den Code und die Veröffentlichung über die Versionsangabe.
Entwickler-Guides
Verbinden Sie Ihre Tools, Agenten und Pipelines mit PolyDrobe.
REST-API einrichtenBinden Sie PolyDrobe über die Standard-REST-API an. Verfügbar im Pro-Plan.
1. Zugriffstoken erzeugen
Gehen Sie zu Arbeitsbereichseinstellungen > API-Tokens und erstellen Sie ein neues persönliches Zugriffstoken. Geben Sie ihm einen sprechenden Namen (z. B. „CI-Pipeline“ oder „Lokales Skript“), wählen Sie Lese- und Schreibrechte und legen Sie eine Gültigkeitsdauer fest. Kopieren Sie das Token, sobald es erscheint, denn es wird nur ein einziges Mal angezeigt.
# 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. Anfragen authentifizieren
Senden Sie das Token bei jeder Anfrage als Bearer-Token im Authorization-Header mit.
curl -H "Authorization: Bearer pdtk_abc123..." \
https://polydrobe.app/api/v1/projects/
3. Ihre Projekte auflisten
Liefert alle Projekte, in denen Sie Mitglied sind. Die Antwort nutzt das Standard-Envelope-Format mit den Schlüsseln data und 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. Ein Asset anlegen
Legt ein Asset innerhalb eines Projekts an. Erfordert die Rolle Editor oder Eigentümer. Der Slug entsteht automatisch aus dem Namen.
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. Eine Variante anlegen
Fügen Sie einem Asset eine Variante mit Preis, Seltenheit und Status hinzu. Alle Fremdschlüssel-Verweise laufen über Slugs.
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. Assets durchsuchen
Volltextsuche über Assets und Varianten auf Basis der PostgreSQL-Suche. Unterstützt Phrasen, OR und Negation.
GET /api/v1/projects/cyber-skins/search/?q=gold+legendary&type=variant&limit=10
7. Massenoperationen
Aktualisieren oder löschen Sie mehrere Varianten auf einmal. Erfordert die Funktion Massenoperationen aus dem Pro-Plan.
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/
Verfügbare Endpunkte
Die REST-API erreicht jede Projektressource, die PolyDrobe speichert, vom Katalog selbst über Medien und Massenbearbeitungen bis zum Aktivitätsprotokoll und zu Webhooks. Die Gruppen unten sind der vollständige Satz. Jede Ressource nutzt Slug-basierte URLs.
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}/
MCP-Server einrichtenVerbinden Sie KI-Assistenten (Claude, ChatGPT) über das Model Context Protocol mit PolyDrobe. Verfügbar im Pro-Plan.
1. Persönliches Zugriffstoken erzeugen
Gehen Sie zu Arbeitsbereichseinstellungen > API-Tokens und erstellen Sie ein neues Token. Benennen Sie es nach Ihrem KI-Client (z. B. „Claude Desktop“ oder „Claude Code“). Wählen Sie Lese- und Schreibrechte und eine lange Gültigkeit (1 Jahr oder unbegrenzt). Kopieren Sie das Token, sobald es erscheint, denn es wird nur ein einziges Mal angezeigt.
# 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. Claude Desktop verbinden
Tragen Sie den PolyDrobe-MCP-Server in Ihre Claude-Desktop-Konfiguration ein. Öffnen Sie claude_desktop_config.json und ergänzen Sie diesen Eintrag.
{
"mcpServers": {
"polydrobe": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://polydrobe.app/mcp"],
"env": {
"MCP_HEADERS": "Authorization: Bearer pdtk_abc123..."
}
}
}
}
3. Claude Code verbinden
Fügen Sie den MCP-Server im Terminal über die Claude-Code-CLI hinzu.
claude mcp add polydrobe \ --transport http \ --url https://polydrobe.app/mcp \ --header "Authorization: Bearer pdtk_abc123..."
4. Lokale Entwicklung (stdio-Modus)
Für die lokale Entwicklung starten Sie den MCP-Server direkt über stdio, ohne HTTP. Dabei sind Sie bereits als der angegebene Benutzer angemeldet.
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. Ausprobieren
Sobald die Verbindung steht, stellen Sie Ihrem KI-Assistenten Fragen zu Ihren Projektdaten in natürlicher Sprache.
# 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"
Verfügbare MCP-Tools
Jede Lese-, Schreib-, Such- und Exportoperation in PolyDrobe steht als Tool bereit. Ein KI-Assistent findet den gesamten Satz beim Verbinden, nach Kategorien gruppiert, und Sie konfigurieren dafür nichts.
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 für den Produktivbetrieb (fortgeschritten)
Für CI/CD-Pipelines und Server-zu-Server-Integrationen nutzen Sie statt persönlicher Tokens den OAuth-2.1-Flow mit Client Credentials. Für die Einrichtung einer OAuth-Anwendung wenden Sie sich an den Support.
# 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.
Wer kann was tun
Drei Rollen, geschnitten danach, was die jeweilige Person ändern muss. Zuschauer bleiben kostenlos.
Eigentümer
Verwaltet Projekteinstellungen, Planlimits und Teamzugriffe.
- Projekteinstellungen
- Abrechnung
- Teamverwaltung
- Assets erstellen oder bearbeiten
- Import & Export
- Schreibgeschütztes Durchsuchen
Editor
Erstellt und aktualisiert Assets, Varianten und operative Daten.
- Projekteinstellungen
- Abrechnung
- Teamverwaltung
- Assets erstellen oder bearbeiten
- Import & Export
- Schreibgeschütztes Durchsuchen
Zuschauer
Liest Projektdaten für Review, QA oder Stakeholder-Transparenz.
- Projekteinstellungen
- Abrechnung
- Teamverwaltung
- Assets erstellen oder bearbeiten
- Import & Export
- Schreibgeschütztes Durchsuchen
Häufig gestellte Fragen
Was ist PolyDrobe?
Welche Arten von Assets verwaltet PolyDrobe?
Unterstützt PolyDrobe eine 3D-Modellvorschau?
Wie schlägt sich PolyDrobe gegenüber Google Sheets beim Nachhalten von Game-Assets?
Worin unterscheidet sich PolyDrobe von Notion oder Airtable?
Mit welchen Game-Engines ist PolyDrobe kompatibel?
Können KI-Agenten mit PolyDrobe arbeiten?
Was ist der Unterschied zwischen der REST-API und dem MCP-Server?
Wie bekomme ich ein API-Zugriffstoken?
Unterstützt PolyDrobe die Zusammenarbeit im Team?
Soll jede Skin als Asset oder Variante modelliert werden?
Wie halte ich Benennungen konsistent?
Kann ich Projektdaten extern teilen?
Was ist im Free-Plan enthalten?
Zählen Zuschauer-Sitze zur Abrechnung?
Ist PolyDrobe ein SaaS-Produkt?
Kann ich bestehende Asset-Daten nach PolyDrobe importieren?
Welche Spalten braucht die Vorlage für den Google-Sheets-Import?
Warum meldet mein Google-Sheets-Import „Tabellenmetadaten konnten nicht geladen werden“?
Muss ich Google für jedes Projekt einzeln verbinden?
Häufige Probleme
Schnelle Lösungen für die häufigsten Probleme.
Fehlende Berechtigungen
Wenn eine Aktion fehlt, prüfen Sie Ihre Rolle und bitten Sie einen Eigentümer um Zugriffsanpassung.
Import-Validierungsfehler
Prüfen Sie Pflichtfelder, Kategorie-Slugs und Enum-Werte vor erneutem Import.
Probleme beim Medien-Upload
Prüfen Sie Dateityp, Dateigröße und genutzten Speicher gegen Ihre Planlimits.
Google Sheets: „Tabellenmetadaten konnten nicht geladen werden“
Die Datei ist wahrscheinlich eine hochgeladene .xlsx und keine native Google-Tabelle. Öffnen Sie sie, wählen Sie File > Save as Google Sheets, klicken Sie dann im Sync-Profil auf „Durchsuchen“ und wählen Sie die konvertierte Datei aus. Prüfen Sie außerdem, ob das verbundene Google-Konto die Tabelle öffnen kann.
Google Sheets: Assets oder Varianten scheitern mit „Tag not found“ oder „Category not found“
Referenzierte Einträge müssen existieren, bevor etwas auf sie zeigen kann. Der Import geht die Arbeitsblätter der Reihe nach durch (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), eine Kategorie, die nicht importiert wurde, reißt also ihre Assets mit. Lesen Sie die Vorschau des Testlaufs von oben und beheben Sie zuerst den frühesten Eintragstyp.
Google Sheets: Variantenpreis meldet „invalid price“
Der Import akzeptiert Punkt (9.99) und Komma (9,99) als Dezimaltrennzeichen. Bleibt der Fehler bestehen, suchen Sie in der Preiszelle nach überzähligen Zeichen, Währungssymbolen oder Leerzeichen.