Godot MCP

O Godot MCP é o addon de Godot do AI Game Developer. Ele permite que um agente de IA como Claude Code, Cursor, GitHub Copilot, Codex ou Gemini trabalhe dentro do editor Godot: consultar e editar a árvore de cenas, abrir e salvar cenas .tscn, alterar recursos .tres e configurações do projeto, ler e escrever arquivos C# e GDScript, compilar o projeto C#, executar trechos de C# no editor e tirar capturas de tela que o modelo pode analisar. Esta wiki explica como instalá-lo, conectar um cliente de IA e usá-lo no dia a dia.

O que é o Godot MCP#

O Godot MCP é um addon de editor em C# (a pasta addons/godot_mcp/, exibida em Project Settings como Godot-MCP) que roda dentro de um projeto Godot 4 .NET. Quando o editor o carrega, o addon abre um dock chamado AI Game Developer e se conecta a um servidor MCP. O agente de IA com o qual você conversa se conecta ao mesmo servidor e chama as ferramentas do addon por meio do Model Context Protocol (MCP).

O addon é open source (Apache-2.0) e fica no repositório Godot-MCP. Ele compartilha suas bibliotecas de MCP e de reflexão com o Unity MCP e o Unreal MCP, então os três plugins de engine se comportam da mesma forma e usam a mesma conta na nuvem.

Como as peças se encaixam#

No modo Cloud padrão, nada roda na sua máquina além do Godot e do seu cliente de IA: o editor e o agente se conectam ao endpoint hospedado, e você faz login uma única vez com sua conta ai-game.dev. No modo Custom, o addon pode baixar e iniciar um servidor MCP local para você, então tudo fica no seu computador.

Requisitos em resumo#

• A build .NET (mono) do Godot 4.3 ou mais recente. A build padrão, somente GDScript, não consegue compilar o addon.
• O SDK do .NET 8.
• Um projeto Godot com um .csproj de C#. O código do seu jogo ainda pode ser GDScript; o addon precisa do projeto C# apenas para compilar a si mesmo.
• Um cliente de IA que fale MCP.

A lista completa, incluindo os pacotes NuGet de que seu .csproj precisa, está em Installation.

Início rápido#

Se você se sente à vontade com um terminal, estes comandos levam um projeto Godot em C# do zero a um agente de IA conectado:

npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject

Depois peça ao seu agente algo como "Adicione uma cena Node3D com uma Camera3D e um cubo MeshInstance3D e salve como Main.tscn". A página Getting started percorre os mesmos passos com explicações, e o quickstart do site cobre as três engines.

Páginas desta wiki#

• Installation: todos os caminhos de instalação (aplicativo desktop, godot-cli, Asset Library, zip da release) e os pacotes NuGet exatos.
• Getting started: primeira conexão, primeiros prompts e como verificar se tudo funciona.
• Connecting AI clients: endpoint Cloud vs seu próprio servidor, o login por dispositivo, chaves de projeto e setup-mcp para cada agente.
• Configuration: o dock AI Game Developer, as configurações salvas e as variáveis de ambiente GODOT_MCP_*.
• Tools: as famílias de ferramentas integradas, RQL e para que serve cada ferramenta.
• Custom tools: escreva suas próprias ferramentas MCP em C# e exponha ferramentas de um jogo em execução.
• Extensions: pacotes opcionais para animação, CSG, navegação, tilemaps e addons populares do Godot.
• godot-cli reference: todos os comandos do godot-cli e suas flags.
• Troubleshooting: o addon não carrega, o agente não vê ferramentas, problemas de recarregamento.
• FAQ: respostas curtas para perguntas comuns.

Mais no site#

• Install Godot MCP: a página de instalação do Godot.
• Catálogo de ferramentas do Godot e extensões do Godot.
• Boas práticas para Godot: como escrever prompts que funcionam bem.
• Endpoint MCP e autenticação: o endpoint hospedado e como funciona o login.
• A wiki do app AI Game Dev e as wikis de Unity MCP e Unreal MCP.