Docs de desarrollo
Curio es una biblioteca de diseño para IA. Explora el catálogo y entrega cualquier estilo a tu agente de tres formas: mediante un enlace compartido, el servidor MCP o un DESIGN.md descargado. Esta guía explica las tres opciones, además de la configuración de cada cliente, las herramientas, el acceso y la facturación.
Resumen#
Cada diseño del catálogo tiene una dirección estable y una especificación completa legible por máquina: color, tipografía, espaciado, formas y movimiento. Apunta tu IA a uno, leerá la especificación y aplicará ese aspecto a lo que estés creando.
Hay tres formas de entregar un estilo a un agente:
- Enlace compartido: un enlace breve, válido durante 15 minutos, que pegas en cualquier agente.
- Servidor MCP: conecta una vez; tu agente busca y aplica estilos desde el chat.
- Descarga: obtén el DESIGN.md de un estilo desde su página.
Inicio rápido#
La vía más rápida: abre la página de un estilo, elige Entregar a mi IA → Copiar enlace y pégalo en tu agente junto con lo que quieras rediseñar.
Restyle this slide deck with the Curio design at:
https://designbycurio.com/i/<token>
Tu agente obtiene la especificación del enlace y rehace el trabajo con ese estilo. El mismo enlace funciona en Claude, Cursor, Codex, Gemini, ChatGPT o cualquier herramienta compatible con MCP. ¿Prefieres una conexión permanente? Conecta por MCP.
Por MCP#
El servidor MCP de Curio da a tu agente acceso directo al catálogo para buscar, leer y aplicar estilos sin salir de la conversación. Una URL de servidor, un solo acceso con OAuth y ninguna clave de API.
https://mcp.designbycurio.com/mcp
Añade esa URL en tu cliente y completa el acceso con OAuth. Los pasos para cada cliente están en Conecta tu cliente, más abajo.
Descargar#
Cada estilo se exporta desde el menú Descargar ▾ de su página como una especificación DESIGN.md, escrita tanto para personas como para agentes.
El archivo DESIGN.md
Un único archivo Markdown: cabecera YAML y después una sección por cada aspecto del diseño. Los valores exactos de los tokens están en el cuerpo; la estructura es esta. ¿No conoces el formato? Lee ¿Qué es un DESIGN.md? para saber más.
--- name: <style name> origin: <place, year> era: <era bucket> --- # <Style name> A short description of the look and the rules behind it. ## Colors # palette + roles ## Typography # families, scale, tracking ## Spacing # the spacing rhythm ## Shapes · Shadows · Motion · Composition
Claude#
Claude Desktop y claude.ai: abre Ajustes → Conectores → Añadir conector personalizado, pega la URL del servidor e inicia sesión cuando se abra la ventana de OAuth. (Las cuentas Free pueden añadir un conector personalizado.)
Claude Code: añade el servidor desde la CLI y ejecuta /mcp en una sesión para completar el acceso con OAuth.
claude mcp add --transport http curio https://mcp.designbycurio.com/mcp
Cursor#
Añade Curio a ~/.cursor/mcp.json (o mediante Ajustes → MCP). Cursor abrirá el navegador para iniciar sesión la primera vez.
{
"mcpServers": {
"curio": { "url": "https://mcp.designbycurio.com/mcp" }
}
}
VS Code (Copilot)#
En el modo agente de Copilot, añade Curio a .vscode/mcp.json (o a tu configuración MCP de usuario). VS Code abrirá el navegador para autorizar la primera conexión.
{
"servers": {
"curio": { "type": "http", "url": "https://mcp.designbycurio.com/mcp" }
}
}
Codex#
La CLI y la extensión del IDE de Codex comparten ~/.codex/config.toml; añade el servidor con un solo comando:
codex mcp add curio --url https://mcp.designbycurio.com/mcp
En la app de escritorio de Codex, conéctalo desde el panel Plugins; añade allí la misma URL del servidor.
ChatGPT#
Los conectores MCP personalizados requieren el modo desarrollador (Plus, Pro, Team o Enterprise; no Free). Actívalo, ve a Ajustes → Conectores → Crear e introduce la URL https://mcp.designbycurio.com/mcp.
Otros clientes#
Funciona cualquier cliente compatible con un servidor MCP remoto de HTTP transmisible y OAuth: dirígelo a https://mcp.designbycurio.com/mcp e inicia sesión.
Antigravity Experimental
Antigravity usa autenticación por encabezado o token al portador para MCP remoto, mientras que Curio usa OAuth puro (sin tokens que pegar). El intercambio OAuth puede no completarse en todas las versiones; si conecta, añade el servidor mediante Gestionar servidores MCP → Ver configuración sin procesar. Si no, usa uno de los clientes OAuth anteriores.
Manus Experimental
Los conectores de Manus suelen esperar un token al portador en el encabezado Authorization, mientras que Curio usa OAuth puro y no emite tokens. Si tu versión admite una conexión MCP OAuth estándar, añade la URL del servidor en los ajustes del conector; de lo contrario, aún no podrás conectar Curio desde Manus.
Apps MCP#
Una vez conectado, tu agente dispone de estas herramientas. Explorar y buscar es gratis; solo obtener una especificación completa consume un crédito.
| Herramienta | Qué hace | Costo |
|---|---|---|
search_styles | Busca por palabra, color, época o uso | Free |
list_styles | Lista el catálogo | Free |
get_style | Metadatos y vista previa de un estilo | Free |
get_style_spec | Especificación completa; los estilos de pago requieren Pro/Max | 1 crédito |
get_quota | Cuota restante en la ventana actual | Free |
Pídelo con naturalidad, por ejemplo: «Busca un estilo Bauhaus y aplícalo a mis diapositivas». Tu agente busca, obtiene la especificación y la aplica.
Acceso y permisos#
OAuth, sin claves de API. Conectarse significa iniciar sesión. Curio usa OAuth estándar con registro dinámico de clientes, por lo que no hay claves ni tokens que crear, pegar o renovar.
Solo lectura. La conexión solo lee la biblioteca de diseño. Nunca toca tus archivos, tu repositorio ni tus datos.
Revoca cuando quieras. Gestiona las aplicaciones en la página de aplicaciones conectadas de tu cuenta; al revocar, el acceso de ese cliente se invalida de inmediato.
Facturación y cuota#
Los enlaces compartidos, las consultas MCP y las descargas usan los mismos créditos y límites. Consulta los planes y precios en precios.
¿Qué cuesta un crédito?
Se gasta un crédito al desbloquear la especificación completa de un estilo: mediante get_style_spec por MCP, una descarga o un enlace generado. Buscar, listar, leer metadatos y usar get_quota es gratis. Si vuelves a desbloquear el mismo estilo en 15 minutos, se reutiliza el mismo crédito.
¿Puede usarlo una cuenta Free?
Sí: conecta, busca y explora toda la biblioteca, y desbloquea estilos gratuitos dentro de tu cuota. Los estilos de pago requieren Pro o Max; intentar desbloquear uno sin plan devuelve el error tier_denied.
¿Qué pasa al agotar la cuota?
El desbloqueo devuelve quota_exhausted. En Pro y Max, tu cuota se repone en una ventana móvil de 7 días; los créditos del plan Free se conceden una sola vez, así que tendrás que mejorar el plan para desbloquear más. Explorar, buscar y leer metadatos seguirá funcionando.