Por qué Claude Code necesita un sistema de diseño
Claude Code no mantiene el estado del diseño. Cada prompt comienza de cero, por lo que recurre a los mismos valores predeterminados seguros: Inter, un fondo slate-950, un acento violeta y tarjetas genéricas. Tras construir algunas pantallas, estas empiezan a divergir porque nada fija la apariencia. Un sistema de diseño es ese ancla: un conjunto de design tokens semánticos y un DESIGN.md escrito que el agente consulta en cada tarea, asegurando que la página cinco coincida con la primera.
Claude Code también encaja perfectamente con MCP. Una vez conectado el servidor, el agente no solo recibe archivos estáticos: puede explorar el catálogo, leer el brief completo de un kit y aplicarlo, todo desde su sesión sin salir de la terminal.
El kit que instalará
Aquí tiene el kit gratuito atmospheric-botanical renderizado a partir de sus tokens reales, el mismo tipo de sistema que el agente escribe en su repositorio al aplicar cualquier slug de kit (los comandos aquí utilizan ambient-sage):
Atmospheric Botanical
Live renderRendered from the kit's actual tokens, fonts, and treatments
Typography
Barlow Condensed + DM Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Instalarlo (MCP, recomendado)
- 1
Escribir la configuración de MCP
Ejecute esto en la raíz de su proyecto. Integra un servidor
identityforgeen.mcp.json(no sobrescribirá los servidores existentes).npx --yes identityforge@latest install --client claude-code - 2
Aprobar el servidor
Reinicie para que reconozca el nuevo servidor y confirme que las herramientas están disponibles escribiendo
/mcp: el panel mostrará los servidores conectados y el número de herramientas disponibles. - 3
Iniciar sesión (opcional para kits gratuitos)
Solo es necesario para datos propios, una cuota de API más alta o kits Pro. Utiliza un flujo PKCE de navegador.
npx --yes identityforge@latest login - 4
Solicite una apariencia y deje que el agente la aplique
Indique el producto, la audiencia y el estado de ánimo. El agente preseleccionará opciones con
search_themes, leerá el brief conget_design_mdy escribirá el DESIGN.md y los tokens conapply_theme.Use Identity Forge to pick a calm, trustworthy theme for a fintech dashboard, apply it, and follow the DESIGN.md.
Contenido de `.mcp.json`
El comando de instalación escribe exactamente esto: un único servidor stdio que ejecuta el paquete versionado. También puede añadirlo manualmente:
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}¿Prefiere no usar MCP? Dos rutas directas
Claude Code puede ejecutar comandos de shell, por lo que no necesita estrictamente el servidor MCP. Cualquiera de estas opciones le proporcionará los mismos tokens y el mismo DESIGN.md:
- 1
Aplicación vía CLI
Escribe el
DESIGN.mdy un archivo de tokens en el directorio actual. Indique a Claude que lea el DESIGN.md y vincule los tokens a su capa de estilos.identityforge apply ambient-sage - 2
Registro de shadcn
Si utiliza shadcn/ui, esto instala las variables CSS del kit directamente en el tema de su proyecto.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Un ejemplo real
Con el servidor conectado, solicite: Use Identity Forge to theme this app for a wellness product, calm and minimal. Claude puede llamar a search_themes({ description: "wellness product, calm and minimal" }), elegir ambient-sage, leer su DESIGN.md y ejecutar apply_theme. A continuación, refactorizará los componentes para usar design tokens semánticos como bg-background, text-foreground y bg-primary, siguiendo las reglas del kit para tarjetas, sombras y tipografía de visualización. Las pantallas posteriores heredarán los mismos archivos y reglas.
Siguiente: haga lo mismo en Cursor, lea qué es un DESIGN.md o explore kits por estilo visual para encontrar un slug que se adapte a su producto.
Preguntas frecuentes
¿Cómo le asigno un sistema de diseño a Claude Code?
Ejecuta npx --yes identityforge@latest install --client claude-code para añadir el servidor MCP de Identity Forge a .mcp.json. Reinicia Claude Code y pídele que elija y aplique un kit. El agente escribe un archivo DESIGN.md y tokens semánticos en tu repositorio y los utiliza para desarrollar la interfaz.
¿Dónde se guarda la configuración?
En el archivo .mcp.json en la raíz de su proyecto. El comando de instalación integra el servidor de identityforge en cualquier configuración de MCP existente en lugar de sobrescribirla.
¿Es necesario pagar o iniciar sesión?
No para los kits gratuitos: el servidor MCP, el comando apply de la CLI y el registro de shadcn funcionan sin necesidad de cuenta. Inicie sesión solo para acceder a proyectos propios, obtener más cuota de API o usar kits Pro. Gestione sus claves en /account/api-keys.
¿Puedo usarlo sin MCP?
Sí. identityforge apply <slug> escribe el archivo DESIGN.md y los design tokens en el directorio actual, y npx shadcn add https://identityforge.io/r/<slug>.json instala las variables CSS del kit si utiliza shadcn/ui.
Fuentes
- Model Context Protocol - Documentación de Claude Code: Los servidores MCP con alcance de proyecto se encuentran en .mcp.json en la raíz del proyecto, y Claude Code solicita aprobación antes de utilizarlos; el panel /mcp muestra los servidores conectados y el número de herramientas.
Fuentes
- Model Context Protocol - Claude Code Docs: Los servidores MCP con alcance de proyecto se encuentran en .mcp.json en la raíz del proyecto, y Claude Code solicita aprobación antes de utilizarlos; el panel /mcp muestra los servidores conectados y el número de herramientas.