Por qué Cursor necesita un sistema de diseño
El Agente de Cursor genera funcionalidades completas rápidamente, pero en cada generación puede tomar decisiones de estilo distintas. Sin un sistema fijo, el espaciado, los colores y las formas de los componentes varían entre archivos. Un sistema de diseño proporciona al Agente un conjunto de tokens semánticos y un DESIGN.md escrito, para que los componentes posteriores sigan las mismas reglas que el primero.
Cursor es compatible con MCP de forma nativa. El Agente puede utilizar herramientas para buscar, obtener y aplicar un kit mientras trabaja, además de leer los archivos que el kit instala.
El kit que instalará
A continuación se muestra el kit gratuito teal-rose-institute-grid renderizado a partir de sus tokens reales. Los comandos de esta guía utilizan ambient-sage; ambos son gratuitos y se instalan de la misma manera:
Teal Rose Institute Grid
Live renderRendered from the kit's actual tokens, fonts, and treatments
Typography
Barlow
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Instalarlo (MCP)
- 1
Escribir la configuración de MCP
Ejecute esto en la raíz de su proyecto para integrar el servidor en
.cursor/mcp.json.npx --yes identityforge@latest install --client cursor - 2
Activar el servidor en Cursor
Abra Customize en la barra lateral, busque el servidor
identityforgey actívelo. Reinicie Cursor si las herramientas no aparecen. - 3
Iniciar sesión (opcional para kits gratuitos)
npx --yes identityforge@latest login - 4
Indique al Agente que aplique el tema a su aplicación
Defina el producto, la audiencia y el tono; el Agente preseleccionará opciones con
search_themes, leerá el brief conget_design_mdy lo aplicará conapply_theme.Use Identity Forge to pick a minimal, warm theme for a wellness app, apply it, and follow the DESIGN.md.
La entrada en `.cursor/mcp.json`
El comando de instalación escribe este servidor stdio. También puede pegarlo manualmente:
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}Refuércelo con una regla de Cursor (opcional)
Para que el Agente sea coherente incluso fuera de un turno de aplicación de kit, añada una regla de proyecto en .cursor/rules/ indicándole que aplique estilos basándose únicamente en los tokens semánticos y que siga el DESIGN.md. Esto complementa bien al kit: los tokens definen los valores y la regla garantiza que el código generado los utilice siempre.
---
description: Keep generated UI on the design system
alwaysApply: true
---
Always style against the semantic design tokens defined in the
project (bg-background, text-foreground, bg-primary, bg-muted,
border-border, …) and follow the rules and motifs in DESIGN.md.
Never hardcode raw hex colors or introduce new fonts.¿Prefiere no usar MCP? Rutas directas
- 1
Aplicación vía CLI
Escribe el DESIGN.md y un archivo de tokens en el directorio actual; pida a Cursor que los vincule.
identityforge apply ambient-sage - 2
Registro de shadcn
Instala las variables CSS del kit directamente si utiliza shadcn/ui.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Consulte la misma configuración para Claude Code y Windsurf, o comience desde la guía fundamental.
Preguntas frecuentes
¿Cómo asigno un sistema de diseño a Cursor?
Ejecuta … identityforge install --client cursor para añadir el servidor MCP de Identity Forge a .cursor/mcp.json. Actívalo desde Customize en la barra lateral y pide al Agent de Cursor que elija y aplique un kit. Escribirá un archivo DESIGN.md y tokens semánticos en el proyecto.
¿Dónde se guarda la configuración?
En .cursor/mcp.json en la raíz de su proyecto. Tras la instalación, active el servidor identityforge en los ajustes de MCP de Cursor.
¿Debería usar también una regla de Cursor?
Ayuda. Una regla .mdc breve en .cursor/rules/ que indique al Agente que aplique estilos basándose únicamente en los design tokens semánticos y que siga el archivo DESIGN.md garantiza que el código generado se mantenga dentro del sistema, incluso cuando no esté aplicando un kit explícitamente.
¿Puedo hacer esto sin MCP?
Sí. identityforge apply <slug> escribe el archivo DESIGN.md y los design tokens en el directorio actual, mientras que npx shadcn add https://identityforge.io/r/<slug>.json instala las variables CSS del kit para proyectos de shadcn/ui.
Fuentes
- Model Context Protocol - Cursor Docs: Cursor lee los servidores MCP del proyecto desde .cursor/mcp.json y permite activarlos o desactivarlos desde Customize en la barra lateral.
- Rules - Cursor Docs: Las reglas del proyecto se encuentran en .cursor/rules como archivos .mdc con frontmatter; cualquier archivo markdown simple en esa ubicación es ignorado por el sistema de reglas.
Fuentes
- Model Context Protocol - Cursor Docs: Cursor lee los servidores MCP del proyecto desde .cursor/mcp.json y permite activarlos o desactivarlos desde Customize en la barra lateral.
- Rules - Cursor Docs: Las reglas del proyecto se encuentran en .cursor/rules como archivos .mdc con frontmatter; cualquier archivo markdown simple en esa ubicación es ignorado por el sistema de reglas.