# Godot MCP — AI Game Developer Wiki

O Godot MCP conecta Claude, Cursor, Copilot e outros agentes de IA ao editor Godot. Instalação, configuração, ferramentas, extensões e CLI.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/godot).

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](https://github.com/IvanMurzak/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

| Peça | O que ela faz |
| --- | --- |
| Addon Godot MCP | Roda no editor Godot, expõe as ferramentas de IA e se conecta a um servidor MCP. |
| Servidor MCP | O servidor na nuvem em [ai-game.dev](https://ai-game.dev) (padrão), ou seu próprio servidor rodando na sua máquina. |
| Cliente de IA | Claude Code, Cursor, VS Code Copilot, Codex, Gemini ou qualquer outro cliente MCP. Ele se conecta ao mesmo servidor. |
| `godot-cli` | A ferramenta de linha de comando npm que instala o addon, faz seu login, grava as configurações dos clientes de IA e abre o editor. |
| Aplicativo AI Game Dev | O aplicativo desktop que instala o addon e abre o editor para você, sem precisar de terminal. |

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](https://ai-game.dev/pt-br/docs/wiki/godot/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:

```bash
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](https://ai-game.dev/pt-br/docs/wiki/godot/getting-started) percorre os mesmos passos com explicações, e o [quickstart](https://ai-game.dev/pt-br/docs/quickstart) do site cobre as três engines.

## Páginas desta wiki

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

## Mais no site

- [Install Godot MCP](https://ai-game.dev/pt-br/engines/godot): a página de instalação do Godot.
- [Catálogo de ferramentas do Godot](https://ai-game.dev/docs/tools/godot) e [extensões do Godot](https://ai-game.dev/docs/extensions/godot).
- [Boas práticas para Godot](https://ai-game.dev/docs/best-practices/godot): como escrever prompts que funcionam bem.
- [Endpoint MCP](https://ai-game.dev/pt-br/mcp-endpoint-info) e [autenticação](https://ai-game.dev/docs/auth): o endpoint hospedado e como funciona o login.
- A [wiki do app AI Game Dev](https://ai-game.dev/pt-br/docs/wiki/app) e as wikis de [Unity MCP](https://ai-game.dev/pt-br/docs/wiki/unity) e [Unreal MCP](https://ai-game.dev/pt-br/docs/wiki/unreal).

- [**Instalação** Instale o addon Godot MCP pelo app AI Game Dev, godot-cli, Godot Asset Library ou zip de release, com os pacotes NuGet exatos para o .csproj.](https://ai-game.dev/pt-br/docs/wiki/godot/installation)
- [**Primeiros passos** Conecte o Godot MCP à nuvem, configure um agente de IA como o Claude Code, verifique a conexão e rode seus primeiros prompts no editor Godot.](https://ai-game.dev/pt-br/docs/wiki/godot/getting-started)
- [**Conectando clientes de IA** Conecte Claude Code, Cursor, Copilot, Codex, Gemini e outros clientes MCP ao Godot MCP via nuvem do ai-game.dev ou servidor local.](https://ai-game.dev/pt-br/docs/wiki/godot/connecting-ai-clients)
- [**Configuração** Configure o Godot MCP no dock do AI Game Developer, escolha as ferramentas visíveis aos agentes e substitua ajustes com variáveis GODOT\_MCP\_\*.](https://ai-game.dev/pt-br/docs/wiki/godot/configuration)
- [**Ferramentas** As ferramentas MCP do Godot no editor: RQL para nós, cenas e recursos, scripts C# e GDScript, capturas de tela e ferramentas in-game.](https://ai-game.dev/pt-br/docs/wiki/godot/tools)
- [**Ferramentas personalizadas** Crie ferramentas Godot MCP em C#, chame a API Godot na thread principal e exponha ferramentas, prompts e recursos de um jogo em execução.](https://ai-game.dev/pt-br/docs/wiki/godot/custom-tools)
- [**Extensões** Extensões opcionais do Godot MCP: AnimationPlayer, CSG, GridMap, navegação, partículas, TileMapLayer, Beehave, Dialogic, Phantom Camera e Terrain3D.](https://ai-game.dev/pt-br/docs/wiki/godot/extensions)
- [**Referência do godot-cli** Todos os comandos e flags do godot-cli para o Godot MCP, de install-plugin, login e setup-mcp a open, exec, run-tool, configure e install-extension.](https://ai-game.dev/pt-br/docs/wiki/godot/cli)
- [**Solução de problemas** Corrija problemas do Godot MCP: addon que não carrega ou compila, Extensões vazias, ferramentas ausentes, erros de reload e crashes no .NET 10.](https://ai-game.dev/pt-br/docs/wiki/godot/troubleshooting)
- [**FAQ** Respostas curtas sobre o Godot MCP: versões do Godot, projetos GDScript, uso offline, custo, segurança e jogos exportados.](https://ai-game.dev/pt-br/docs/wiki/godot/faq)

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/godot

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/godot