Cómo usar PolyDrobe.

Configura un espacio de trabajo, modela tus activos y variantes, invita al equipo y corrige los errores que aparecen más a menudo.

En funcionamiento en cuatro pasos

Proyecto, taxonomía, activos, equipo. En ese orden.

1

Crear un proyecto

Crea tu primer proyecto y define un slug claro.

2

Configurar taxonomía

Configura categorías, rarezas, etiquetas, monedas, estados y lanzamientos.

3

Añadir assets y variantes

Añade activos y luego variantes con imágenes, precios y metadatos opcionales.

4

Invite a su equipo

Invita al equipo y asigna roles Propietario, Editor o Espectador según responsabilidad.

Todo lo que puede hacer

Abre un flujo de trabajo para ver los detalles.

Configuración del proyectoPrimero estructura, después contenido.
  • Completa detalles e icono del proyecto.
  • Define taxonomía reutilizable en Configuración del proyecto.
Gestión de activos y variantesUsa activos para ítems y variantes para versiones.
  • Añade metadatos del activo y asigna categoría/rareza.
  • Adjunta texturas, imágenes y precios a cada variante.
Revisión y búsquedaMantén el catálogo claro y fácil de mantener.
  • Usa filtros, estado y etiquetas para encontrar el trabajo que tienes delante.
  • Revisa los cambios en el registro de actividad.
Importar y exportarIntercambia datos de forma segura con tu pipeline.
  • Exporta los datos del proyecto a JSON o Excel, o marca Incluir archivos multimedia para obtener un paquete ZIP con las imágenes, las texturas y las mallas.
  • Importa JSON, Excel o paquetes ZIP. Cada importación empieza con una vista previa, así revisas los cambios y los errores fila a fila antes de que se confirme nada.
Importación desde Google SheetsImporta activos, variantes y ajustes del proyecto desde una hoja de cálculo nativa de Google.
  • Crea una hoja de cálculo nativa de Google (no un .xlsx subido) con una hoja de trabajo por tipo de entidad: Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
  • Añade los encabezados de columna exactos en la primera fila de cada hoja de trabajo (distinguen mayúsculas y minúsculas). Por ejemplo, la hoja Variants necesita: slug, name, asset_slug, rarity, release, currency, price, description, tags.
  • Las entidades se importan en orden de dependencia: Currencies, Rarities, Releases, Tags, Categories, Assets y, por último, Variants. Todo lo que referencie una fila debe existir ya en el proyecto o aparecer antes en la misma ejecución.
  • En tu proyecto, abre la página Intercambio de datos (Importar / Exportar en el menú del proyecto), elige Hoja de Google como origen de la importación y conecta tu cuenta de Google. PolyDrobe pide el ámbito drive.file de Google, así que solo puede leer los archivos que le entregues.
  • En Crear un perfil, ponle una etiqueta al perfil, pulsa Examinar para elegir tu hoja de cálculo en el Selector de Google, ajusta los nombres de las hojas de trabajo si tus pestañas se llaman de otra forma y pulsa Guardar perfil.
  • Lanza primero Vista previa sobre el perfil guardado. Es una ejecución de prueba que informa de los errores de validación sin escribir nada; Importar aplica esa misma ejecución de verdad.
  • Para las etiquetas de Assets o Variants, usa valores separados por punto y coma: starter;seasonal=winter;limited-edition.
  • Los precios admiten punto y coma como separador decimal (9.99 o 9,99). La rareza se busca por nombre, la moneda por código y el lanzamiento por su cadena de versión.

Guías para desarrolladores

Conecta tus herramientas, agentes y pipelines con PolyDrobe.

Configuración de la API RESTIntégrate con PolyDrobe mediante la API REST estándar. Disponible en el plan Pro.

1. Genera un token de acceso

Ve a Ajustes del espacio de trabajo > Tokens de API y crea un token de acceso personal. Ponle un nombre descriptivo (por ejemplo, «CI Pipeline» o «Script local»), selecciona los ámbitos de lectura y escritura y elige un periodo de caducidad. Copia el token cuando aparezca, porque solo se muestra una vez.

# 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. Autentica las peticiones

Incluye el token como Bearer token en la cabecera Authorization de cada petición.

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

