MCP
MCP
El servidor MCP de DesignerBox permite que un asistente de AI trabaje directamente con tu cuenta de DesignerBox. Pídele a Claude que genere una foto de producto, aplique un template, consulte tu saldo de créditos o extraiga un recurso de tu biblioteca, y sucede en tu cuenta y aparece en la app.
MCP (Model Context Protocol) es un estándar abierto para conectar asistentes de AI con herramientas externas. DesignerBox ejecuta un servidor MCP alojado, por lo que no hay nada que instalar ni nada que auto-hospedar.
URL del servidor
Conecta tu cliente a:
https://mcp.designerbox.ai/api
La ruta es /api, no /mcp. El servidor habla JSON-RPC 2.0 sobre HTTP streamable.
Conecta tu asistente
Los pasos exactos varían según el cliente, pero la forma es siempre la misma: agrega un conector personalizado, pega la URL del servidor e inicia sesión.
Claude (web, Desktop y Cowork)
- Abre Settings, luego Connectors.
- Elige agregar un conector personalizado.
- Pega
https://mcp.designerbox.ai/api. - Completa el inicio de sesión de DesignerBox cuando se abra tu navegador.
- Inicia un chat y pide algo, por ejemplo "lista mis diseños de DesignerBox".
El conector se registra automáticamente, por lo que no hay ID de cliente ni secreto que copiar. Una vez conectado en Claude, la misma conexión está disponible en Cowork.
Cursor y otros clientes MCP
Cualquier cliente compatible con servidores MCP remotos sobre HTTP streamable funciona. Apúntalo a la misma URL. Los clientes que soportan descubrimiento OAuth encontrarán el flujo de inicio de sesión por su cuenta.
Autenticación
DesignerBox MCP usa solo OAuth. Inicias sesión a través de tu navegador, y tu cliente recibe un token con alcance limitado a tu cuenta. No hay ninguna API key que pegar, y las API keys de otras partes de DesignerBox no se aceptan aquí.
El servidor soporta registro dinámico de clientes, por lo que los clientes bien implementados se configuran solos a partir de la URL. Los tokens se emiten con estos scopes:
openid- identifica tu cuenta.mcp:read- lee tus diseños, recursos, templates y plan.mcp:write- genera contenido multimedia y modifica tus datos.offline_access- renueva la sesión para que no inicies sesión cada día.
Tu membresía de equipo se verifica en cada solicitud, por lo que quitar a alguien de un equipo revoca su acceso de inmediato, sin esperar a que expire un token.
Para revisar o revocar un asistente conectado, abre las conexiones MCP en la configuración de tu cuenta en la app. Revocar ahí desconecta ese cliente.
Lo que puede hacer tu asistente
El servidor expone 63 herramientas, 37 de lectura y 26 de escritura. No necesitas aprender sus nombres. Pide lo que quieras en lenguaje natural y el asistente elige la herramienta.
Las áreas principales:
- Generar. Imágenes, video, tomas de cinema studio y personajes de AI.
- Editar. Eliminación de fondo, relighting y ángulos, retoque de piel, virtual try-on, flat lays y anuncios de producto.
- Techniques y templates. Explora el catálogo curado y aplica un template a tus propias imágenes de referencia.
- Biblioteca. Lista y obtén tus diseños, recursos, carpetas y galerías, o sube un nuevo recurso directamente desde el chat.
- Marca. Lee y actualiza tu perfil de marca y tus recursos de marca.
- Workflows. Lista, crea y ejecuta pipelines desde el lienzo.
- Cuenta. Consulta tu plan, saldo de créditos, límites y equipos.
Las herramientas de lectura y de escritura están etiquetadas para que tu asistente sepa qué acciones modifican tu cuenta. La mayoría de los clientes te piden confirmación antes de ejecutar una herramienta de escritura por primera vez.
Prueba con esto
- "Genera una foto de producto de una botella de agua negra mate sobre una superficie de concreto."
- "¿Qué templates tienes para flat lays de moda?"
- "¿Cuántos créditos me quedan este mes?"
- "Elimina el fondo de la última imagen que hiciste."
- "Lista mis diseños de esta semana."
Planes y créditos
Las generaciones gastan créditos del mismo pool mensual que usa la app. No hay una cuota de MCP aparte ni un cargo extra por usar MCP. El plan Free incluye 112 créditos (alrededor de cuatro imágenes con el modelo predeterminado), así que puedes probar la generación antes de mejorar tu plan; cuando los créditos se agotan, las herramientas de generación dejan de funcionar hasta que tu cuota se renueve o mejores tu plan, mientras que las herramientas de lectura siguen funcionando.
El costo de imagen depende del modelo:
| Modelo | Créditos por imagen |
|---|---|
| Seedream 5 | 4 |
| FLUX Pro 1.1 | 5 |
| Nano Banana 2 | 7 |
| FLUX 2 Flex | 7 |
| Nano Banana Pro | 14 |
| GPT Image 2 | 22 |
Otras operaciones:
| Operación | Créditos |
|---|---|
| Aplicar una técnica a una imagen | El costo por imagen del modelo elegido (14 con el modelo predeterminado) |
| Eliminar el fondo | 3 |
| Cinema studio | 2 por imagen |
| AI character (9 poses) | 25 |
| Video | Tarifa del modelo por segundo, por la duración |
Pídele a tu asistente que liste los modelos de imagen o video si quieres los costos y capacidades actuales sin salir del chat. Consulta Planes, Créditos y Límites para el panorama completo.
Cuánto tardan las cosas
Algunas herramientas terminan en la conversación, otras se ejecutan en segundo plano:
- Las imágenes terminan en el chat. Una generación tarda alrededor de 30 segundos, y el asistente devuelve la imagen cuando está lista.
- El video y los personajes de AI se ejecutan en segundo plano. Recibes una referencia de tarea de inmediato, y el asistente consulta el estado hasta que esté lista. Puedes seguir trabajando, o volver más tarde y preguntar si terminó.
Todo lo que generas se guarda en tu biblioteca de DesignerBox, por lo que está en la app tanto si el chat sigue abierto como si no.
Límites
Las solicitudes tienen límite de velocidad por cuenta. El uso conversacional normal se mantiene holgadamente dentro de los límites. Si un asistente entra en bucle o lanza un lote grande, puede ser limitado brevemente y debería reintentar.
Solución de problemas
El asistente dice que no encuentra el servidor. Verifica que la URL termine en /api. https://mcp.designerbox.ai/mcp no es válida y devuelve no encontrado.
El inicio de sesión funciona pero las herramientas fallan con un error de autorización. Puede que tu token haya sido revocado, o que te hayan quitado del equipo. Vuelve a conectar el conector.
Una generación se detiene y menciona créditos. Tus créditos mensuales se agotaron (el plan Free empieza con 112). Las herramientas de lectura siguen funcionando; para volver a generar, espera a que tu cuota se renueve, compra un paquete de créditos o mejora tu plan. Consulta tu saldo en la app, o pregúntale a tu asistente por tu plan.
El asistente elige la herramienta equivocada. Sé específico sobre el resultado. "Aplica el template de flat lay de lino a esta foto" funciona mejor que "haz esto más bonito".
Relacionado
- API - la API REST, para código en lugar de conversación.
- Planes, Créditos y Límites - cómo las generaciones consumen créditos.
- Workflows y el Lienzo - los pipelines que MCP puede ejecutar.
- Techniques y Templates - el catálogo que tu asistente puede aplicar.