Ta strona to obowiązujący kontrakt dla agentów, którzy tworzą lub edytują e-maile Emailify bezpośrednio w Figmie przez Figma MCP. Przestrzegaj dokładnie podanych nazw i struktury, aby Emailify rozpoznał wynik, a każdy komponent pozostał połączony ze swoim oryginalnym komponentem głównym.

Agenci mogą przeczytać zwięzłą wersję Markdown tego kontraktu bez ładowania otaczającego interfejsu dokumentacji.

Ten przepływ pracy bezpośrednio w Figmie jest częścią AI Designer (BETA). Kontrakt może się zmieniać w miarę rozwoju funkcji, dlatego agenci powinni przeczytać tę stronę przed każdym przepływem pracy z MCP.

Instrukcja dla agenta

Wklej to do Codex, Claude Code lub innego agenta z uprawnieniami do zapisu w Figmie:

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.

Kontrakt ramki e-maila

Dla każdego nowego e-maila utwórz jedną ramkę, która spełnia wszystkie poniższe zasady:

Właściwość	Wymagana wartość
Nazwa	✉️ Emailify MCP: [email name]
Położenie	Bezpośrednio na stronie w Figmie lub w sekcjach Figmy; nigdy w zwykłej ramce ani grupie
Układ	Pionowy Auto Layout
Bezpośrednie elementy podrzędne	Połączone instancje komponentów Emailify, opcjonalnie razem ze zwykłymi warstwami wizualnymi, które da się wyeksportować
Dozwolone elementy główne Emailify	mj-section, mj-wrapper lub mj-hero; instancje kodu niestandardowego zawierające wyłącznie warstwy tekstowe Emailify Custom Code
Zawartość	Co najmniej jedna poprawna instancja komponentu Emailify

Zastąp [email name] rzeczywistą nazwą. Tekst po ✉️ Emailify MCP: staje się nazwą e-maila w Emailify i nie może być pusty.

Nie odłączaj instancji Emailify ani nie odtwarzaj ich zawartości jako zwykłych warstw. Zmieniaj treść komponentów przez nadpisania instancji, aby aktualizacje systemu projektowego nadal docierały do każdego złożonego e-maila. Zwykłe obrazy, ramki, grupy i inne warstwy wizualne możesz umieścić bezpośrednio w ramce e-maila; Emailify eksportuje je jako obrazy, a nie jako edytowalną treść e-maila.

Temat i preheader

Utwórz osobną ramkę na tym samym poziomie, na tej samej stronie lub w tej samej sekcji, na metadane e-maila. Nazwa e-maila w tej ramce musi dokładnie odpowiadać ramce e-maila:

Właściwość	Wymagana wartość
Nazwa ramki	✉️ Emailify MCP Metadata: [same email name]
Warstwa tematu	Warstwa TEXT o nazwie Subject Line zawierająca wyłącznie temat
Warstwa preheadera	Warstwa TEXT o nazwie Preheader Text zawierająca wyłącznie preheader

Trzymaj tę ramkę metadanych poza ramką e-maila. Nie dodawaj do wartości tekstowych etykiet, prefiksów, notatek ani alternatywnych wersji tekstu.

Emailify importuje każde pole niezależnie przy otwarciu lub odświeżeniu wtyczki. Niezmienione metadane na płótnie nie nadpisują późniejszych ręcznych zmian wprowadzonych w Emailify. Jeśli agent zmieni wartość metadanych na płótnie, Emailify zaimportuje to zmienione pole przy następnym odświeżeniu.

Edycja istniejącego e-maila

Gdy aktualizujesz e-mail, który już spełnia ten kontrakt:

• W miarę możliwości modyfikuj istniejące połączone instancje na miejscu.
• Przy dodawaniu lub zmienianiu kolejności komponentów Emailify zachowaj ich połączenie. Zwykłe warstwy wizualne mogą z nimi współistnieć i eksportują się jako obrazy.
• Zachowaj nazwę ramki e-maila i strukturę pionowego Auto Layout.
• Zachowaj istniejące połączenia komponentów i nadpisania instancji, chyba że brief wyraźnie je zmienia.
• Nigdy nie zmieniaj, nie ukrywaj ani nie usuwaj zablokowanej warstwy ani warstwy, której nazwa zaczyna się od 🔒.
• Zachowaj istniejące linki, chyba że brief podaje dokładny adres URL do zastąpienia.
• Gdy zmienia się temat lub preheader, zaktualizuj odpowiadającą ramkę metadanych.

Przyjęcie i walidacja

Gdy agent skończy, otwórz lub odśwież Emailify. Emailify sprawdza ramkę kandydującą, zanim zastosuje swoje standardowe metadane mj-body i zaimportuje pasujące wartości tematu i preheadera.

Emailify odrzuca ramkę, jeśli jest zagnieżdżona w zwykłej ramce lub grupie, jest pusta, nie ma układu pionowego, zawiera warstwę, której nie da się wyeksportować, albo nie zawiera żadnego połączonego komponentu Emailify typu section, wrapper, hero ani komponentu zawierającego wyłącznie kod niestandardowy. Odrzucenie jest celowe: zwykłe układy z Figmy nigdy nie powinny przypadkiem zamienić się w e-maile Emailify.

Rozwiązywanie problemów

Problem	Co sprawdzić
E-mail nie jest rozpoznawany	Sprawdź dokładną nazwę ✉️ Emailify MCP:, położenie na stronie lub w sekcji, pionowy Auto Layout i co najmniej jedną połączoną instancję Emailify jako bezpośredni element podrzędny.
Brakuje tematu lub preheadera	Sprawdź, czy ramka metadanych używa tej samej nazwy e-maila, a warstwy tekstowe nazywają się dokładnie Subject Line i Preheader Text.
Komponent nie jest już połączony	Zastąp odłączone lub przebudowane warstwy instancją oryginalnego komponentu głównego Emailify.
Zmieniła się treść prawna lub stała	Zablokuj warstwę albo dodaj na początku jej nazwy 🔒, a następnie przywróć zatwierdzoną treść w komponencie głównym.
Ręcznie ustawiona wartość w Emailify się nie zmieniła	Edytuj odpowiedni tekst metadanych na płótnie, a następnie ponownie odśwież Emailify.

Gdy narzędzia do zapisu w Figmie są niedostępne, użyj zweryfikowanej metody importu JSON opisanego w artykule Tworzenie e-maili z AI Designer.

Komponenty kodu niestandardowego mogą znajdować się bezpośrednio między sekcjami e-maila, na przykład aby otworzyć i zamknąć warunkową logikę szablonu. Zarówno komponent główny, jak i jego instancja muszą zawierać wyłącznie jedną lub więcej warstw tekstowych Custom Code. Puste komponenty, zagnieżdżone ramki, zwykły tekst i mieszana treść wizualna się nie kwalifikują. Zachowaj połączenie tych komponentów z ich komponentami głównymi.

Sekcje Figmy mogą zawierać Twoje ramki e-maili, także w sekcjach zagnieżdżonych. W miarę możliwości trzymaj każdą ramkę metadanych obok jej e-maila w tej samej sekcji. Emailify preferuje pasujące metadane w tym samym kontenerze, ale nadal obsługuje istniejące pasujące metadane w innym miejscu strony. Zwykłe ramki i grupy nie są kontenerami e-maili.