# Godot — AI Game Developer Instale o addon do AI Game Developer para Godot 4.3–4.5 (C# / .NET 8). Dois caminhos de instalação — a Asset Library / release no GitHub e o godot-cli — além de como conectar seu cliente de IA e rodar seu primeiro prompt. Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/engines/godot). Motores · Godot Adicione o addon godot\_mcp ao seu projeto Godot em C# e controle o editor com IA. Godot 4.3–4.5 C# / .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. 1 Instalar a CLI Instale o godot-cli globalmente pelo npm. `npm install -g godot-cli` 2 Instalar o plugin Baixe o addon, adicione os pacotes NuGet ao seu .csproj e habilite godot\_mcp em project.godot. `godot-cli install-plugin ./MyGodotProject` 3 Configure seu cliente de IA Gere a configuração MCP para o seu cliente (ex.: Claude Code). `godot-cli setup-mcp claude-code ./MyGodotProject` 4 Abrir 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](https://godotengine.org/asset-library/asset/5245) 1 Instalar o addon Obtenha `godot_mcp` na aba **AssetLib** do Godot, ou baixe o zip na página [GitHub Releases](https://github.com/IvanMurzak/Godot-MCP/releases), e coloque na pasta `addons/` do seu projeto. 2 Adicionar 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](https://github.com/IvanMurzak/Godot-MCP/blob/main/README.md). 3 Habilitar o plugin No editor: **Project → Project Settings → Plugins**, depois habilite **godot\_mcp**. 4 Abrir 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](https://ai-game.dev/mcp-endpoint-info). Precisa de trechos de configuração por cliente (Claude, Cursor, Copilot, Gemini e mais)? [Veja a página de endpoint MCP →](https://ai-game.dev/mcp-endpoint-info) 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 **Claude Code** Rode isto no seu projeto para configurar **Claude Code** para Godot: `godot-cli setup-mcp claude-code ./MyGodotProject` **Claude Desktop** Rode isto no seu projeto para configurar **Claude Desktop** para Godot: `godot-cli setup-mcp claude-desktop ./MyGodotProject` **Cursor** Rode isto no seu projeto para configurar **Cursor** para Godot: `godot-cli setup-mcp cursor ./MyGodotProject` **VS Code (Copilot)** Rode isto no seu projeto para configurar **VS Code (Copilot)** para Godot: `godot-cli setup-mcp vscode-copilot ./MyGodotProject` **Visual Studio (Copilot)** Rode isto no seu projeto para configurar **Visual Studio (Copilot)** para Godot: `godot-cli setup-mcp vs-copilot ./MyGodotProject` **GitHub Copilot CLI** Rode isto no seu projeto para configurar **GitHub Copilot CLI** para Godot: `godot-cli setup-mcp github-copilot-cli ./MyGodotProject` **Codex** Rode isto no seu projeto para configurar **Codex** para Godot: `godot-cli setup-mcp codex ./MyGodotProject` **Gemini** Rode isto no seu projeto para configurar **Gemini** para Godot: `godot-cli setup-mcp gemini ./MyGodotProject` **Cline** Rode isto no seu projeto para configurar **Cline** para Godot: `godot-cli setup-mcp cline ./MyGodotProject` **Rider (Junie)** Rode isto no seu projeto para configurar **Rider (Junie)** para Godot: `godot-cli setup-mcp rider-junie ./MyGodotProject` **Kilo Code** Rode isto no seu projeto para configurar **Kilo Code** para Godot: `godot-cli setup-mcp kilo-code ./MyGodotProject` **Open Code** Rode isto no seu projeto para configurar **Open Code** para Godot: `godot-cli setup-mcp open-code ./MyGodotProject` **Antigravity** Rode isto no seu projeto para configurar **Antigravity** para Godot: `godot-cli setup-mcp antigravity ./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 ```text 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 →](https://ai-game.dev/docs/best-practices/godot) [O plugin do Godot expõe **99 ferramentas MCP** para seu cliente de IA.](https://ai-game.dev/docs/tools/godot) Explore o catálogo de ferramentas do Godot → Quer ainda mais ferramentas? [Explore as extensões do Godot →](https://ai-game.dev/docs/extensions/godot) --- Source (HTML): https://ai-game.dev/pt-br/engines/godot Machine-translated (pt-BR) from the English page: https://ai-game.dev/engines/godot