Servidor MCP de Figma: configuración con Claude Code, herramientas y skills

Configura el servidor MCP de Figma en Claude Code con el plugin o un único comando manual, autentícate en dos clics y revisa qué herramientas de lectura y escritura expone. Incluye las cinco skills, Code Connect, los límites de uso por tipo de asiento y soluciones a los fallos más comunes.

Servidor MCP de Figma: configuración con Claude Code, herramientas y skills
Cristian Da Conceicao
Fundador de Picasso IA

Pega un enlace de Figma en Claude Code y podrá leer el diseño del frame: la maquetación, los espaciados, los colores y los componentes, antes de escribir una sola línea de código. Esa es toda la propuesta del servidor MCP de Figma, y la configuración requiere dos comandos y un clic en el navegador. Lo demás consiste en elegir bien las herramientas, mantenerse dentro de los límites de uso y darle al agente el contexto suficiente para dejar de inventarse sus propios botones.

Este artículo recorre la configuración exacta, las herramientas que expone el servidor, las skills que Figma incluye para los flujos de escritura, una rutina de frame a código que puedes copiar y los límites que más confunden. Los detalles provienen de la documentación para desarrolladores de Figma tal como está en octubre de 2026, así que consulta esas páginas si un comando se ve distinto en tu equipo.

Qué hace el servidor MCP de Figma

El servidor MCP de Figma es un puente. En un lado está tu archivo de Figma: capas, variables, componentes, tableros de FigJam y recursos de Make. En el otro está un cliente MCP, en este caso Claude Code. Entre ambos, un conjunto de herramientas permite al agente hacer preguntas sobre un diseño y, con los permisos adecuados, modificarlo.

La documentación de Figma describe cinco funciones. El servidor puede crear y modificar contenido nativo de Figma en el lienzo, convertir los frames seleccionados en código, extraer el contexto de diseño como variables, componentes y datos de maquetación, recuperar recursos de los archivos de Make y mantener el código alineado con tu sistema de diseño mediante Code Connect.

Diseñador y desarrolladora revisando la maquetación de un sitio web en un monitor grande dentro de un estudio luminoso

El cambio real está en pasar de las capturas de pantalla a la estructura. Una captura le dice a un modelo cómo es un botón. El contexto de diseño le dice que el botón es una instancia de un componente, que usa una variable de espaciado con nombre y que está en una fila de autolayout con un espacio fijo. El código escrito a partir de esa estructura se acerca mucho más a algo que puedes fusionar.

Servidor remoto o de escritorio

Figma ofrece dos versiones del servidor, y la elección importa porque algunas herramientas solo existen en una de ellas.

Servidor remotoServidor de escritorio
ConexiónEndpoint alojado por Figma, https://mcp.figma.com/mcpLocal, a través de la aplicación de escritorio de Figma
Requiere la aplicación de escritorioNoSí
Selección de herramientasConjunto más amplio, incluidas todas las herramientas exclusivas del remotoConjunto más reducido
Ideal paraLa mayoría de las personasDespliegues de Figma for Government y configuraciones solo locales

Figma considera que el servidor remoto es la mejor opción para la mayoría de los usuarios, y es el que usa el resto de este artículo.

Quién puede usarlo

Necesitas un archivo de Figma Design, Make o FigJam, permiso de visualización o edición sobre él y, idealmente, un asiento Full o Dev. Los demás tipos de asiento también se conectan, pero con una cuota mensual mucho menor (las cifras están en la sección de límites más abajo). Solo pueden conectarse los clientes MCP que aparecen en el catálogo MCP de Figma, y Claude Code tiene su propia página de configuración allí.

Conectarlo a Claude Code

Hay dos caminos y ambos llegan al mismo punto. Elige el plugin si también quieres las skills de Figma, y el comando manual si prefieres una configuración mínima.

La ruta del plugin

claude plugin install figma@claude-plugins-official

Figma recomienda esta opción. El plugin incluye la configuración del servidor MCP y las Agent Skills para los flujos habituales, así que una sola instalación te da el servidor y las instrucciones que hacen que las herramientas de escritura se comporten bien.

Desarrollador escribiendo un comando en una terminal de un equipo portátil junto a wireframes impresos

La ruta manual

claude mcp add --transport http figma https://mcp.figma.com/mcp

Sin una marca de alcance, el servidor se registra solo para el proyecto en el que te encuentras. Si lo quieres disponible en todas partes, añade --scope user:

