Como ativar o plugin MCP no Godot: do download às ferramentas no Cursor

Como ativar: o que este guia cobre

Ativar o plugin MCP não é só marcar uma caixa: o servidor local precisa estar rodando e as tools visíveis no Cursor (ou outro IDE MCP). Cinco passos: baixar → addons → ativar plugin → Start Server → verificar no Cursor.

Ao terminar você poderá:

• Colocar o plugin em addons e ativá-lo em Project Settings
• Iniciar o Godot MCP Server local (porta 3000 por padrão)
• Usar configuração em um clique e confirmar godot-mcp no Cursor

Checklist de ativação (veja primeiro)

1. Pasta do plugin em addons/<nome>/ (sem aninhamento extra)
2. Project Settings → Plugins: Godot MCP Server ativado
3. Painel GodotMCP em Running
4. Lista MCP do Cursor mostra godot-mcp (Reload se preciso)
5. Prompt somente leitura lista nós raiz da cena ativa

Repo: DaxianLee/godot-mcp · Produto: Godot MCP

Pré-requisitos

Item	Observações
Godot	Instalado, com um projeto que você possa abrir
Pacote do plugin	godot-mcp release ou ZIP do código-fonte do GitHub
IDE de IA	Cursor recomendado; outros clientes MCP também funcionam
Rede local	A ponte MCP geralmente roda em 127.0.0.1 — não exponha a porta publicamente

Passo 1: Baixar o Godot MCP

Baixe o Godot MCP de código aberto do GitHub:

Repositório: https://github.com/DaxianLee/godot-mcp

Fluxo sugerido:

1. Abra o repositório e use Code → Download ZIP, ou pegue o pacote mais recente em Releases
2. Salve o arquivo localmente e prepare-se para extraí-lo
3. Confirme que o pacote parece um plugin Godot (uma pasta relacionada a addons, ou uma pasta de plugin que você possa colocar em addons)

Passo 2: Adicionar o Godot MCP ao Seu Projeto

1. Extraia o arquivo em sua máquina
2. Mova a pasta do plugin extraída para o diretório addons na raiz do projeto Godot
   • Se addons ainda não existir, crie-o primeiro
3. Abra (ou recarregue) o projeto no Godot e confirme se os arquivos do plugin aparecem no dock FileSystem

Exemplo de layout do projeto após a importação:

Passo 3: Ativar o plugin Godot MCP em Project Settings

1. Abra Projeto → Configurações do Projeto (ou o equivalente para sua versão do Godot)
2. Vá para a aba Plugins
3. Encontre Godot MCP Server (o nome pode variar ligeiramente na interface)
4. Ative-o

Após ativar, uma entrada Godot MCP deve aparecer em um painel lateral ou dock para que você possa definir a porta e iniciar o servidor em seguida.

Passo 4: Iniciar o Godot MCP Server

1. No painel direito do editor Godot, abra o dock GodotMCP
2. Revise e ajuste conforme necessário:
   • Porta: padrão 3000
   • Idioma: escolha o que corresponda à sua preferência de interface
   • Inicialização: você pode ativar a inicialização automática para que o servidor suba quando você abrir o projeto
3. Clique em Iniciar
4. Quando o painel mostrar Executando (ou o equivalente localizado), o Godot MCP Server está ativo

Agora você tem uma ponte MCP local. Em seguida, entregue-a à sua IDE de IA.

Passo 5: Configuração da IDE de IA com Um Clique (Exemplo com Cursor)

1. No painel GodotMCP, abra Ferramentas
   • Revise as ferramentas expostas pelo servidor
   • Ative apenas os recursos que você deseja que a IA use
2. Abra Configurar
   • Escolha sua IDE (por exemplo, Cursor)
   • Clique em Configuração com um clique
   • Aguarde uma mensagem de configuração bem-sucedida
3. Abra o Cursor
   • Na lista de MCP / ferramentas, você deve ver godot-mcp conectado automaticamente
   • Se não aparecer, clique em Recarregar (ou a ação equivalente de recarregar MCP) no Cursor e verifique novamente

Configuração e conexão:

Verificação rápida após conectar

No Cursor, comece com uma verificação somente leitura, por exemplo:

Liste os nós raiz da cena Godot ativa.

Se a resposta corresponder à Hierarquia do editor, a ponte funciona. Em seguida, tente uma pequena escrita (crie um nó temporário e exclua-o) para confirmar permissões e seleção de ferramentas.

Perguntas Frequentes

Copiei os arquivos para addons, mas o Godot MCP Server está faltando na lista de plugins?
Certifique-se de que a pasta esteja em addons/<nome-do-plugin>/ e não aninhada em um nível extra de descompactação. Recarregue o projeto ou reinicie o Godot.

Cliquei em Iniciar, mas nunca vejo Executando?
Confirme se a porta 3000 (ou sua porta personalizada) está livre e tente novamente. Verifique se nada está bloqueando o localhost.

O Cursor não mostra godot-mcp?
No Godot, confirme se o servidor ainda está Executando, execute a configuração com um clique novamente e recarregue o MCP no Cursor. Se ainda falhar, verifique se a configuração MCP do Cursor inclui o endereço da ponte local.

A inicialização automática está ativada, mas ainda preciso iniciar manualmente?
Algumas versões precisam de um primeiro início manual bem-sucedido. Confirme se a caixa de seleção foi salva, reabra o mesmo projeto e verifique.

Próximos Passos

• Use linguagem natural para uma consulta de cena ou uma pequena edição para aprender os limites das ferramentas
• Faça commit antes de grandes alterações; mantenha a ponte apenas no localhost
• Para transferência de design para engine, combine com o VberAI Studio e itere no editor com MCP

Para mais informações sobre Godot + MCP, veja Como construímos um servidor MCP em tempo real para Godot.