Figwright: servidor MCP bidireccional de Figma para agentes de programaciónArtículo · digest del 3 de noviembre
Espacio de trabajo de un desarrollador frontend con ventanas abiertas de Figma y la terminal del servidor MCP bajo la luz suave de una lámpara nocturna.
Artículo5 secciones≈ 8 min

Figwright: servidor MCP bidireccional de Figma para agentes de programación

Si has intentado conectar agentes de programación modernos en consola —ya sea Cursor, Claude Code, Cline o Windsurf— a un diseño de interfaz real, seguro que te has topado con un muro financiero incómodo. El plugin oficial de Figma para el protocolo Model Context Protocol (MCP) está atado de pies y manos a la suscripción de pago Dev Mode. Para un desarrollador humano, veinticinco dólares al mes es un gasto laboral comprensible. Pero cuando en un proyecto corren cinco bots en segundo plano probando variantes de maquetación, pagar un puesto separado por cada asistente virtual se vuelve una auténtica locura.

A mí siempre me ha molestado la naturaleza unidireccional de las integraciones existentes. La mayoría de las utilidades solo saben exportar una imagen o extraer CSS en bruto. Pero un verdadero diálogo de ingeniería requiere retroalimentación: si un componente no encaja en la cuadrícula de Tailwind o necesita una reestructuración responsiva, el agente debe poder mover el frame o cambiar el tema directamente en el archivo de diseño.

Precisamente esa tarea resuelve Figwright, un proyecto totalmente abierto bajo licencia MIT creado por el desarrollador con el alias awdr74100. Construye un puente bidireccional entre Figma y los agentes de programación mediante el protocolo abierto MCP, sin exigir ni un centavo por licencias Dev Mode y funcionando en el plan gratuito Starter.

Puente WebSocket local en lugar de licencias en la nube

Desmontemos la arquitectura de esta integración pieza por pieza. ¿Cómo logra Figwright sortear las limitaciones de la API cerrada en la nube de Figma sin infringir las reglas de la plataforma?

El secreto está en dividir el sistema en dos eslabones independientes:

  1. Proceso local del servidor MCP: el paquete @figwright/mcp, que se ejecuta en la máquina del desarrollador mediante Node.js. Se comunica con el entorno de desarrollo (Cursor o Claude Code) a través de los flujos estándar de entrada y salida (stdio) usando el protocolo JSON-RPC.
  2. Plugin para la aplicación de escritorio de Figma: una extensión ligera en Vue 3 que se ejecuta en un entorno aislado (sandbox iframe) dentro del propio editor.

Entre sí, estos dos componentes se comunican mediante un servidor WebSocket local en la dirección 127.0.0.1:3055. Para que los árboles de diseño pesados con jerarquías de capas complejas no conviertan la transmisión de datos en una presentación de diapositivas, el intercambio va empaquetado en el formato binario compacto MessagePack (msgpack).

Desde el punto de vista de la seguridad, todo está limpio: los datos de los diseños nunca salen de tu ordenador ni se filtran a proxies externos en la nube. El servidor valida la cabecera Host: 127.0.0.1 y comprueba estrictamente el identificador de origen Origin, bloqueando intentos de ataque de tipo DNS-rebinding desde pestañas abiertas del navegador.

135 herramientas: de la inspección de estilos al dibujo vectorial

La mayoría de los servidores MCP de terceros se limitan a un par de comandos banales como «haz una captura de pantalla» o «devuelve el texto del nodo». En Figwright, los desarrolladores han incluido un impresionante arsenal de 135 herramientas especializadas, divididas en tres grupos funcionales:

  • Grupo de lectura (Read): el agente puede solicitar no solo una captura de pantalla, sino el árbol sintáctico completo del nodo seleccionado, inspeccionar las variables de diseño (Figma Variables), estilos tipográficos, efectos de sombras y redondeos. Incluye herramientas de exportación a PNG, SVG, PDF e incluso renderizado de vista previa de animaciones vectoriales en MP4 y GIF.
  • Grupo de escritura (Write): aquí empieza la verdadera magia. El agente obtiene permiso para crear y modificar nodos en el lienzo. Puede ajustar parámetros de Auto Layout sobre la marcha, cambiar la alineación, generar contornos vectoriales con la herramienta Figma Draw a partir de coordenadas de rutas SVG, modificar etiquetas de texto y alternar modos de tema (Dark Mode / Light Mode).
  • Grupo de vinculación contextual (Grounding): para que el modelo no invente componentes desde cero, las herramientas component_map y token_map vinculan los tokens del diseño con los componentes existentes de tu repositorio frontend (por ejemplo, botones de shadcn/ui o colores de Tailwind). Y la función design_diff compara el estado actual del diseño con la instantánea anterior, evitando regenerar código que no ha cambiado.