3. Lista tus proyectos

Devuelve todos los proyectos de los que eres miembro. La respuesta usa el formato de envoltorio estándar, con las claves data y 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. Crea un activo

Crea un activo dentro de un proyecto. Requiere el rol Editor o Propietario. El slug se genera automáticamente a partir del nombre.

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. Crea una variante

Añade una variante a un activo con precio, rareza y estado. Todas las referencias a otras entidades usan 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. Busca activos

Búsqueda de texto completo en activos y variantes con el buscador de PostgreSQL. Admite frases, OR y negación.

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

7. Operaciones masivas

Actualiza o elimina varias variantes a la vez. Requiere la capacidad Operaciones masivas, del plan 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/

Endpoints disponibles

La API REST llega a todos los recursos de proyecto que guarda PolyDrobe, desde el catálogo en sí hasta los archivos multimedia, las ediciones masivas, el registro de actividad y los webhooks. Los grupos que aparecen abajo son el conjunto completo. Todos los recursos usan URLs basadas en slug.

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}/
Configuración del servidor MCPConecta asistentes de IA (Claude, ChatGPT) con PolyDrobe mediante el Model Context Protocol. Disponible en el plan Pro.

1. Genera un token de acceso personal

Ve a Ajustes del espacio de trabajo > Tokens de API y crea un token nuevo. Ponle el nombre de tu cliente de IA (por ejemplo, «Claude Desktop» o «Claude Code»). Selecciona los ámbitos de lectura y escritura y elige una caducidad larga (1 año o sin caducidad). Copia el token cuando aparezca, porque solo se muestra una vez.

# 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. Conecta Claude Desktop

Añade el servidor MCP de PolyDrobe a la configuración de Claude Desktop. Abre claude_desktop_config.json y añade esta entrada.

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

3. Conecta Claude Code

Añade el servidor MCP desde el terminal con la CLI de Claude Code.

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

4. Desarrollo local (modo stdio)

Para el desarrollo local, ejecuta el servidor MCP directamente sobre stdio, sin HTTP. Así queda autenticado de antemano como el usuario que indiques.

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. Pruébalo

Una vez conectado, pregunta a tu asistente de IA en lenguaje natural sobre los datos de tu proyecto.

# 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"

Herramientas MCP disponibles

Cada operación de lectura, escritura, búsqueda y exportación de PolyDrobe se expone como una herramienta. El asistente de IA descubre el conjunto entero al conectarse, agrupado por categoría y sin nada que configurar.

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 en producción (avanzado)

Para pipelines de CI/CD e integraciones entre servidores, puedes usar el flujo de credenciales de cliente de OAuth 2.1 en lugar de tokens personales. Escribe a soporte para configurar una aplicación OAuth.

# 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.

Quién puede hacer qué

Tres roles, trazados según lo que cada persona necesita cambiar. Los espectadores siguen siendo gratis.

Propietario

Gestiona configuración del proyecto, límites del plan y acceso del equipo.

  • Configuración del proyecto
  • Facturación
  • Gestión de equipo
  • Crear o editar assets
  • Importar y exportar
  • Navegación de solo lectura
Asiento de pago

Editor

Crea y actualiza activos, variantes y datos operativos.

  • Configuración del proyecto
  • Facturación
  • Gestión de equipo
  • Crear o editar assets
  • Importar y exportar
  • Navegación de solo lectura
Asiento de pago

Espectador

Consulta datos del proyecto para revisión, QA o visibilidad de stakeholders.

  • Configuración del proyecto
  • Facturación
  • Gestión de equipo
  • Crear o editar assets
  • Importar y exportar
  • Navegación de solo lectura
Asiento gratuito

Preguntas frecuentes

