Figma MCP Server

Servidor MCP do Figma

Um servidor MCP local com cobertura completa da API REST do Figma. Funciona com Claude Desktop, Cursor, VS Code, a CLI do Gemini e qualquer cliente MCP. Disponível no npm e no Registro MCP oficial.

Como funciona

Cada endpoint REST do Figma é exposto como uma ferramenta MCP autodescritiva, descoberta automaticamente na inicialização a partir de tools/figma/, então adicionar um endpoint é apenas adicionar um arquivo. Parâmetros obrigatórios são validados antes de cada chamada. Ele roda via stdio.

Pré-requisitos

Requer Bun ≥ 1.2. É nativo do Bun, então inicie-o com bunx, não com npx (Node não é suportado).

Chave da API do Figma

Crie um token de acesso pessoal no Figma em Configurações > Segurança > Tokens de acesso pessoal > Gerar novo token. Forneça-o como FIGMA_API_KEY, idealmente no bloco env da configuração do seu cliente (veja abaixo).

Configure seu cliente

Todo cliente usa o mesmo servidor. Aponte command para bunx, ou seu caminho absoluto (which bunx) se o cliente não conseguir encontrá-lo em PATH.

{
  "mcpServers": {
    "figma": {
      "command": "bunx",
      "args": ["figma-mcp-server"],
      "env": {
        "FIGMA_API_KEY": "your_figma_api_key_here"
      }
    }
  }
}

Locais dos arquivos de configuração:

• Claude Desktop: Configurações > Desenvolvedor > Editar Configuração (claude_desktop_config.json)
• Cursor: ~/.cursor/mcp.json, ou .cursor/mcp.json por projeto
• CLI do Gemini: ~/.gemini/settings.json

Reinicie o cliente após editar a configuração.

VS Code

Use .vscode/mcp.json (workspace) ou seu mcp.json de usuário, com uma chave servers. Em vez de codificar o token, defina uma entrada para que o VS Code solicite-o com segurança:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "figma-api-key",
      "description": "Figma API Key",
      "password": true
    }
  ],
  "servers": {
    "figma": {
      "command": "bunx",
      "args": ["figma-mcp-server"],
      "env": {
        "FIGMA_API_KEY": "${input:figma-api-key}"
      }
    }
  }
}

• Com ${input:figma-api-key}, o VS Code solicita a chave na primeira vez que o servidor inicia e depois a armazena no armazenamento secreto do seu sistema operacional.
• Para reinserir ou limpar: Paleta de Comandos → MCP: Listar Servidores → escolha o servidor → redefina/edite suas entradas.

Cobertura de ferramentas

Cobertura completa da API REST do Figma (endpoints não obsoletos), 50 ferramentas em:

• Arquivos e nós (arquivos, árvores de nós, renderização de imagens, preenchimentos de imagem, metadados, histórico de versões)
• Variáveis / tokens de design (ler, publicar, modificar em massa)
• Componentes, conjuntos de componentes e estilos (escopos de arquivo, publicados e de equipe)
• Comentários e reações
• Pastas (pastas de nível superior, subpastas, arquivos, metadados)
• Usuários
• Recursos de desenvolvimento
• Webhooks (v2)
• Análises de biblioteca (ações e usos de componentes, estilos e variáveis)
• Organização: logs de atividade, logs de desenvolvedor, uso de IA (Enterprise)
• Incorporações e pagamentos

Verifique a lista de ferramentas do seu cliente MCP para obter a lista completa e sempre atualizada de nomes e parâmetros de ferramentas.

Requisitos de plano

A maioria das ferramentas funciona com o token de acesso pessoal de qualquer plano. Estas exigem níveis superiores:

• Variáveis (list_file_variables, get_published_variables, modify_variables): organização Enterprise.
• Análises de biblioteca (get_library_*): plano Organization ou Enterprise.
• Logs de atividade, logs de desenvolvedor, uso de IA: organização Enterprise com token de acesso de administrador ou plano.

---

Licença MIT · Por @planetabhi ⋛⋋( ⊙◊⊙)⋌⋚