Esta combinación transforma al agente de un simple copiador ciego de estilos en un asistente completo de maquetación. Junto con gestores de espacios de trabajo multiagente como la herramienta codeg, de la que hablamos anteriormente, Figwright asume el papel de terminal gráfico.

Coordinación de múltiples agentes y elección de líder

¿Qué ocurre si en tu proyecto trabajan dos o tres agentes al mismo tiempo? Por ejemplo, uno refactoriza el componente de autenticación en Cursor mientras el segundo esboza un panel de control mediante Claude Code en la terminal.

Cada cliente intentará inevitablemente lanzar su propio proceso @figwright/mcp. Si pelearan a ciegas por el puerto 3055, la conexión con el plugin fallaría con el error EADDRINUSE. Los autores de Figwright resolvieron este problema con elegancia mediante un mecanismo de elección de líder (Leader Election).

El primer proceso en arrancar toma el socket y se convierte en el nodo principal (leader). Los procesos posteriores detectan que el puerto está ocupado, pasan a modo seguidor (followers) y redirigen de forma transparente todas las llamadas a herramientas hacia el líder a través del endpoint HTTP local /rpc. Y para que los agentes no se pisen el contexto entre sí ante un clic accidental en la ventana de Figma, existe el comando use_file: el agente queda fijado estrictamente al UUID del documento abierto y consulta únicamente ese archivo, ignorando los cambios de pestaña del usuario.

Configuración del entorno y primer arranque

Para que todo funcione necesitarás Node.js versión 20.19.0+ o 22.12.0+ (las versiones anteriores no soportan el cliente WebSocket nativo con los parámetros requeridos) y la aplicación de escritorio de Figma.

Primero registramos el servidor en el archivo de configuración de tu cliente MCP (por ejemplo, en .mcp.json en la raíz del proyecto para Claude Code o en los ajustes de Cursor):

{
  "mcpServers": {
    "figwright": {
      "command": "npx",
      "args": ["-y", "@figwright/mcp@latest"]
    }
  }
}

Tras configurar el cliente, es necesario conectar el plugin al Figma de escritorio:

  1. Entra en la sección de releases del repositorio oficial del proyecto en GitHub y descarga el archivo comprimido con la compilación lista del plugin.
  2. Descomprime la carpeta en una ubicación cómoda de tu disco.
  3. En la versión de escritorio de Figma abre el menú: Plugins -> Development -> Import plugin from manifest... y selecciona el archivo manifest.json de la carpeta descomprimida.
  4. Ejecuta el plugin desde Plugins -> Development -> Figwright. En la ventana abierta del plugin, el estado de conexión cambiará al marcador verde Connected.

Para que el agente entienda las particularidades de tu stack y no genere HTML abstracto, los desarrolladores han preparado un conjunto de escenarios para agentes (Skills) que se cargan mediante el sistema abierto de distribución de habilidades:

# Instalación de skills especializados de generación de código para React, Vue y Tailwind
npx skills add awdr74100/figwright/skills

Ahora, en el diálogo con el agente basta con escribir: «Comprueba el estado de la conexión con Figma mediante figwright:ping y encuentra todos los campos de entrada de texto en el frame de autenticación». El agente leerá los márgenes exactos, asociará los colores con tu tailwind.config.js y devolverá el componente JSX listo.

Sincronización de versiones del servidor y el manifiesto del plugin

Ten en cuenta que el protocolo de intercambio entre el plugin y el paquete CLI evoluciona muy rápido. Si tras una actualización del paquete @figwright/mcp los comandos de inspección empiezan a devolver un error de incompatibilidad de esquema, descarga sin falta la última release del plugin desde el repositorio y reinícialo en Figma.

Límites de aplicabilidad y escollos

Pese a su evidente comodidad, Figwright tiene particularidades que conviene recordar antes de integrarlo en el flujo de trabajo del equipo.

En primer lugar, el plugin aún no está publicado en el catálogo oficial de Figma Community y requiere importar manualmente el manifiesto de desarrollador. Esto impone una limitación: el diseño debe estar abierto precisamente en el cliente de escritorio instalado de Figma, ya que la versión web en el navegador no tiene acceso directo al puerto local 127.0.0.1:3055 debido a las estrictas políticas de Mixed Content.

En segundo lugar, aunque la herramienta sabe modificar propiedades de capas, las operaciones booleanas compuestas sobre curvas o la importación compleja de iconos vectoriales externos siguen siendo más fiables si se hacen a mano. En cambio, en la maquetación rutinaria de tarjetas, formularios estándar y tablas según un sistema de diseño ya existente, la integración amortiza el tiempo invertido en configurarla literalmente en la primera tarde de trabajo.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3