Figma MCP
Usa el servidor Figma MCP para implementaciones basadas en Figma. Para detalles de configuración y depuración (variables de entorno, configuración, verificación), consulta references/figma-mcp-config.md.
Reglas de integración de Figma MCP
Estas reglas definen cómo traducir entradas de Figma en código para este proyecto y deben seguirse en cada cambio basado en Figma.
Flujo requerido (no saltar)
- Ejecuta
get_design_contextprimero para obtener la representación estructurada del nodo o nodos exactos. - Si la respuesta es demasiado grande o está truncada, ejecuta
get_metadatapara obtener el mapa de nodos de alto nivel y luego vuelve a obtener solo el nodo o nodos necesarios conget_design_context. - Ejecuta
get_screenshotpara obtener una referencia visual de la variante del nodo que se está implementando. - Solo después de tener tanto
get_design_contextcomoget_screenshot, descarga los activos necesarios y comienza la implementación. - Traduce el resultado (generalmente React + Tailwind) a las convenciones, estilos y framework de este proyecto. Reutiliza los tokens de color, componentes y tipografía del proyecto siempre que sea posible.
- Valida contra Figma para obtener una apariencia y comportamiento 1:1 antes de marcar como completo.
Reglas de implementación
- Trata el resultado de Figma MCP (React + Tailwind) como una representación del diseño y comportamiento, no como un estilo de código final.
- Reemplaza las clases utilitarias de Tailwind con las utilidades/tokens del sistema de diseño del proyecto cuando sea aplicable.
- Reutiliza componentes existentes (por ejemplo, botones, entradas, tipografía, envoltorios de iconos) en lugar de duplicar funcionalidad.
- Usa el sistema de color, la escala tipográfica y los tokens de espaciado del proyecto de manera consistente.
- Respeta los patrones de enrutamiento, gestión de estado y obtención de datos ya adoptados en el repositorio.
- Busca una paridad visual 1:1 con el diseño de Figma. Cuando surjan conflictos, prioriza los tokens del sistema de diseño y ajusta el espaciado o los tamaños mínimamente para igualar los aspectos visuales.
- Valida la interfaz de usuario final contra la captura de pantalla de Figma tanto en apariencia como en comportamiento.
Manejo de activos
- El servidor Figma MCP proporciona un endpoint de activos que puede servir activos de imagen y SVG.
- IMPORTANTE: Si el servidor Figma MCP devuelve una fuente localhost para una imagen o SVG, usa esa fuente de imagen o SVG directamente.
- IMPORTANTE: NO importes o añadas nuevos paquetes de iconos; todos los activos deben estar en la carga útil de Figma.
- IMPORTANTE: NO uses ni crees marcadores de posición si se proporciona una fuente localhost.
Indicaciones basadas en enlaces
- El servidor está basado en enlaces: copia el enlace del marco/capa de Figma y proporciona esa URL al cliente MCP cuando solicites ayuda con la implementación.
- El cliente no puede navegar por la URL pero extrae el ID del nodo del enlace; siempre asegúrate de que el enlace apunte al nodo/variante exacta que deseas.
Referencias
references/figma-mcp-config.md— configuración, verificación, depuración y recordatorios de uso basados en enlaces.references/figma-tools-and-prompts.md— catálogo de herramientas y patrones de indicaciones para seleccionar frameworks/componentes y obtener metadatos.