---
url: "/es/emailify/design/figma-mcp.md"
description: "El contrato exacto de frames, componentes y metadatos que deben seguir los agentes al crear o editar emails de Emailify directamente en Figma."
---

# Usar Emailify con Figma MCP

> El contrato exacto de frames, componentes y metadatos que deben seguir los agentes al crear o editar emails de Emailify directamente en Figma.

Esta página es el contrato de referencia para los agentes que crean o editan emails de Emailify directamente a través de Figma MCP. Sigue los nombres y la estructura al pie de la letra para que Emailify reconozca el resultado y todos los componentes sigan vinculados a su componente principal original.

Los agentes pueden leer la [versión en Markdown de este contrato](/es/emailify/design/figma-mcp.md), más compacta, sin cargar la interfaz de la documentación que la rodea.

> **Note:** Este flujo de trabajo directo en Figma forma parte de AI Designer (BETA). El contrato puede cambiar mientras se mejora la función, así que los agentes deben leer esta página antes de cada flujo de trabajo con MCP.

## Instrucción para el agente {#agent-instruction}

Pega esto en Codex, Claude Code u otro agente con acceso de escritura a Figma:

```text
Read and follow the current Emailify Figma MCP contract at https://docs.hypermatic.com/emailify/design/figma-mcp.md before writing to Figma. Create or edit the email using only linked Emailify component instances. Preserve protected content, component links, and existing instance overrides. For a new email, create a vertical auto-layout frame on the page or inside Figma sections named exactly "✉️ Emailify MCP: [email name]" and include at least one linked Emailify section, wrapper, hero, or code-only custom-code instance. Ordinary images and frame layers may also be direct children and export as images. Never detach Emailify instances. Create a separate sibling frame in the same page or section named exactly "✉️ Emailify MCP Metadata: [same email name]" with TEXT layers named exactly "Subject Line" and "Preheader Text", containing only their corresponding values. Replace the bracketed placeholders with the actual email name. When finished, tell me to open or refresh Emailify.
```

## Contrato del frame del email {#email-frame-contract}

Para cada email nuevo, crea un frame que cumpla todas las reglas siguientes:

| Propiedad | Valor obligatorio |
| --- | --- |
| Nombre | `✉️ Emailify MCP: [email name]` |
| Posición | Directamente en la página de Figma o dentro de secciones de Figma; nunca dentro de un frame o grupo normal |
| Diseño | Auto Layout vertical |
| Hijos directos | Instancias vinculadas de componentes de Emailify, que se pueden combinar con capas visuales normales exportables |
| Raíces de Emailify permitidas | `mj-section`, `mj-wrapper` o `mj-hero`; instancias de código personalizado que solo contengan capas de texto Custom Code de Emailify |
| Contenido | Al menos una instancia válida de un componente de Emailify |

Sustituye `[email name]` por el nombre real. El texto que va después de `✉️ Emailify MCP:` pasa a ser el nombre del email en Emailify y no puede estar vacío.

No desvincules las instancias de Emailify ni recrees su contenido como capas sueltas. Haz los cambios de contenido de los componentes mediante modificaciones de instancia, para que las actualizaciones del sistema de diseño sigan llegando a todos los emails montados. Puedes colocar imágenes, frames, grupos y otras capas visuales normales directamente dentro del frame del email; Emailify los exporta como imágenes, no como contenido de email editable.

## Asunto y preencabezado {#subject-line-and-preheader}

Crea un frame hermano independiente, en la misma página o sección, para los metadatos del email. Su nombre de email debe coincidir exactamente con el del frame del email:

| Propiedad | Valor obligatorio |
| --- | --- |
| Nombre del frame | `✉️ Emailify MCP Metadata: [same email name]` |
| Capa del asunto | Una capa TEXT llamada `Subject Line` que solo contenga el asunto |
| Capa del preencabezado | Una capa TEXT llamada `Preheader Text` que solo contenga el preencabezado |

Mantén este frame de metadatos fuera del frame del email. No añadas etiquetas, prefijos, notas ni textos alternativos a los valores de texto.

Emailify importa cada campo por separado cuando el plugin se abre o se actualiza. Si los metadatos del lienzo no cambian, no sobrescriben las ediciones manuales que hayas hecho después en Emailify. Si el agente cambia un valor de los metadatos en el lienzo, Emailify importa ese campo modificado en la siguiente actualización.

## Editar un email existente {#editing-an-existing-email}

Al actualizar un email que ya sigue este contrato:

- Modifica en su sitio las instancias vinculadas existentes siempre que puedas.
- Mantén vinculados los componentes de Emailify al añadirlos o reordenarlos. Pueden convivir con capas visuales normales, que se exportan como imágenes.
- Conserva el nombre del frame del email y la estructura de Auto Layout vertical.
- Conserva los vínculos de componentes y las modificaciones de instancia existentes, salvo que el brief indique cambiarlos expresamente.
- Nunca cambies, ocultes ni elimines una capa bloqueada o una capa cuyo nombre empiece por `🔒`.
- Conserva los enlaces existentes, salvo que el brief indique una URL de sustitución exacta.
- Actualiza el frame de metadatos correspondiente cuando cambie el asunto o el preencabezado.

## Adopción y validación {#adoption-and-validation}

Cuando el agente termine, abre o actualiza Emailify. Emailify valida el frame candidato antes de aplicar sus metadatos `mj-body` habituales e importar los valores de asunto y preencabezado correspondientes.

Emailify rechaza el frame si está anidado dentro de un frame o grupo normal, está vacío, no está organizado en vertical, contiene una capa que no se puede exportar o no tiene ningún componente vinculado de Emailify de tipo sección, wrapper, hero o código personalizado solo con código. El rechazo es intencionado: los diseños normales de Figma nunca deben convertirse en emails de Emailify por accidente.

## Solución de problemas {#troubleshooting}

| Problema | Qué comprobar |
| --- | --- |
| No se reconoce el email | Confirma el nombre exacto `✉️ Emailify MCP:`, que esté en una página o sección, el Auto Layout vertical y que haya al menos una instancia vinculada de Emailify como hijo directo. |
| Falta el asunto o el preencabezado | Confirma que el frame de metadatos usa el mismo nombre de email y que las capas de texto se llaman exactamente `Subject Line` y `Preheader Text`. |
| Un componente ya no está vinculado | Sustituye las capas desvinculadas o reconstruidas por una instancia del componente principal original de Emailify. |
| Ha cambiado contenido legal o fijo | Bloquea la capa o añade `🔒` al principio de su nombre y, después, restaura el contenido aprobado en el componente principal. |
| Un valor manual de Emailify no ha cambiado | Edita el texto de metadatos correspondiente en el lienzo y vuelve a actualizar Emailify. |

Si las herramientas de escritura de Figma no están disponibles, usa el flujo de trabajo de importación de JSON validado que se describe en [Crear emails con AI Designer](/es/emailify/design/ai-designer).

Los componentes de código personalizado pueden ir directamente entre las secciones del email, por ejemplo para abrir y cerrar lógica condicional de la plantilla. Tanto el componente principal como su instancia deben contener solo una o varias capas de texto Custom Code. Los componentes vacíos, los frames anidados, el texto normal y el contenido visual mixto no sirven. Mantén estos componentes vinculados a sus componentes principales.

Las secciones de Figma pueden contener tus frames de email, incluso con secciones anidadas. Siempre que puedas, mantén cada frame de metadatos junto a su email en la misma sección. Emailify da preferencia a los metadatos correspondientes que estén en el mismo contenedor, aunque se siguen admitiendo los que ya existan en otro lugar de la página. Los frames y grupos normales no son contenedores de email.