> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração Figma MCP

> Aprenda como conectar o Agent ao Figma via MCP para explorar camadas, extrair dados de design e gerar código a partir dos seus designs.

Use o Agent com o Model Context Protocol (MCP) para trabalhar com seus designs do Figma diretamente no chat. Cole um link do Figma para explorar camadas, extrair variáveis e componentes, capturar screenshots e gerar código a partir de frames selecionados.

<Note>
  <strong>Requisitos de assento:</strong> Um assento **Dev** ou **Full** do Figma é recomendado para os recursos de chat do Agent. Assentos Free, Starter e Viewer são limitados a 6 chamadas de ferramenta MCP por mês. O fluxo de importação em <a href="/pt/build/figma-to-app">replit.com/import</a> tem limites separados — veja os <a href="#rate-limits-and-figma-seat-requirements">limites de taxa</a> abaixo.
</Note>

<Callout>
  Quer transformar um design do Figma em um novo app? Veja o <a href="/pt/build/figma-to-app">guia Transforme um design do Figma em um app interativo</a>.
</Callout>

<Note>
  A integração Figma MCP usa um <strong>servidor remoto</strong> — você não precisa ter o app desktop do Figma instalado ou em execução para usar esse recurso no Agent.
</Note>

## Recursos

* **Gerar código inicial**: Transforme frames selecionados em código pronto para produção para inicializar recursos ou iterar mais rápido.
* **Extrair dados de design**: Acesse variáveis, componentes e especificações de layout definidas no seu arquivo.
* **Capturar screenshots de frames**: Crie referências visuais de qualquer frame para orientar a implementação.
* **Inspecionar atividade MCP**: Expanda os eventos do chat para ver as solicitações e respostas em bruto.

## Demonstração

Veja um passo a passo rápido do fluxo, desde a detecção do link até a geração de código:

<Frame>
  <video autoPlay muted loop playsInline src="https://cdn.replit.com/sanity/figma-mcp-v3.mp4" />
</Frame>

## Uso

### Conecte no chat do Agent

1. Abra o chat do Agent no Editor de Projeto.
2. Cole um link válido de arquivo ou prototype do Figma na caixa de mensagem.
3. Quando um link válido é detectado, um card de <strong>design do Figma</strong> aparece. Clique em <strong>Log in with Figma</strong> para autorizar.

Depois de colar um link suportado, o Agent mostra um card de design do Figma para autorização rápida:

<Frame>
  <img src="https://mintcdn.com/replit/SLo-1yBQr-cqDnLT/images/replitai/mcp-figma/figma-design-card.png?fit=max&auto=format&n=SLo-1yBQr-cqDnLT&q=85&s=91abb671ede47c85eaadc4b5f5faf88e" alt="Card Connect Figma aparece no chat do Agent quando um link válido do Figma é colado" width="475" height="216" data-path="images/replitai/mcp-figma/figma-design-card.png" />
</Frame>

### Trabalhe com links do Figma

Use fluxos de trabalho baseados em link para agir em partes precisas do seu design:

1. No Figma, copie o link de qualquer frame ou camada.
2. Compartilhe a URL com o Agent na caixa de chat e descreva o que você quer.

No Figma, copie um link para o frame ou camada exato com o qual você quer que o Agent trabalhe:

<Frame>
  <img src="https://mintcdn.com/replit/SLo-1yBQr-cqDnLT/images/replitai/mcp-figma/client-link.png?fit=max&auto=format&n=SLo-1yBQr-cqDnLT&q=85&s=25c66c48dac21b5fe527c32f0586e4f9" alt="Selecionando um frame no Figma" width="1000" height="612" data-path="images/replitai/mcp-figma/client-link.png" />
</Frame>

Depois cole o link no Agent junto com uma instrução curta (por exemplo, "gere React para este frame"):

<Frame>
  <img src="https://mintcdn.com/replit/SLo-1yBQr-cqDnLT/images/replitai/mcp-figma/agent-chat.png?fit=max&auto=format&n=SLo-1yBQr-cqDnLT&q=85&s=2e1d278c4f81028e2cb11b475435cb2b" alt="Compartilhando a URL com o Agent na caixa de chat" width="921" height="495" data-path="images/replitai/mcp-figma/agent-chat.png" />
</Frame>

### Veja as chamadas MCP

Abra o evento da linha do tempo chamado <strong>Used Figma MCP (Beta)</strong> para ver as solicitações e respostas subjacentes.

Aqui está onde expandir o evento da linha do tempo para inspecionar as chamadas MCP:

<Frame>
  <img src="https://mintcdn.com/replit/SLo-1yBQr-cqDnLT/images/replitai/mcp-figma/mcp-calls.png?fit=max&auto=format&n=SLo-1yBQr-cqDnLT&q=85&s=a0277ab413c385d4c2ef9e2d3a30e26f" alt="Evento de chat expandido mostrando chamadas MCP para a integração do Figma" width="725" height="928" data-path="images/replitai/mcp-figma/mcp-calls.png" />
</Frame>

<Callout>
  O acesso MCP ao Figma é orientado à leitura e respeita suas permissões do Figma. Se um arquivo for privado ou você não tiver acesso, a integração não conseguirá buscar o conteúdo.
</Callout>

## Limites de taxa e requisitos de assento do Figma

O Figma impõe limites de taxa nas chamadas de ferramenta MCP com base no seu plano e tipo de assento do Figma. Esses limites são definidos pelo Figma, não pelo Replit.

| Tipo de assento  | Starter / Free   | Pro / Organization | Enterprise         |
| ---------------- | ---------------- | ------------------ | ------------------ |
| **View, Collab** | 6 chamadas / mês | 6 chamadas / mês   | 6 chamadas / mês   |
| **Dev, Full**    | —                | 200 chamadas / dia | 600 chamadas / dia |

Assentos Dev e Full também têm limites por minuto: 10/min no Pro, 15/min no Organization e 20/min nos planos Enterprise.

### O que conta contra o limite

Os limites de taxa se aplicam a ferramentas que leem dados do Figma, como `get_design_context` e `get_image`. Algumas ferramentas como `whoami` e `generate_figma_design` são isentas.

### Se você atingir um limite de taxa

O Agent avisa quando um limite de taxa do Figma é atingido. Para aumentar seu limite:

* **Em um plano Starter ou conta gratuita**: Faça upgrade para um plano Pro, Organization ou Enterprise com um assento Dev ou Full.
* **Em um assento View ou Collab**: Faça upgrade para um assento Dev ou Full no seu plano atual.
* **Em um assento Dev/Full (Organization)**: Faça upgrade para um plano Enterprise para os limites mais altos.

Para detalhes completos, veja a <a href="https://developers.figma.com/docs/figma-mcp-server/plans-access-and-permissions" target="_blank" rel="noreferrer">documentação de planos, acesso e permissões do Figma</a>.

### Gerencie conexões

Gerencie ou desconecte a integração do Figma em <a href="https://replit.com/integrations" target="_blank" rel="noreferrer">replit.com/integrations</a>.

Encontre e gerencie conexões na sua página de integrações do Replit:

<Frame>
  <img src="https://mintcdn.com/replit/SLo-1yBQr-cqDnLT/images/replitai/mcp-figma/managing-mcps.png?fit=max&auto=format&n=SLo-1yBQr-cqDnLT&q=85&s=800e9bfe4881c4ec6785646f11151198" alt="Painel de integrações mostrando a integração do Figma" width="2384" height="468" data-path="images/replitai/mcp-figma/managing-mcps.png" />
</Frame>
