Por qué Windsurf necesita un sistema de diseño
Cascade desarrolla funcionalidades de extremo a extremo, pero, como cualquier agente de código, redefine el estilo en cada turno: un color de acento ligeramente distinto aquí, un espaciado nuevo allá, una fuente diferente en la siguiente pantalla. Un sistema de diseño elimina las conjeturas: un conjunto de tokens semánticos y un DESIGN.md escrito que Cascade sigue, para que toda la aplicación parezca un único producto en lugar de diez prompts distintos.
Windsurf requiere 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, por lo que debe añadir el servidor a mano como se muestra a continuación. Las rutas de la CLI y de shadcn funcionan sin MCP.
El kit que instalará
Terrain Vivant
Live renderRendered from the kit's actual tokens, fonts, and treatments
Typography
Space Mono
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Instálelo (configuración manual de MCP)
- 1
Abra la configuración MCP de Windsurf
Abra el menú de ajustes (denominado Devin Settings desde que Windsurf se integró en Cognition), vaya a Cascade > MCP Servers y elija editar la configuración raw (
~/.codeium/windsurf/mcp_config.json). - 2
Añada el servidor de identityforge
Pegue la siguiente entrada en el objeto
mcpServers(integrela junto a cualquier servidor ya existente).{ "mcpServers": { "identityforge": { "command": "npx", "args": ["-y", "identityforge@latest", "mcp"] } } } - 3
Actualice los servidores MCP
Vuelva al panel MCP de Cascade y actualice para que se carguen las herramientas de identityforge.
- 4
Pida a Cascade que aplique el tema a la aplicación
Indique el producto, la audiencia y el tono; el agente utilizará
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.
Windsurf ahora forma parte de Devin
Cognition adquirió Windsurf y su documentación se trasladó a docs.devin.ai, donde este flujo de MCP está documentado para el agente Cascade (marcado allí como el agente legacy). La ruta de configuración y la estructura de mcpServers no han cambiado, por lo que la configuración anterior sigue funcionando; es probable que las etiquetas de la interfaz sigan cambiando hacia la marca Devin.
O prescinda totalmente de MCP
Dado que Windsurf puede ejecutar comandos de terminal, las rutas independientes del cliente funcionan sin editar la configuración: Cascade (o usted) solo tiene que ejecutar un comando:
- 1
Aplicación vía CLI
Escribe el archivo DESIGN.md y un archivo de tokens en el directorio actual. Pida a Cascade que lea el DESIGN.md e integre los tokens.
identityforge apply ambient-sage - 2
registro de shadcn
Instala las variables CSS del kit directamente para proyectos de 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 fundamental enlaza todas las herramientas. Para entender el contenido, lea qué es un DESIGN.md.
Preguntas frecuentes
¿Cómo asigno un sistema de diseño a Windsurf?
Añade el servidor MCP de Identity Forge a ~/.codeium/windsurf/mcp_config.json mediante la entrada mcpServers estándar (comando npx, argumentos -y identityforge@latest mcp). Actualiza los servidores MCP de Cascade y pídele que elija y aplique un kit. También puedes prescindir de MCP y ejecutar identityforge apply <slug>.
¿Existe un 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, por lo que debe pegar la configuración del servidor manualmente.
¿Puedo evitar la edición de archivos de configuración?
Sí. Ejecute identityforge apply <slug> para escribir el archivo DESIGN.md y los tokens en el directorio actual, o npx shadcn add https://identityforge.io/r/<slug>.json para proyectos de shadcn/ui. Ninguno de los dos requiere una configuración de MCP.
Fuentes
- Cascade MCP - Devin Docs: la documentación de Windsurf ahora se encuentra en docs.devin.ai; los servidores MCP para el agente Cascade se configuran en ~/.codeium/windsurf/mcp_config.json a través de Devin Settings > Cascade > MCP Servers.
Fuentes
- Cascade MCP - Devin Docs: La documentación de Windsurf ahora se encuentra en docs.devin.ai; los servidores MCP para el agente Cascade se configuran en ~/.codeium/windsurf/mcp_config.json a través de Devin Settings > Cascade > MCP Servers.