FAQ

Godot MCP에 대해 가장 많이 받는 질문들의 빠른 답변입니다. 각 답변은 자세한 내용이 있는 페이지로 연결됩니다.

어떤 Godot 버전이 지원되나요?#

Godot 4.3 이상, .NET (mono) 에디션입니다. 애드온은 Godot.NET.Sdk 4.3.0을 최소 버전으로 빌드되며, CI에서 Godot 4.3, 4.4, 4.5, 4.6, 4.7로 구동됩니다. Godot 3은 지원되지 않습니다. 일부 기능은 버전에 따라 다릅니다. 캡처된 런타임 오류의 다중 프레임 GDScript 백트레이스에는 Godot 4.5가 필요하고, Dialogic, Phantom Camera, Terrain3D 확장에는 Godot 4.4가 필요합니다. 설치를 참고하세요.

게임이 GDScript라면 Godot의 .NET 버전이 필요한가요?#

네. 애드온은 C#으로 작성되어 있으므로 Godot의 .NET 빌드, .NET 8 SDK, 그리고 프로젝트의 .csproj가 필요합니다. 게임 자체는 GDScript로 유지할 수 있습니다. 에이전트는 .gd 파일을 읽고, 쓰고, 검증하며, 노드의 GDScript 변수를 읽고 설정할 수 있습니다.

어떤 AI 클라이언트가 Godot MCP와 연동되나요?#

HTTP 서버를 지원하는 모든 MCP 클라이언트입니다. godot-cli setup-mcp는 Claude Code, Cursor, Visual Studio Code, Copilot이 포함된 Visual Studio, Rider (Junie), GitHub Copilot CLI, Gemini, Antigravity, Cline, Open Code, Codex, Kilo Code용 설정을 작성하며, 그 외 클라이언트를 위한 범용 설정도 만듭니다. Claude Desktop과 claude.ai는 Claude 커스텀 커넥터를 통해 연결합니다. AI 클라이언트 연결을 참고하세요.

Claude Code를 Godot과 함께 사용하려면 어떻게 하나요?#

애드온을 설치하고, 로그인하고, 설정을 작성한 다음 프로젝트 폴더에서 Claude Code를 시작하세요:

godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject

Claude Code에서 /mcp를 실행해 Godot 도구가 나열되는지 확인하세요. 시작하기를 참고하세요.

클라우드 없이 Godot MCP를 사용할 수 있나요?#

네. 독을 Custom 모드로 전환하고 Start Server를 클릭하세요. 애드온이 오픈소스 MCP 서버를 한 번 다운로드해 사용자의 머신에서 실행하고 연결합니다. godot-cli setup-mcp <agent> --url http://localhost:8080으로 에이전트가 로컬 URL을 가리키게 하세요. 모델 자체는 여전히 AI 클라이언트가 실행되는 곳에서 동작합니다. AI 클라이언트 연결을 참고하세요.

Godot MCP는 무료인가요?#

애드온과 godot-cli는 Apache-2.0 라이선스의 오픈소스입니다. NuGet 의존성 중 RQL과 Code-Exec은 PolyForm Shield License 1.0.0을 따르며, 이 라이선스는 해당 제품과 경쟁하는 제품을 만드는 경우를 제외하고 상용 제품에서의 사용을 허용합니다. 호스팅된 ai-game.dev 엔드포인트를 사용하려면 계정이 필요합니다. 요금제는 사이트 FAQ를 참고하세요. AI 클라이언트(Claude, Copilot 등)는 각 제공자가 별도로 과금합니다.

CLI에서 GDScript 전용 프로젝트도 작동하나요?#

godot-cli build와 godot-cli open은 프로젝트에 .csproj가 없으면 C# 빌드를 건너뛰지만, 애드온 자체는 그것 없이 컴파일할 수 없습니다. 먼저 Project → Tools → C# → Create C# solution으로 C# 솔루션을 만든 뒤 godot-cli install-plugin을 실행하세요.

애드온이 내보낸 게임에 포함되나요?#

애드온의 에디터 도구는 에디터에서만 컴파일되며, RQL, Code-Exec, Roslyn 패키지는 ExportDebug 및 ExportRelease 빌드에서 제외됩니다. 게임이 MCP 도구를 노출하는 것은 자체 코드에서 옵트인하고 Connect()를 호출하는 경우뿐입니다. 사용자 정의 도구를 참고하세요.

에이전트가 자신의 변경 사항을 실행 취소할 수 있나요?#

네. 모든 rql-mutate 호출은 에디터에서 하나의 실행 취소 단계이므로 Ctrl+Z로 직접 편집한 것처럼 되돌릴 수 있습니다. 실패한 변경은 아무것도 바꾸지 않으며, dry_run으로 변경 사항을 먼저 미리 볼 수 있습니다. 스크립트 생성이나 삭제 같은 파일 작업은 씬 실행 취소 기록에 포함되지 않으므로 버전 관리를 사용하세요.

에이전트가 내 게임을 실행할 수 있나요?#

RQL 에디터 호출(PlayScene, StopScene)로 편집 중인 씬을 시작하고 중지할 수 있으며, gameLog 소스를 통해 게임이 출력한 내용을 읽을 수 있습니다. 실시간 게임 상태나 캡처된 런타임 오류를 읽게 하려면 게임에 옵트인 런타임을 추가하세요. 도구와 사용자 정의 도구를 참고하세요.

내 토큰은 어디에 저장되나요?#

클라우드 로그인 자격 증명은 ~/.ai-game-dev/credentials.json에 있습니다 (Windows에서는 DPAPI로 보호되고, 그 외 환경에서는 파일 모드 0600). 사용된 토큰을 포함한 독 자체의 설정은 user://godot-mcp-config.json에 일반 JSON으로 저장됩니다. 두 파일 모두 커밋하거나 공유하지 마세요. 구성을 참고하세요.

도구를 더 추가하려면 어떻게 하나요?#

AnimationPlayer, CSG, 내비게이션 또는 TileMapLayer 같은 영역을 위한 확장을 설치하거나, [AiToolType] 및 [AiTool] 속성을 사용해 C#으로 자체 도구를 작성하세요(사용자 정의 도구).

AI Game Developer는 Unity와 Unreal도 지원하나요?#

동일한 제품이 두 엔진 모두에 있습니다: Unity MCP와 Unreal MCP. 세 제품 모두 하나의 ai-game.dev 계정과 동일한 AI 클라이언트를 공유합니다.