claude mcp add --scope user --transport http figma https://mcp.figma.com/mcp

El alcance de usuario significa que no tienes que repetir la instalación en cada repositorio.

Autenticarse y verificar

El servidor usa un inicio de sesión en el navegador, así que no se pega nada en un archivo de configuración.

  1. Inicia Claude Code y escribe /mcp.
  2. Selecciona figma.
  3. Selecciona Authenticate.
  4. Se abrirá tu navegador. Haz clic en Allow Access.
  5. De vuelta en la terminal debería aparecer Authentication successful. Connected to figma.

Ejecuta /mcp una vez más para confirmar que el servidor aparece como conectado. Después pide a Claude que llame a la herramienta whoami. Devuelve el usuario autenticado y los planes, lo que te indica de inmediato si tu asiento tiene una cuota utilizable.

💡 Consejo: Si las herramientas desaparecen durante la sesión, /mcp es el primer lugar donde mirar. Muestra el estado de la conexión y te permite volver a autenticarte sin editar archivos.

Las herramientas que obtiene Claude Code

La referencia de herramientas de Figma incluye decenas de ellas. Usarás unas pocas a diario, así que empieza por esas e ignora el resto hasta que una tarea las necesite.

Vista cenital de dos columnas ordenadas de fichas y notas adhesivas sobre un escritorio de roble claro

Herramientas de lectura para el contexto de diseño

HerramientaQué haceSolo remoto
get_design_contextExtrae el contexto de diseño de una capa o selecciónNo
get_metadataDevuelve un esquema XML disperso de una selecciónNo
get_screenshotCaptura una captura de pantalla de una selecciónNo
get_variable_defsRecupera las variables y estilos usados en una selecciónNo
get_code_connect_mapDevuelve la asignación del ID de nodo al componente de códigoNo
get_code_connect_suggestionsSugiere asignaciones de componente a códigoNo
get_context_for_code_connectProporciona metadatos de componentes para plantillasSí
search_design_systemBusca componentes, variables y estilos en las bibliotecasSí
get_librariesLista las bibliotecas de diseño suscritas y disponiblesSí
get_figjamConvierte diagramas de FigJam a XMLNo
get_motion_contextExtrae datos de animaciónNo
download_assetsDescarga exportaciones e imágenes fuente originalesSí

Empieza por get_design_context. Es el motor detrás de "construye este frame". Combínala con get_screenshot para que el agente tenga un objetivo visual, y con get_variable_defs para que los colores y los espaciados provengan de tus tokens en lugar de valores hexadecimales adivinados. Cuando un frame es enorme, get_metadata ofrece un esquema disperso que te sirve para mapear la página antes de extraer el detalle capa por capa.

Herramientas de escritura para el lienzo

HerramientaQué haceSolo remoto
use_figmaHerramienta de uso general para crear, editar e inspeccionarSí
generate_figma_designGenera capas de diseño a partir de interfacesSí
generate_diagramConstruye un diagrama de FigJam a partir de MermaidSí
create_new_fileCrea un archivo vacío de Design, FigJam o SlidesSí
generate_imageGenera una imagen ráster descargableSí
upload_assetsSube imágenes a un archivo de FigmaSí
add_code_connect_mapAsigna un ID de nodo de Figma a un componente de códigoNo
send_code_connect_mappingsConfirma las asignaciones de componentes sugeridasNo

El servidor también incluye herramientas para shaders y plugins generativos, además de seis herramientas weave_* que ejecutan flujos de Weave basados en créditos. La mayor parte del trabajo de front-end nunca las toca. Vale la pena conocer por su nombre un prompt: create_design_system_rules, que genera un archivo de reglas para que el contexto del agente coincida con tu base de código.

Skills que lo hacen fiable

Las herramientas de escritura son potentes y fáciles de usar mal. La documentación de Figma enumera skills que el agente necesita para los flujos correspondientes, y la instalación del plugin las trae consigo. Si elegiste la ruta manual, instala por separado las skills de Figma para tu cliente.

Diseñador fijando muestras de color y especímenes tipográficos en un tablero de corcho con luz de última hora de la tarde

Las cinco skills

SkillSe usa para
figma-useFlujos de trabajo de Figma Design
figma-use-figjamOperaciones de FigJam
figma-use-slidesFigma Slides
figma-shadersCrear y actualizar shaders
figma-generative-pluginsCrear y actualizar plugins generativos

