MCP

Beckett: ative o plugin no Godot 4, faça inspect primeiro e só então mude o jogo

Para Claude ou Cursor inspecionarem um jogo no editor Godot 4 sem processo extra. Ativar o plugin escreve .mcp.json sozinho. Comece por inspect; author/run têm trava de confirmação.

Official source · Beckett

Install

Enable the Beckett EditorPlugin (writes .mcp.json)

Para quem

Você faz jogos GDScript ou C# no editor Godot 4 e quer que Claude ou Cursor inspecionem, escrevam, executem e vejam a cena direto — sem ponte Node ou Python, segundo processo ou nuvem. Beckett é um EditorPlugin GDScript embutido, zero sidecar.

O MIT Lite gratuito cobre o ciclo completo inspect → author → run → SEE, 55 ferramentas no total. Esta página não nomeia essas 55, então não invente nomes de árvore de cena ou de scripts.

Repositório oficial sozinho numa linha:

https://github.com/beckettlab/beckett-godot-mcp

Primeira tentativa em 3 minutos

Siga só a instalação oficial de um passo: ative o plugin no Godot 4. Depois de ativar, o serviço sobe sozinho e escreve .mcp.json para claude ou Cursor conectarem sem editar à mão. Node.js não é necessário.

Pré-requisito: você já tem o editor Godot 4 e consegue abrir um projeto com este addon. Nada mais para instalar. Em tempo de execução um TCPServer HTTP/JSON-RPC faz polling na thread principal do editor.

Onde configurar: o interruptor de plugin do Godot e o .mcp.json gerado no projeto. Não escreva à mão uma configuração de servidor que brigue com o arquivo automático. Se não quiser autostart, o texto oficial dá um opt-out: beckett/autostart=false.

Primeiro passo de baixo risco: inspect primeiro — só observe, sem author nem run. Sinal de sucesso: após ativar o plugin o serviço sobe, .mcp.json aparece e Claude ou Cursor conseguem conectar. Esta página não tem nome concreto de ferramenta inspect; não invente.

Fronteira de segurança: escuta só localhost, com checagem Origin (contra DNS-rebind), bearer token opcional e travas read-only / allowlist / confirm-destructive. Não leia localhost como sem rede ou sem leituras locais; ainda abre HTTP nesta máquina e lê/escreve o projeto no editor. readOnlyHint não é risco zero.

Antes de mudar uma cena ou rodar o jogo, confirme que destructive pede confirmação. author e run mudam o projeto ou iniciam o jogo; o texto oficial não dá comando de desfazer.

Casos de uso

Caso 1: inspecionar primeiro o projeto atual. Ative o plugin, deixe o cliente conectar via .mcp.json e use só inspect. Quais das 55 pertencem a inspect não são nomeadas. GDScript e C# estão ambos no Lite.

Caso 2: antes de escrever ou executar, abra a trava de confirmação. O ciclo oficial é inspect → author → run → SEE. author muda o projeto; run joga no editor. Há confirm-destructive e allowlist. Sem nome de ferramenta, não chame uma escrita. O texto oficial não diz como gerar o bearer token opcional.

Limites de uso

Zero sidecar não é zero HTTP local. Sem nuvem e sem segundo processo, mas ainda liga em localhost. Escreve .mcp.json sozinho; beckett/autostart=false desliga o autostart. As 55 ferramentas não são nomeadas. Lite é a edição MIT gratuita. O texto oficial não escreve número de porta, menor do Godot nem como apagar .mcp.json após desinstalar.