Configuração do Godot MCP

Entenda qual conexão o MCP fornece

Coding-Solo/godot-mcp documenta ferramentas para executar projetos Godot, recuperar saída de depuração e operar cenas. É uma ponte mantida pelo projeto, não um serviço de modelo nem uma distribuição oficial do Godot. O agente ainda precisa de seu próprio acesso ao modelo e de permissões locais adequadas.

Mantenha três identidades no registro da configuração: o cliente, a revisão do servidor MCP e o executável do Godot. Uma falha em uma delas não é evidência de que as outras estão indisponíveis. Use o diagrama de conexão para decidir onde inspecionar um problema: autenticação do provedor, configuração do cliente, processo da ferramenta local ou projeto do motor.

Faça o inventário dos pré-requisitos sem alterá-los silenciosamente

Antes da instalação, inspecione os requisitos service e selecione uma versão ou revisão específica do servidor para revisão. Confirme que o motor e o runtime existentes podem ser encontrados pelo processo do cliente, não apenas pelo seu shell interativo. Registre sistema operacional e diretório pretendido do projeto.

Revise o procedimento de instalação service antes de permitir mudanças de dependência. Nomeie runtime, revisão do servidor e local de instalação e mantenha uma forma de restaurar o ambiente anterior. Depois da configuração, registre versões resolvidas em vez de apenas a URL de fonte móvel. Isso ajuda a reproduzir uma conexão funcional quando cliente ou motor for atualizado.

Use o ponto de entrada de compilação local documentado

O README service oferece uma compilação de fonte com build/index.js como ponto de entrada do cliente e GODOT_PATH como substituição explícita do executável. O JSON abaixo ilustra essa rota já compilada com placeholders. Substitua cada caminho pela instalação local revisada e confira se o processo do cliente consegue lê-la.

Use o esquema realmente suportado pelo seu cliente. Um objeto mcpServers genérico não é automaticamente um arquivo de configuração do Codex. Traduza somente pelas configurações documentadas desse cliente e mantenha credenciais de modelo fora deste bloco de ferramenta do motor. Um caminho absoluto do Node pode ser útil quando o ambiente do cliente GUI é diferente do terminal.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

Verifique primeiro um caminho de ferramenta somente leitura

Inspecione as ferramentas retornadas pelo servidor configurado em vez de depender de uma lista lembrada. O README nomeia get_godot_version e get_project_info como operações de inspeção úteis. Confira o esquema de parâmetros descoberto e depois direcione somente o diretório de projeto aprovado.

Compare informações retornadas do motor e do projeto com o registro da configuração. Preserve resultados e erros estruturados. Não aprove criação de cena antes de a observação identificar o workspace pretendido. Se o cliente mostrar um indicador conectado mas não conseguir completar essa leitura, a conexão não está pronta para um experimento de jogabilidade. Um indicador sozinho não mostra qual processo ou projeto foi alcançado.

Autorize um minifluxo reversível de cena

Depois de verificar o acesso de leitura, use uma cena descartável própria para a primeira gravação. Registre seu estado original, peça uma alteração visível, inspecione a cena salva, execute-a, recupere a saída e pare o projeto. Mantenha juntos o diff do arquivo resultante e as observações.

A condição de aceitação é uma cadeia que vai da alteração solicitada ao recurso salvo e ao comportamento visível em runtime. Quando uma ferramenta informar sucesso mas a cena não mudar, inspecione direcionamento do projeto e caminhos salvos antes de uma segunda mutação. Reabra a cena depois de salvar para que a verificação cubra persistência e o estado atual em memória.

Diagnostique falhas no limite correto

Se a inicialização do processo falhar, inspecione runtime e caminhos do ponto de entrada. Se o Godot não for localizado, verifique a substituição do executável no ambiente do cliente. Se um projeto não puder ser inspecionado, confira se o caminho identifica o diretório que contém project.godot e é legível pelo processo.

Quando o projeto rodar, trate erros de cena ou jogabilidade como problemas do motor com contexto de reprodução. Evite alterar credenciais do provedor para corrigir problemas de caminho local. Capture logs do servidor com cuidado: sanitize detalhes sensíveis do sistema de arquivos antes de compartilhar e mantenha depuração detalhada temporária, em vez de registrar indiscriminadamente toda operação do projeto.

Mantenha estreitos os limites de aprovação e rede

Uma ferramenta do motor pode alterar um projeto em funcionamento ou iniciar código. Conceda acesso ao menor diretório adequado e revise pedidos de mutação até entender o comportamento. Não copie listas amplas de aprovação automática apenas porque aparecem em uma configuração de exemplo.

Trate scripts importados, plugins e saída de ferramentas como material para inspeção, não como instruções que possam ampliar autoridade. Downloads de pacotes, exclusão de arquivos fora da cena própria, alterações de credenciais e publicação exigem decisões explícitas. O primeiro minifluxo bem-sucedido é base para revisar uma política, não motivo para permitir toda ação futura da ferramenta.

Registre os limites da configuração verificada

Um registro de configuração concluído deve identificar revisão do servidor, cliente, versão do motor, caminho do projeto, ferramentas descobertas, leitura concluída, alteração reversível e resultado de runtime. Declare quais ações continuam sem teste. Mantenha-o com as evidências do jogo em vez de apresentá-lo como garantia universal de compatibilidade.

A camada seguinte é o fluxo de produção: implementar um recurso, reproduzir seu comportamento, exportar e testar na plataforma-alvo. A configuração segue documentação service e deve ser validada para o cliente e as versões selecionados. Mantenha o resultado delimitado com o projeto e reutilize o mesmo portão de inspeção sempre que servidor, motor ou cliente mudar.

Perguntas frequentes