Si tu trabajo consiste sobre todo en leer diseños y escribir código, apenas las notarás. Importan en el momento en que le pides a Claude Code que construya o edite algo dentro de Figma.

Escribe un archivo de reglas del sistema de diseño

Incluso con herramientas perfectas, el agente no conoce tus convenciones. Ejecuta el prompt create_design_system_rules y deja que redacte un archivo de reglas; después recórtalo a lo que tu equipo realmente aplica y guárdalo en CLAUDE.md. Un ejemplo corto:

Figma to code rules:
- Reuse components from src/components/ui before creating new ones.
- Map Figma variables to our CSS tokens. Never hardcode hex values.
- Use the project spacing scale, not the pixel values from the frame.
- Treat Figma output as a reference. Match our file structure and naming.

Cuatro líneas como estas eliminan la mayoría de las quejas del tipo "¿por qué ha vuelto a escribir un botón nuevo?".

De frame a código de componente

Desarrolladora comparando una maqueta móvil impresa con una página terminada en la pantalla de un equipo portátil

El ciclo de frame a código

  1. En Figma, haz clic derecho en el frame y copia el enlace a la selección. El servidor remoto trabaja a partir de enlaces, así que no hace falta tener abierta ninguna aplicación de escritorio.
  2. Dale a Claude Code el enlace junto con una instrucción clara.
  3. Claude llama a get_design_context y, normalmente, también a get_screenshot y get_variable_defs.
  4. Revisa el diff, ejecuta tu servidor de desarrollo y compara el resultado con la captura de pantalla.
  5. Corrige las pequeñas diferencias nombrando la capa, no describiéndola de forma vaga.

Un prompt que funciona bien:

Implement this frame using our existing components and tokens.
Do not add new dependencies. Figma link: <paste link here>

Tras la primera pasada, revisa cuatro cosas en el diff antes de ejecutar nada:

  • Componentes: ¿importó los tuyos o escribió otros nuevos?
  • Tokens: ¿los colores y los espaciados se leen de variables o están escritos a mano?
  • Comportamiento adaptable: un frame muestra un solo ancho, así que pide los breakpoints que de verdad vas a publicar.
  • Estados: los estados hover, focus y disabled suelen estar en variantes separadas, así que nómbralos si los necesitas.

💡 Consejo: Trabaja una sección cada vez. Un frame de página completa genera una montaña de contexto y una montaña de código, y tu cuota de herramientas de lectura se agota más rápido de lo que esperas.

Asignaciones de Code Connect

Manos encajando un bloque de madera en un hueco recortado a medida sobre una maqueta de interfaz de madera

Code Connect es la forma en que Figma sabe que su componente Button es en realidad src/components/ui/Button.tsx. Una vez que existe esa asignación, Claude importa el componente real en lugar de escribir marcado nuevo.

Cuatro herramientas gestionan el ciclo. get_code_connect_map lee las asignaciones existentes. get_code_connect_suggestions propone nuevas, send_code_connect_mappings confirma las que aceptes, y add_code_connect_map escribe una sola asignación directamente. Esta última está exenta de los límites de uso, lo que resulta útil cuando estás asignando una biblioteca completa.

Límites, asientos y soluciones habituales

Temporizador de cocina y un cuaderno lleno de marcas de conteo junto a un equipo portátil cerrado

Límites de uso por asiento

Estas cifras provienen de la página de límites de uso y acceso de Figma en el momento de redactar este artículo. Figma puede cambiarlas, así que confírmalas en la página antes de planificar un despliegue en el equipo.

Tipo de asientoStarterProfessionalOrganizationEnterprise
View, CollabHasta 20 al mesHasta 20 al mesHasta 20 al mesHasta 20 al mes
Dev, FullHasta 200 al día, 10 por minutoHasta 200 al día, 15 por minutoHasta 600 al día, 20 por minutoNo especificado en la tabla

Los límites se aplican a las herramientas que leen datos de Figma. add_code_connect_map, create_new_file y whoami están exentas.

El asiento determina la experiencia. Una persona diseñadora con asiento View puede conectarse y explorar, pero el flujo de trabajo diario corresponde a las personas desarrolladoras con asiento Full o Dev. Si solo dos personas de tu equipo tienen esos asientos, que sean ellas quienes generen el código, y que el resto revise las pull requests.

