Figma MCP
Nutze den Figma MCP Server für Figma-gesteuerte Implementierungen. Informationen zu Einrichtung und Fehlerbehebung (Umgebungsvariablen, Konfiguration, Überprüfung) findest du in references/figma-mcp-config.md.
Figma MCP Integrationsregeln
Diese Regeln legen fest, wie Figma-Inputs in Code für dieses Projekt übersetzt werden und müssen bei jeder Figma-gesteuerten Änderung befolgt werden.
Erforderlicher Ablauf (nicht überspringen)
- Führe zuerst
get_design_contextaus, um die strukturierte Darstellung der genauen Node(s) abzurufen. - Wenn die Antwort zu groß oder abgeschnitten ist, führe
get_metadataaus, um die übergeordnete Node-Übersicht zu erhalten, und hole dann mitget_design_contextnur die benötigte(n) Node(s) erneut ab. - Führe
get_screenshotaus, um eine visuelle Referenz der zu implementierenden Node-Variante zu erhalten. - Erst wenn du sowohl
get_design_contextals auchget_screenshothast, lade die benötigten Assets herunter und beginne mit der Implementierung. - Übersetze die Ausgabe (normalerweise React + Tailwind) in die Konventionen, Stile und das Framework dieses Projekts. Verwende wo immer möglich die Farb-Tokens, Komponenten und Typografie des Projekts.
- Validiere die Implementierung gegen Figma auf 1:1 Aussehen und Verhalten, bevor du sie als abgeschlossen markierst.
Implementierungsregeln
- Behandle die Figma MCP Ausgabe (React + Tailwind) als Darstellung von Design und Verhalten, nicht als endgültigen Codestil.
- Ersetze Tailwind-Utility-Klassen nach Möglichkeit durch die bevorzugten Utilities/Design-System-Tokens des Projekts.
- Verwende bestehende Komponenten (z. B. Buttons, Eingabefelder, Typografie, Icon-Wrapper) erneut, anstatt Funktionalität zu duplizieren.
- Verwende das Farbsystem, die Typografie-Skala und die Abstands-Tokens des Projekts konsistent.
- Respektiere bestehende Routing-, State-Management- und Datenabrufmuster, die im Repository bereits verwendet werden.
- Strebe eine 1:1 visuelle Übereinstimmung mit dem Figma-Design an. Bei Konflikten bevorzuge Design-System-Tokens und passe Abstände oder Größen minimal an, um die Optik zu erreichen.
- Validiere die endgültige Benutzeroberfläche gegen den Figma-Screenshot sowohl hinsichtlich Aussehen als auch Verhalten.
Asset-Handling
- Der Figma MCP Server stellt einen Assets-Endpunkt bereit, der Bild- und SVG-Assets bereitstellen kann.
- WICHTIG: Wenn der Figma MCP Server eine localhost-Quelle für ein Bild oder SVG zurückgibt, verwende diese Bild- oder SVG-Quelle direkt.
- WICHTIG: Importiere/füge KEINE neuen Icon-Pakete hinzu; alle Assets sollten im Figma-Payload enthalten sein.
- WICHTIG: Verwende oder erstelle KEINE Platzhalter, wenn eine localhost-Quelle bereitgestellt wird.
Link-basiertes Prompting
- Der Server ist link-basiert: Kopiere den Figma-Frame/Layer-Link und gib diese URL an den MCP-Client weiter, wenn du um Implementierungshilfe bittest.
- Der Client kann die URL nicht durchsuchen, extrahiert aber die Node-ID aus dem Link. Stelle immer sicher, dass der Link auf die exakte Node/Variante zeigt, die du benötigst.
Referenzen
references/figma-mcp-config.md— Einrichtung, Überprüfung, Fehlerbehebung und Erinnerungen zur link-basierten Nutzung.references/figma-tools-and-prompts.md— Werkzeugkatalog und Prompt-Muster zur Auswahl von Frameworks/Komponenten und zum Abrufen von Metadaten.