Integração Claude Code + Figma via MCP
Pré-requisitos
- Claude Code instalado (
claude --versionpara confirmar) - Figma Desktop
- Node.js 18+ instalado (
node --version) - Token de acesso do Figma
Configuração
Passo 1 — Gerar o token no Figma
- Acesse figma.com e faça login
- Clique no avatar (canto superior esquerdo) → Settings
- Aba Security → Personal access tokens
- Clique em Generate new token, dê um nome e copie o token gerado
- Guarde o token — ele só aparece uma vez
- Link para documentação
Passo 2 — Instalar o plugin Desktop Bridge no Figma
Pré-requisitos
- Figma Desktop instalado
- Acesso a um projeto com plugins habilitados
- Importante: use um Draft (rascunho pessoal), pois é onde há permissão para instalar plugins de desenvolvimento
2.1 — Baixar o plugin
Acesse o repositório e baixe o arquivo figma-console-mcp.zip:
Extraia o .zip em um local de fácil acesso.
2.2 — Abrir um projeto no Figma Desktop
Abra o Figma Desktop e acesse um Draft (seus rascunhos pessoais).
2.3 — Importar o plugin
No menu superior do Figma, acesse:
Plugins → Development → Import plugin from manifest…
2.4 — Selecionar o manifest
Na janela que abrir, navegue até a pasta extraída e selecione o arquivo:
figma-console-mcp-main/figma-desktop-bridge/manifest.json
Após a importação, o plugin Desktop Bridge estará disponível em Plugins → Development e poderá ser executado para estabelecer a conexão com o Claude.
Passo 3 — Registrar o MCP no Claude Code
Abra o terminal bash e rode:
claude mcp add figma-console \ -e FIGMA_ACCESS_TOKEN=seu_token_aqui \ -e ENABLE_MCP_APPS=true \ -- npx -y figma-console-mcp@latest
Substitua seu_token_aqui pelo token gerado no Passo 1.
Isso grava a configuração globalmente para o seu usuário.
Passo 4 — Verificar se foi registrado
claude mcp list
Deve aparecer algo como:
figma-console: npx -y figma-console-mcp@latest - ✓ Connected
Passo 5 — Testar a conexão
Inicie uma nova sessão do Claude Code. No VSCode:
Ctrl + Shift + P → Reload Window
Dentro da nova sessão, pergunte algo como:
check figma status
ou até:
Liste os componentes do arquivo Figma com ID: <seu-file-id>
O ID do arquivo fica na URL do Figma:
figma.com/file/**ABC123xyz**/Nome-do-Arquivo