Empezar

Asigne un sistema de diseño a Claude Code

Claude Code escribe código de producción, pero no recuerda su marca entre prompts. Conecte el servidor MCP de Identity Forge para que pueda elegir un kit, escribir los tokens y el DESIGN.md en su repositorio y construir cada pantalla basándose en ellos.

Actualizado 2026-08-03

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 render

Rendered from the kit's actual tokens, fonts, and treatments

Atmospheric BotanicalOverview
Search anything⌘K
AB

Analytics

Revenue overview

See revenue and retention trends alongside account health.

Jan 1 to Jan 30, 2026
Overview
Analytics
Reports
Notifications

Active users

13.1k

2,491 new

+17%

MRR

$29.1k

Net of churn

+10%

Retention

89%

28-day window

+2%

NPS

49

1,204 replies

+3

Revenue

Last 12 months

$29.1k +18.2%

12m30d7d
JanFebMarAprMayJunJulAugSepOctNovDec

Acquisition

Goal completion

On track
78%of goal
Organic48%
Direct31%
Referral21%

Recent transactions

Latest activity across your workspace

View all
CustomerStatusDateAmount
AR

Alex Rivera

Founder & CEO

Paid2 min ago$1,999.00
MO

Mira Okonkwo

Head of Product

Pending1 hour ago$39.00
JF

Jonas Feld

Design Lead

Processing3 hours ago$299.00

Typography

Barlow Condensed + DM Sans

Color system

28 semantic roles, light + dark

Agent outputs

DESIGN.md, CSS, Tailwind, shadcn

Atmospheric Botanical: titulares Barlow Condensed sobre DM Sans, superficies en verde salvia pálido y un acento verde intenso. Cambie el kit y todo el sistema cambiará.

Instalarlo (MCP, recomendado)

  1. 1

    Escribir la configuración de MCP

    Ejecute esto en la raíz de su proyecto. Integra un servidor identityforge en .mcp.json (no sobrescribirá los servidores existentes).

    npx --yes identityforge@latest install --client claude-code
  2. 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. 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. 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 con get_design_md y escribirá el DESIGN.md y los tokens con apply_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"]
    }
  }
}
.mcp.json: la entrada del servidor MCP de identityforge

¿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. 1

    Aplicación vía CLI

    Escribe el DESIGN.md y 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. 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.