Por qué Windsurf necesita un sistema de diseño
Cascade construye funcionalidades de extremo a extremo, pero como cualquier agente, decide el estilo de nuevo en cada turno: un color de acento ligeramente distinto aquí, un espaciado nuevo allá, una fuente fresca en la siguiente pantalla. Un sistema de diseño elimina las conjeturas: un conjunto de tokens semánticos y un archivo DESIGN.md escrito que Cascade sigue, para que toda la aplicación parezca un solo producto en lugar de diez prompts distintos.
Windsurf es una instalación manual (por ahora)
El comando identityforge install --client … aún no es compatible con Windsurf. Windsurf acepta la misma estructura estándar de MCP, así que añade el servidor manualmente como se muestra abajo. Las rutas de la CLI y shadcn funcionan sin MCP.
El kit que vas a instalar
Ambient Sage
Live renderRendered from the kit's actual tokens, fonts, and treatments
Dashboard
Welcome back — here's how AmbientSage is performing today.
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
+3Meets growth projections
Survey · n=1,204
Total revenue
Last 12 months
$49.1k+18.2%
Recent sales
You closed 265 deals this month.
Alex Rivera
alex@ambientsage.com
Mira Okonkwo
mira@ambientsage.com
Jonas Feld
jonas@ambientsage.com
Sana Qureshi
sana@ambientsage.com
Theo Lindgren
theo@ambientsage.com
Recent transactions
View all| Customer | Status | Date | Amount |
|---|---|---|---|
AR Alex Rivera Founder & CEO | Paid | 2m ago | $1,999.00 |
MO Mira Okonkwo Head of Product | Pending | 1h ago | $39.00 |
JF Jonas Feld Design Lead | Processing | 3h ago | $299.00 |
SQ Sana Qureshi Engineering Lead | Paid | Yesterday | $99.00 |
TL Theo Lindgren Brand Director | Refunded | 2d ago | $2,400.00 |
Typography
Plus Jakarta Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Instálalo (configuración manual de MCP)
- 1
Abre la configuración MCP de Windsurf
En Windsurf, ve a Settings → Cascade → MCP servers y elige editar la configuración raw (
~/.codeium/windsurf/mcp_config.json). - 2
Añade el servidor identityforge
Pega la siguiente entrada en el objeto
mcpServers(fusiónala junto a cualquier otro servidor existente).{ "mcpServers": { "identityforge": { "command": "npx", "args": ["-y", "identityforge@latest", "mcp"] } } } - 3
Refresca los servidores MCP
En el panel MCP de Cascade, refresca para que se carguen las herramientas de identityforge.
- 4
Pide a Cascade que tematice la app
Indícale el producto, la audiencia y el estilo; usará
search_themes,get_design_mdyapply_theme.Use Identity Forge to pick a clean, editorial theme for a recipe site, apply it, and follow the DESIGN.md.
O sáltate el MCP por completo
Como Windsurf puede ejecutar comandos de terminal, las rutas agnósticas al cliente funcionan sin editar ninguna configuración: Cascade (o tú) solo tiene que ejecutar un comando:
- 1
Aplicar mediante CLI
Escribe DESIGN.md + un archivo de tokens en el directorio actual. Pide a Cascade que lea el DESIGN.md y conecte los tokens.
identityforge apply ambient-sage - 2
Registro de shadcn
Instala las variables CSS del kit directamente para proyectos shadcn/ui.
npx shadcn add https://identityforge.io/r/ambient-sage.json
La guía de Cursor cubre el mismo flujo de MCP con un comando de instalación compatible, y la guía principal enlaza todas las herramientas. Para entender el contenido, lee qué es un DESIGN.md.
Preguntas frecuentes
¿Cómo le doy un sistema de diseño a Windsurf?
Añade el servidor MCP de Identity Forge a ~/.codeium/windsurf/mcp_config.json usando la entrada mcpServers estándar (comando `npx`, args `-y identityforge@latest mcp`), refresca los servidores MCP de Cascade y luego pide a Cascade que elija y aplique un kit. O sáltate el MCP y ejecuta `identityforge apply <slug>`.
¿Existe el comando install --client windsurf?
Todavía no. El comando de instalación de la CLI actualmente es compatible con claude-code, cursor, codex, gemini, vscode, opencode y pi. Windsurf utiliza la misma estructura de MCP, así que debes pegar la configuración del servidor manualmente.
¿Puedo evitar editar archivos de configuración?
Sí. Ejecuta `identityforge apply <slug>` para escribir el DESIGN.md y los tokens en el directorio actual, o `npx shadcn add https://identityforge.io/r/<slug>.json` para proyectos shadcn/ui. Ninguno de los dos requiere una configuración de MCP.