Beckett: Godot 4에서 플러그인을 켜고 먼저 inspect한 뒤 게임을 바꾸기

누구에게 맞나

Godot 4 편집기에서 GDScript 또는 C# 게임을 만들고, Claude나 Cursor가 바로 검사·작성·실행·씬 확인을 하길 원하며 Node나 Python 다리, 두 번째 프로세스, 클라우드를 걸고 싶지 않을 때. Beckett는 편집기에 박힌 GDScript EditorPlugin이며 sidecar가 없다.

무료 MIT Lite는 inspect → author → run → SEE 순환 전체를 덮고 도구는 모두 55개다. 이 페이지는 그 55개를 거명하지 않으니 씬 트리나 스크립트 도구 이름을 만들지 마라.

공식 저장소는 한 줄:

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

3분 만에 첫 시도

공식 한 단계 설치만 따른다. Godot 4에서 이 플러그인을 켠다. 켜면 서비스가 자동으로 뜨고 .mcp.json을 써서 claude나 Cursor가 설정을 손대지 않고 연결한다. Node.js는 필요 없다.

전제: 이 기기에 Godot 4 편집기가 있고 이 addon이 있는 프로젝트를 열 수 있다. addon 외에 설치할 것은 없다. 런타임은 편집기 메인 스레드에서 폴링하는 TCPServer HTTP/JSON-RPC다.

설정 위치: Godot 플러그인 스위치와 프로젝트에 자동 생성되는 .mcp.json. 자동 파일과 충돌하는 서버 설정을 손으로 쓰지 마라. 자동 시작을 원하지 않으면 공식 opt-out은 beckett/autostart=false다.

위험 낮은 첫 단계: 먼저 inspect. 프로젝트만 관찰하고 author나 run은 하지 마라. 성공 신호는 플러그인을 켠 뒤 서비스가 뜨고 .mcp.json이 나타나며 Claude 또는 Cursor가 연결되는 것이다. 이 페이지에 구체 inspect 도구 이름은 없으니 만들지 마라.

안전 경계: localhost만 듣고 Origin 검증(DNS-rebind 방지), 선택 bearer token, read-only / allowlist / confirm-destructive 빗장이 있다. localhost를 네트워크 없음이나 로컬 읽기 없음으로 읽지 마라. 이 기기에서 HTTP를 열고 편집기의 프로젝트를 읽고 쓴다. readOnlyHint는 제로 위험이 아니다.

씬을 바꾸거나 게임을 돌리기 전에 destructive에 확인이 필요한지 확인하라. author와 run은 프로젝트를 바꾸거나 게임을 시작한다. 공식에 취소 명령은 없다.

사용 사례

사례 1: 먼저 현재 프로젝트를 검사한다. 플러그인을 켜고 클라이언트가 .mcp.json으로 연결하게 한 뒤 inspect만 쓴다. 55개 중 무엇이 inspect인지는 거명되지 않았다. GDScript와 C# 모두 Lite 범위다.

사례 2: 작성하거나 실행하기 전에 확인 빗장을 연다. 공식 순환은 inspect → author → run → SEE다. author는 프로젝트를 바꾸고 run은 편집기에서 게임을 돌린다. confirm-destructive와 allowlist가 있다. 도구 이름이 없으면 쓰기를 호출하지 마라. 선택 bearer token을 어떻게 만드는지는 쓰여 있지 않다.

사용 한계

sidecar 없음이 로컬 HTTP 없음은 아니다. 클라우드도 두 번째 프로세스도 없지만 여전히 localhost에 바인드한다. .mcp.json을 자동으로 쓰며 beckett/autostart=false로 자동 시작을 끌 수 있다. 55개 도구는 거명되지 않았다. Lite는 MIT 무료판이다. 공식은 포트 번호, Godot 마이너 버전, 제거 후 .mcp.json 삭제를 쓰지 않았다.