¿Qué es PolyDrobe?
PolyDrobe es una plataforma de gestión de activos de videojuego para documentar, versionar y colaborar en activos de indumentaria: skins, cosméticos y accesorios de un proyecto de juego. Te da una base de datos estructurada y con búsqueda en lugar de las hojas de cálculo con las que empieza la mayoría de los equipos.
¿Qué tipos de activos gestiona PolyDrobe?
PolyDrobe está pensado para indumentaria y objetos cosméticos de videojuego: skins de personaje, atuendos, accesorios, armas y cualquier objeto con varias variantes visuales. Cada activo puede tener varias variantes que representen combinaciones de color, niveles de calidad o versiones de temporada.
¿PolyDrobe permite previsualizar modelos 3D?
Sí. PolyDrobe incluye un visor de modelos 3D integrado que renderiza archivos .glb y .gltf directamente en el navegador. Puedes adjuntar mallas a los activos y texturas a las variantes, y verlas sin salir de la aplicación.
¿En qué se diferencia PolyDrobe de Google Sheets para el seguimiento de activos de videojuego?
Google Sheets no tiene tipos de datos estructurados, control de versiones, gestión de roles ni tratamiento de archivos multimedia. PolyDrobe te da campos dedicados para rareza, estado, precio, versión de lanzamiento y etiquetas, guarda las miniaturas y los modelos 3D en el propio registro y aplica un acceso basado en roles.
¿En qué se diferencia PolyDrobe de Notion o Airtable?
Notion y Airtable son herramientas de base de datos genéricas: el esquema de activos de videojuego lo construyes tú. PolyDrobe ya lo trae hecho, con jerarquía de activo y variante, visor de modelos 3D, gestión de texturas, estados de pipeline, niveles de rareza y versionado de lanzamientos.
¿Con qué motores de videojuego es compatible PolyDrobe?
PolyDrobe es independiente del motor. Documenta y coordina el catálogo mientras tu motor ejecuta el juego, así que los equipos que trabajan con Unity, Unreal Engine, Godot o un motor propio lo usan igual. La exportación a JSON y Excel y el servidor MCP llevan los datos hasta tu pipeline.
¿Pueden los agentes de IA interactuar con PolyDrobe?
Sí. PolyDrobe tiene un servidor Model Context Protocol (MCP) en https://polydrobe.app/mcp. Cada operación de lectura, escritura, búsqueda y exportación se expone como una herramienta. Asistentes de IA como Claude y ChatGPT se conectan con un Bearer token y, a partir de ahí, listan proyectos, gestionan activos, variantes, packs y colecciones, configuran clasificaciones, asignan etiquetas, actualizan entradas en masa y buscan en la base de datos en lenguaje natural. Consulta la sección Guías para desarrolladores para ver las instrucciones de configuración.
¿Cuál es la diferencia entre la API REST y el servidor MCP?
Ambos llegan a los mismos datos a través de la misma capa de servicio. La API REST usa métodos HTTP estándar (GET, POST, PATCH, DELETE) con envoltorios JSON, lo que encaja con scripts, pipelines de CI/CD e integraciones a medida. El servidor MCP habla Model Context Protocol, así que asistentes de IA como Claude y ChatGPT pueden trabajar con tus datos en lenguaje llano. Ambos requieren un plan Pro y autenticación OAuth2.
¿Cómo consigo un token de acceso a la API?
Ve a Ajustes del espacio de trabajo > Tokens de API y pulsa Crear token. Ponle un nombre, selecciona los ámbitos (lectura, escritura) y elige un periodo de caducidad. Copia el token cuando aparezca, porque solo se muestra una vez. El mismo token sirve para la API REST y para el servidor MCP, y ambos requieren un plan Pro.
¿PolyDrobe admite el trabajo en equipo?
Sí. Los proyectos admiten varios miembros con tres roles: Propietario (control total, incluidas la configuración y la facturación), Editor (puede crear y actualizar activos y variantes) y Espectador (acceso de solo lectura para QA o revisión de stakeholders). Invita a tus compañeros por correo desde Configuración del proyecto.
¿Debo modelar cada skin como activo o variante?
Usa un activo para el ítem base y variantes para cada skin/versión.
¿Cómo mantengo nombres consistentes?
Define convenciones claras y usa URLs con slug para referencias estables.
¿Puedo compartir datos del proyecto externamente?
Sí, en los planes que incluyen Intercambio de datos. Usa la página Intercambio de datos para exportar el proyecto completo a JSON o Excel, o a un paquete ZIP que se lleve también los archivos multimedia, y compártelo con herramientas posteriores, distribuidoras o colaboradores externos.
¿Qué incluye el plan Free?
El plan Free incluye 1 proyecto propio, hasta 3 miembros, 1 GB de almacenamiento por espacio de trabajo, activos ilimitados, 100 variantes por proyecto y 30 días de retención de actividad.
¿Las plazas de Espectador cuentan para la facturación?
No. Solo los roles Propietario y Editor cuentan como plazas facturables. Los Espectadores siguen siendo gratuitos.
¿PolyDrobe es un producto SaaS?
Sí. PolyDrobe es una aplicación SaaS web alojada en polydrobe.app. No hay nada que instalar. Regístrate, crea un proyecto y empieza a añadir activos al momento.
¿Puedo importar a PolyDrobe los datos de activos que ya tengo?
Sí. PolyDrobe importa JSON, Excel (.xlsx), paquetes ZIP que llevan los archivos multimedia junto al de datos, y Google Sheets. Exporta tu hoja de cálculo actual en el formato esperado e impórtala desde la página Intercambio de datos. Cada importación se previsualiza primero: ves el recuento de creaciones, actualizaciones y errores fila a fila antes de confirmar los cambios.
¿Qué columnas necesita la plantilla de importación de Google Sheets?
Cada hoja de trabajo usa columnas concretas. Categories necesita: slug, name, description, parent_slug. Tags necesita: slug, name, value. Rarities necesita: name, color (hexadecimal #RRGGBB), priority. Currencies necesita: code, name, symbol. Releases necesita: version, name, description, release_date (YYYY-MM-DD). Assets necesita: slug, name, description, category_slug, tags. Variants necesita: slug, name, asset_slug, rarity, release, currency, price, description, tags. Los encabezados de columna distinguen mayúsculas y minúsculas y deben estar en la primera fila. La sincronización con Google Sheets cubre esos siete tipos de entidad; los packs y las colecciones se importan subiendo un archivo Excel o JSON.
¿Por qué mi importación de Google Sheets dice «No se pudieron cargar los metadatos de la hoja»?
Lo más probable es que el archivo sea un .xlsx subido y abierto en Google Sheets, y no una hoja de cálculo nativa de Google. Una URL que lleva «rtpof=true» delata un archivo subido. Para arreglarlo, abre el archivo en Google Sheets, elige File > Save as Google Sheets y después pulsa Examinar en tu perfil de sincronización y selecciona el archivo convertido. Comprueba también que la cuenta de Google conectada pueda abrir la hoja de cálculo.
¿Tengo que conectar Google por separado en cada proyecto?
Sí. Cada proyecto necesita su propia conexión con Google para mantener el aislamiento entre inquilinos. Proyectos distintos pueden tener propietarios y controles de acceso distintos. Puedes usar la misma cuenta de Google en todos los proyectos.

Problemas comunes

Soluciones rápidas para los problemas más frecuentes.

Permisos insuficientes

Si una acción no está disponible, revisa tu rol y solicita acceso a un Propietario.

Errores de validación en importación

Verifica campos obligatorios, slugs de categoría y valores enum antes de reintentar.

Problemas al subir medios

Comprueba tipo de archivo, tamaño y uso de almacenamiento frente a tu plan.

Google Sheets: «No se pudieron cargar los metadatos de la hoja»

Lo más probable es que el archivo sea un .xlsx subido y no una hoja de cálculo nativa de Google. Ábrelo, elige File > Save as Google Sheets y después pulsa Examinar en tu perfil de sincronización y selecciona el archivo convertido. Comprueba también que la cuenta de Google conectada pueda abrir la hoja de cálculo.

Google Sheets: Assets o Variants fallan con «no se encontró la etiqueta» o «no se encontró la categoría»

Las entidades referenciadas deben existir antes de que algo pueda apuntar a ellas. El importador recorre las hojas en orden (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), así que una categoría que falló al importarse se lleva por delante sus activos. Lee la vista previa de la ejecución de prueba desde arriba y corrige primero el tipo de entidad más temprano.

Google Sheets: el precio de la variante muestra «precio no válido»

El importador acepta punto (9.99) y coma (9,99) como separador decimal. Si el error sigue, busca caracteres sueltos, símbolos de moneda o espacios en la celda del precio.

Pregúntanos directamente.

Escríbenos un correo y te responde una persona.