Dale un sistema de diseño a Claude Code

Claude Code escribe código de producción pero no tiene memoria de tu marca entre prompts. Conecta el servidor MCP de Identity Forge y podrá elegir un kit, escribir los tokens y el archivo DESIGN.md en tu repositorio, y construir cada pantalla basándose en ellos.

Actualizado 2026-07-13

Por qué Claude Code necesita un sistema de diseño

Claude Code no tiene estado respecto al diseño. Cada prompt comienza desde cero, por lo que recurre a los mismos valores predeterminados seguros: Inter, un fondo slate-950, un acento violeta y tarjetas genéricas. Construyes algunas pantallas y empiezan a diferenciarse porque nada fija la apariencia. Un sistema de diseño es ese ancla: un conjunto de tokens semánticos y un archivo DESIGN.md escrito que el agente consulta en cada tarea, para que la página cinco coincida con la página uno.

Claude Code también encaja perfectamente con MCP. Una vez conectado el servidor, el agente no solo recibe archivos estáticos: puede navegar por el catálogo, leer el informe completo de un kit y aplicarlo, todo desde dentro de tu sesión sin que tengas que salir de la terminal.

El kit que vas a instalar

Aquí tienes el kit gratuito ambient-sage renderizado con sus tokens reales: el sistema exacto que el agente escribe en tu repositorio cuando aplica este slug:

Ambient Sage

Live render

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

AmbientSage/Dashboard
Search...⌘K
AS

Dashboard

Welcome back — here's how AmbientSage is performing today.

Jan 1 – Jan 30, 2026
Overview
Analytics
Reports
Notifications

Active users

15.1k

+5%

Trending up this month

vs. previous 30 days

MRR

$49.1k

+3%

Strong recurring growth

Net of churn

Retention

89%

+2%

Engagement above target

Rolling 28-day window

NPS

69

+3

Meets growth projections

Survey · n=1,204

Total revenue

Last 12 months

$49.1k+18.2%

12m30d7d
JanFebMarAprMayJunJulAugSepOctNovDec

Recent sales

You closed 265 deals this month.

AR

Alex Rivera

alex@ambientsage.com

+$1,999.00
MO

Mira Okonkwo

mira@ambientsage.com

+$39.00
JF

Jonas Feld

jonas@ambientsage.com

+$299.00
SQ

Sana Qureshi

sana@ambientsage.com

+$99.00
TL

Theo Lindgren

theo@ambientsage.com

+$2,400.00

Recent transactions

View all
CustomerStatusDateAmount
AR

Alex Rivera

Founder & CEO

Paid2m ago$1,999.00
MO

Mira Okonkwo

Head of Product

Pending1h ago$39.00
JF

Jonas Feld

Design Lead

Processing3h ago$299.00
SQ

Sana Qureshi

Engineering Lead

PaidYesterday$99.00
TL

Theo Lindgren

Brand Director

Refunded2d ago$2,400.00

Typography

Plus Jakarta Sans

Color system

28 semantic roles, light + dark

Agent outputs

DESIGN.md, CSS, Tailwind, shadcn

Ambient Sage: Plus Jakarta Sans, superficies planas de tonos neutros cálidos y un acento amarillo intenso. Cambia el kit y todo el sistema cambiará.

Instálalo (MCP, recomendado)

  1. 1

    Escribe la configuración de MCP

    Ejecuta esto en la raíz de tu proyecto. Fusionará un servidor identityforge en .mcp.json (no sobrescribirá los servidores existentes).

    npx --yes identityforge@latest install --client claude-code
  2. 2

    Reinicia Claude Code

    Reinicia para que detecte el nuevo servidor y luego confirma que las herramientas estén disponibles pidiéndole a Claude /mcp o listando sus herramientas de Identity Forge.

  3. 3

    Inicia 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 a través del navegador.

    npx --yes identityforge@latest login
  4. 4

    Pide un estilo y deja que el agente lo aplique

    Dale el producto, la audiencia y el estado de ánimo. El agente hará una selección con search_themes, leerá el informe con get_design_md y escribirá DESIGN.md + tokens con apply_theme.

    Use Identity Forge to pick a calm, trustworthy theme for a
    fintech dashboard, apply it, and follow the DESIGN.md.

Qué contiene `.mcp.json`

El comando de instalación escribe exactamente esto: un único servidor stdio que ejecuta el paquete versionado. También puedes añadirlo manualmente:

{
  "mcpServers": {
    "identityforge": {
      "command": "npx",
      "args": ["-y", "identityforge@latest", "mcp"]
    }
  }
}
.mcp.json: la entrada del servidor MCP de identityforge

¿Prefieres no usar MCP? Dos rutas directas

Claude Code puede ejecutar comandos de shell, por lo que estrictamente no necesitas el servidor MCP. Cualquiera de estas opciones le proporciona los mismos tokens y el archivo DESIGN.md:

  1. 1

    Aplicación vía CLI

    Escribe DESIGN.md más un archivo de tokens en el directorio actual. Dile a Claude que lea DESIGN.md y conecte los tokens con tu capa de estilos.

    identityforge apply ambient-sage
  2. 2

    Registro de shadcn

    Si usas shadcn/ui, esto instala las variables CSS del kit directamente en el tema de tu proyecto.

    npx shadcn add https://identityforge.io/r/ambient-sage.json

Un ejemplo real

Con el servidor conectado, pregunta: Usa Identity Forge para tematizar esta aplicación para un producto de bienestar, tranquilo y minimalista. Claude puede llamar a search_themes({ description: "wellness product, calm and minimal" }), elegir ambient-sage, leer su DESIGN.md y ejecutar apply_theme. Luego refactoriza los componentes para usar tokens semánticos como bg-background, text-foreground y bg-primary, mientras sigue las reglas del kit para tarjetas, sombras y tipografía. Las pantallas posteriores heredarán los mismos archivos y reglas.

Siguiente paso: haz lo mismo en Cursor, lee qué es un DESIGN.md o explora kits por estilo visual para encontrar un slug que encaje con tu producto.

Preguntas frecuentes

¿Cómo le doy 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 luego pídele que elija y aplique un kit. El agente escribirá un DESIGN.md y tokens semánticos en tu repositorio y construirá basándose en ellos.

¿Dónde se guarda la configuración?

En `.mcp.json` en la raíz de tu proyecto. El comando de instalación fusiona el servidor de identityforge en cualquier configuración MCP existente en lugar de sobrescribirla.

¿Tengo que pagar o iniciar sesión?

No para los kits gratuitos: el servidor MCP, la aplicación por CLI y el registro de shadcn funcionan sin una cuenta. Inicia sesión solo para proyectos propios, obtener más cuota de API o usar kits Pro. Gestiona tus claves en /account/api-keys.

¿Puedo usarlo sin MCP?

Sí. `identityforge apply <slug>` escribe DESIGN.md y tokens en el directorio actual, y `npx shadcn add https://identityforge.io/r/<slug>.json` instala las variables CSS del kit si utilizas shadcn/ui.