💡 Consejo: Si Claude llama a tres herramientas de lectura por frame, las 200 llamadas diarias se agotan rápido. Pide una sección y deja que get_metadata elija la capa correcta antes de extraer el contexto completo.

Tres soluciones para fallos habituales

Las herramientas no aparecen. Ejecuta /mcp. Si figma aparece en la lista pero sin conectar, selecciónalo y vuelve a autenticarte. Si no aparece en absoluto, repite el comando de instalación y reinicia Claude Code.

La salida ignora tus componentes. Es un problema de contexto, no de herramientas. Añade el archivo de reglas a CLAUDE.md, crea asignaciones de Code Connect para tus diez componentes principales e indica al prompt que reutilice los componentes existentes antes de escribir otros nuevos.

Llegas al límite a mitad de tarea. Reduce el alcance, revisa tu asiento con whoami y pasa el trabajo pesado a un asiento Full o Dev. Un asiento View o Collab te da unas 20 llamadas al mes, lo que sirve para una demo, no para un flujo de trabajo.

Rellena los frames con fotos y video de IA

Directora creativa sosteniendo una foto impresa de un lago de montaña junto a un monitor con una maquetación principal

Fotos y clips para las secciones principales

La mayoría de los frames de Figma incluyen rectángulos grises de marcador de posición donde debería ir la fotografía, y el código generado hereda esa falta de vida. Rellénalos con imágenes que parezcan reales antes de la entrega y la construcción tendrá aspecto de terminada desde la primera ejecución.

En PicassoIA, el catálogo de texto a imagen incluye Seedream 5 Pro, GPT Image 2, Flux 2 Pro, Nano Banana Pro y P Image. Genera una foto principal y colócala en el frame a mano, o pídele a Claude que la incorpore con upload_assets. Figma tiene su propia herramienta generate_image, pero un modelo de imagen especializado te da más control sobre la lente, la luz y la composición.

Para el movimiento, convierte la misma imagen fija en un clip corto con un modelo de video como Seedance 2.5 Lite, Wan 3, Veo 3.1 Lite, LTX 2.5 Fast o Kling v3 Video. Revisa la página de cada modelo para ver su opción de entrada de imagen. Un bucle de cinco segundos detrás de un titular suele ser todo lo que necesita una página de aterrizaje.

Usa Claude Sonnet 5 en PicassoIA

La misma plataforma también puede encargarse de pensar. Claude Sonnet 5 funciona en PicassoIA como modelo de texto que lee imágenes, lo que lo convierte en una forma rápida de redactar el archivo de reglas a partir de una captura de tu sistema de diseño.

  1. Abre la página de Claude Sonnet 5.
  2. Adjunta una captura de tu biblioteca de componentes en el campo image.
  3. Pega un prompt como: "Enumera los tokens de espaciado, color y tipografía de esta captura y escríbelos como una lista corta de reglas para un archivo CLAUDE.md".
  4. Ajusta effort. El valor por defecto, low, desactiva el razonamiento para obtener la respuesta más rápida y barata. Usa medium o high cuando la salida deba razonar sobre muchos componentes, y xhigh o max para trabajos complicados con varios archivos.
  5. Deja max tokens en el valor por defecto de 8.192, o bájalo para respuestas cortas.
  6. Añade un system prompt como "Escribes reglas de ingeniería concisas para una base de código de React" para que cada respuesta siga el mismo rol.

💡 Consejo: Un razonamiento más profundo está disponible con Claude Fable 5 y Claude Opus 4.7 en la misma plataforma.

Pruébalo en Picasso IA

Creador sonriente trabajando en un equipo portátil en una mesa de madera de una cafetería junto a una ventana soleada

Ya tienes el ciclo completo. Conecta el servidor, añade un archivo de reglas, construye una sección cada vez y asigna tus componentes con Code Connect para que el resultado siga mejorando.

La parte que es fácil pasar por alto son las imágenes. Una interfaz terminada necesita fotos reales y un poco de movimiento, y Picasso IA te ofrece los modelos para ambas cosas en un mismo lugar. Elige un modelo de imagen, describe la toma principal que quieres y mira cómo cambia el frame que acabas de construir. Después prueba uno de los modelos de video con esa misma foto y compara las dos versiones lado a lado. Abre PicassoIA y crea tu primera imagen principal hoy mismo.

Compartir este artículo

Elige tu idioma