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.
Crear un proyecto
Crea tu primer proyecto y define un slug claro.
Configurar taxonomía
Configura categorías, rarezas, etiquetas, monedas, estados y lanzamientos.
Añadir assets y variantes
Añade activos y luego variantes con imágenes, precios y metadatos opcionales.
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
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
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
Preguntas frecuentes
¿Qué es PolyDrobe?
¿Qué tipos de activos gestiona PolyDrobe?
¿PolyDrobe permite previsualizar modelos 3D?
¿En qué se diferencia PolyDrobe de Google Sheets para el seguimiento de activos de videojuego?
¿En qué se diferencia PolyDrobe de Notion o Airtable?
¿Con qué motores de videojuego es compatible PolyDrobe?
¿Pueden los agentes de IA interactuar con PolyDrobe?
¿Cuál es la diferencia entre la API REST y el servidor MCP?
¿Cómo consigo un token de acceso a la API?
¿PolyDrobe admite el trabajo en equipo?
¿Debo modelar cada skin como activo o variante?
¿Cómo mantengo nombres consistentes?
¿Puedo compartir datos del proyecto externamente?
¿Qué incluye el plan Free?
¿Las plazas de Espectador cuentan para la facturación?
¿PolyDrobe es un producto SaaS?
¿Puedo importar a PolyDrobe los datos de activos que ya tengo?
¿Qué columnas necesita la plantilla de importación de Google Sheets?
¿Por qué mi importación de Google Sheets dice «No se pudieron cargar los metadatos de la hoja»?
¿Tengo que conectar Google por separado en cada proyecto?
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.