Figma MCP
Use o servidor Figma MCP para implementação orientada pelo Figma. Para detalhes de configuração e depuração (variáveis de ambiente, configuração, verificação), consulte references/figma-mcp-config.md.
Regras de Integração do Figma MCP
Estas regras definem como traduzir entradas do Figma em código para este projeto e devem ser seguidas para toda alteração orientada pelo Figma.
Fluxo obrigatório (não pule)
- Execute
get_design_contextprimeiro para buscar a representação estruturada do(s) nó(s) exato(s). - Se a resposta for muito grande ou truncada, execute
get_metadatapara obter o mapa de nós de alto nível e então busque novamente apenas o(s) nó(s) necessário(s) comget_design_context. - Execute
get_screenshotpara uma referência visual da variante do nó sendo implementada. - Somente depois de possuir tanto
get_design_contextquantoget_screenshot, baixe quaisquer ativos necessários e inicie a implementação. - Traduza a saída (geralmente React + Tailwind) para as convenções, estilos e framework deste projeto. Reutilize os tokens de cor, componentes e tipografia do projeto sempre que possível.
- Valide em relação ao Figma para garantir aparência e comportamento 1:1 antes de marcar como concluído.
Regras de implementação
- Trate a saída do Figma MCP (React + Tailwind) como uma representação do design e comportamento, não como estilo de código final.
- Substitua classes utilitárias do Tailwind pelas utilitárias/tokens do sistema de design do projeto quando aplicável.
- Reutilize componentes existentes (por exemplo, botões, campos de entrada, tipografia, wrappers de ícone) em vez de duplicar funcionalidades.
- Use consistentemente o sistema de cores, escala tipográfica e tokens de espaçamento do projeto.
- Respeite os padrões de roteamento, gerenciamento de estado e busca de dados já adotados no repositório.
- Busque paridade visual 1:1 com o design do Figma. Quando surgirem conflitos, prefira tokens do sistema de design e ajuste espaçamentos ou tamanhos minimamente para corresponder aos visuais.
- Valide a interface final em relação à captura de tela do Figma tanto na aparência quanto no comportamento.
Manipulação de ativos
- O servidor Figma MCP fornece um endpoint de ativos que pode servir imagens e ativos SVG.
- IMPORTANTE: Se o servidor Figma MCP retornar uma origem localhost para uma imagem ou SVG, use essa imagem ou fonte SVG diretamente.
- IMPORTANTE: NÃO importe/adicione novos pacotes de ícones; todos os ativos devem estar no payload do Figma.
- IMPORTANTE: NÃO use ou crie placeholders se uma origem localhost for fornecida.
Uso baseado em links
- O servidor é baseado em links: copie o link do frame/camada do Figma e forneça essa URL ao cliente MCP ao solicitar ajuda para implementação.
- O cliente não pode navegar pela URL, mas extrai o ID do nó do link; sempre garanta que o link aponte para o nó/variante exato que você deseja.
Referências
references/figma-mcp-config.md— configuração, verificação, solução de problemas e lembretes de uso baseado em links.references/figma-tools-and-prompts.md— catálogo de ferramentas e padrões de prompt para selecionar frameworks/componentes e buscar metadados.