Docs/Guía

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 tu agente, en el orden en que conviene probarlas:

  1. Copia un enlacesin instalar nada; funciona en cualquier IA capaz de abrir un enlace: Claude, ChatGPT, Gemini, WorkBuddy, Qoder, DeepSeek o Kimi. Empieza aquí.
  2. Conectar por MCPuna configuración única en los clientes compatibles; después tu agente busca y aplica estilos sin salir del chat.
  3. Descargarobtén el DESIGN.md del estilo desde su página y entrégalo como archivo.
i
Explorar es gratis. Buscar, filtrar y leer metadatos nunca consume créditos; solo gastas uno al desbloquear la especificación completa de un estilo.

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.

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

Un enlace lleva un estilo; MCP conecta la biblioteca entera: tu agente la busca, la lee y aplica estilos sin salir de la conversación. A cambio exige una configuración inicial y solo funciona en clientes compatibles con MCP. Si te basta con pegar un enlace cada vez, con la sección anterior tienes suficiente.

Una sola URL de servidor, un inicio de sesión con OAuth y ninguna clave de API.

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

i
Funciona con todos los planes. Una cuenta gratuita se conecta y desbloquea estilos gratuitos dentro de su cuota; ProMax desbloquean todos los estilos. MCP usa el mismo límite que la web: no permite eludir el pago.

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.

DESIGN.md
---
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
i
El ejemplo anterior solo muestra el formato. Los valores exactos de cada estilo vienen en la descarga: los estilos gratuitos se desbloquean dentro de tu cuota; los de pago requieren un plan Pro o Max.

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.

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

~/.cursor/mcp.json
{
  "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.

.vscode/mcp.json
{
  "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:

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

WorkBuddy#

WorkBuddy (Tencent) lee un enlace pegado directamente en el chat: pégalo junto con lo que quieras rediseñar y listo, sin configurar nada. Es la vía recomendada. Ver los pasos del enlace

Por MCP Experimental

Abre 插件 (Complementos) en la barra lateral, pulsa MCP 服务器 (Servidores MCP) arriba a la derecha y luego 配置 MCP (Configurar MCP) para añadir el servidor. Guarda y actívalo en la lista de conectores para autorizarlo.

json
{
  "mcpServers": {
    "curio": { "url": "https://mcp.designbycurio.com/mcp" }
  }
}

Los ejemplos de MCP de WorkBuddy son servidores locales con command, mientras que Curio es un servidor remoto con OAuth y no emite ningún token que pegar, así que que el enlace se complete depende de tu versión. Si te pide un token, usa el enlace para compartir.

Qoder#

Qoder (Alibaba) también acepta un enlace pegado en el chat: la forma más rápida de probar un estilo. Ver los pasos del enlace

Por MCP

Pulsa el icono de usuario arriba a la derecha, abre Qoder 设置 (Ajustes), elige MCP en el panel izquierdo y ve a 我的服务 (Mis servicios) → + 添加 (Añadir) para pegar la configuración. Qoder detecta streamable HTTP a partir de la URL, así que no hace falta el campo type.

json
{
  "mcpServers": {
    "curio": { "url": "https://mcp.designbycurio.com/mcp" }
  }
}

Cuando el icono de enlace indique que el servicio está listo, despliégalo para ver las herramientas de Curio. Si tu versión no completa el inicio de sesión con OAuth, vuelve al enlace para compartir.

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.

HerramientaQué haceCosto
search_stylesBusca por palabra, color, época o usoFree
list_stylesLista el catálogoFree
get_styleMetadatos y vista previa de un estiloFree
get_style_specEspecificación completa; los estilos de pago requieren Pro/Max1 crédito
get_quotaCuota restante en la ventana actualFree

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.

© 2026 Curio Design