Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Motores · Godot

GodotDisponível

Adicione o addon godot_mcp ao seu projeto Godot em C# e controle o editor com IA.

Godot 4.3–4.5C# / .NET 8 (mono)
01

Instale o plugin

Duas formas de colocar o plugin no seu projeto — escolha a que combina com seu fluxo de trabalho.

Recomendado

CLI

Instale com a ferramenta godot-cli no npm. install-plugin baixa o addon godot_mcp da release correspondente no GitHub, adiciona os dois pacotes NuGet e o embed do catálogo de extensões ao seu .csproj, e habilita o plugin — de forma idempotente.

1Instalar a CLI

Instale o godot-cli globalmente pelo npm.

npm install -g godot-cli
2Instalar o plugin

Baixe o addon, adicione os pacotes NuGet ao seu .csproj e habilite godot_mcp em project.godot.

godot-cli install-plugin ./MyGodotProject
3Configure seu cliente de IA

Gere a configuração MCP para o seu cliente (ex.: Claude Code).

godot-cli setup-mcp claude-code ./MyGodotProject
4Abrir e aguardar

Abra o projeto e aguarde até o editor estar pronto.

godot-cli open ./MyGodotProject

Depois de abrir, você também pode condicionar scripts à prontidão do editor: godot-cli wait-for-ready ./MyGodotProject.

Biblioteca de Assets

Instale o addon godot_mcp pela Godot Asset Library (ou o mesmo zip no GitHub Releases), depois adicione os dois pacotes NuGet e habilite o plugin.

Ver na Asset Library
1Instalar o addon

Obtenha godot_mcp na aba AssetLib do Godot, ou baixe o zip na página GitHub Releases, e coloque na pasta addons/ do seu projeto.

2Adicionar os pacotes NuGet

Adicione os dois pacotes ao seu projeto .csproj: com.IvanMurzak.ReflectorNet versão 5.4.3 e com.IvanMurzak.McpPlugin versão 8.7.1, além do EmbeddedResource addons/godot_mcp/extensions.catalog.json (sem ele o painel Extensions fica vazio). O bloco exato está no README do Godot-MCP.

3Habilitar o plugin

No editor: Project → Project Settings → Plugins, depois habilite godot_mcp.

4Abrir e compilar

Reabra o projeto para o Godot compilar a solução C# com os novos pacotes.

02

Conectar

Conecte pelo endpoint de nuvem hospedado ou aponte para o seu próprio servidor.

Nuvem

Padrão

Conecte pelo ai-game.dev usando o fluxo OAuth de código de dispositivo — sem tokens para copiar à mão. Na janela do AI Game Developer, escolha Cloud, clique em Authorize e aprove o código do dispositivo no navegador. Funciona através de firewalls e oferece análises de uso. É o padrão e o que recomendamos para a maioria dos usuários.

Personalizado

Prefere rodar tudo localmente? Aponte o plugin para a sua própria instância gamedev-mcp-server em vez do endpoint hospedado. Seu cliente de IA passa a falar direto com a sua máquina. Os trechos de configuração de cada cliente estão na página de endpoint MCP.

Precisa de trechos de configuração por cliente (Claude, Cursor, Copilot, Gemini e mais)? Veja a página de endpoint MCP →

03

Configure seu agente de IA

Escolha o agente de IA que você usa e copie o comando godot-cli exato que o conecta ao servidor MCP do Godot.

Seu agente de IA

Rode isto no seu projeto para configurar Claude Code para Godot:

godot-cli setup-mcp claude-code ./MyGodotProject

Reinicie seu agente depois de configurar. O novo servidor MCP só é reconhecido em uma reinicialização completa do agente — feche-o por completo e abra de novo (não basta recarregar a janela).

04

Primeira execução

Abra a janela, autorize e teste seu primeiro prompt.

  1. Abra o projeto no editor Godot e abra o dock AI Game Developer.
  2. Escolha Cloud e clique em Authorize para concluir o fluxo de código de dispositivo.
  3. Aguarde o status ficar verde e então conecte seu cliente de IA.
  4. Experimente um prompt como o abaixo e veja a IA agir no editor.
Prompt de exemplo
Adicione uma cena Node3D com uma Camera3D e um MeshInstance3D em cubo, depois salve como Main.tscn.

Quer mais exemplos de prompts e os padrões para solicitações de IA eficazes? Veja as boas práticas do Godot →

O plugin do Godot expõe 99 ferramentas MCP para seu cliente de IA.

Explore o catálogo de ferramentas do Godot →

Quer ainda mais ferramentas? Explore as extensões do Godot →