이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

엔진 · Godot

Godot사용 가능

C# Godot 프로젝트에 godot_mcp 애드온을 추가하고 AI로 에디터를 제어해 보세요.

Godot 4.3–4.5C# / .NET 8 (mono)
01

플러그인 설치

프로젝트에 플러그인을 추가하는 두 가지 방법 중 워크플로에 맞는 방식을 선택하세요.

권장

CLI

npm의 godot-cli 도구로 설치합니다. install-plugin는 일치하는 GitHub 릴리스에서 godot_mcp 애드온을 내려받고, 두 개의 NuGet 패키지와 확장 카탈로그 임베드를 .csproj에 추가한 뒤 플러그인을 활성화합니다. 모두 멱등적으로 동작합니다.

1CLI 설치

npm에서 전역으로 설치합니다: godot-cli

npm install -g godot-cli
2플러그인 설치

애드온을 내려받고, .csproj에 NuGet 패키지를 추가한 뒤 project.godot에서 godot_mcp를 활성화합니다.

godot-cli install-plugin ./MyGodotProject
3AI 클라이언트 연결

클라이언트(예: Claude Code)용 MCP 설정을 생성합니다.

godot-cli setup-mcp claude-code ./MyGodotProject
4열고 대기

프로젝트를 열고 에디터가 준비될 때까지 기다립니다.

godot-cli open ./MyGodotProject

프로젝트를 연 뒤에는 에디터 준비 상태를 기준으로 스크립트 실행을 제어할 수도 있습니다: godot-cli wait-for-ready ./MyGodotProject.

에셋 라이브러리

Godot 에셋 라이브러리(GitHub Releases의 동일한 zip 파일도 가능)에서 godot_mcp 애드온을 설치한 뒤, 두 개의 NuGet 패키지를 추가하고 플러그인을 활성화합니다.

에셋 라이브러리에서 보기
1애드온 설치

Godot AssetLib 탭에서 godot_mcp을 받거나 GitHub Releases 페이지에서 zip을 내려받아 프로젝트의 addons/ 폴더에 넣습니다.

2NuGet 패키지 추가

프로젝트 .csproj에 두 패키지를 추가합니다. com.IvanMurzak.ReflectorNet 버전 5.4.3, com.IvanMurzak.McpPlugin 버전 8.7.1, 그리고 addons/godot_mcp/extensions.catalog.json EmbeddedResource까지 추가합니다(없으면 Extensions 패널이 비어 있습니다). 정확한 코드 블록은 Godot-MCP README에 있습니다.

3플러그인 활성화

에디터에서 Project → Project Settings → Plugins로 이동한 뒤 godot_mcp을 활성화합니다.

4열고 빌드

프로젝트를 다시 열면 Godot 이 새 패키지로 C# 솔루션을 빌드합니다.

02

연결

호스팅된 클라우드 엔드포인트를 사용하거나 자체 서버를 지정하세요.

클라우드

기본

ai-game.dev에서 디바이스 코드 OAuth 흐름으로 연결하세요. 토큰을 직접 복사할 필요가 없습니다. AI Game Developer 창에서 Cloud 옵션을 선택하고 Authorize 버튼을 클릭한 뒤 브라우저에서 디바이스 코드를 승인하세요. 방화벽 환경에서도 작동하며 사용 분석을 제공합니다. 기본 방식이며 대부분의 사용자에게 권장합니다.

사용자 지정

모든 것을 로컬에서 실행하고 싶나요? 호스팅 엔드포인트 대신 자체 gamedev-mcp-server 인스턴스를 플러그인에 지정하세요. 그러면 AI 클라이언트가 바로 내 컴퓨터와 통신합니다. 클라이언트별 설정 스니펫은 MCP 엔드포인트 페이지에 있습니다.

클라이언트 설정 스니펫(Claude, Cursor, Copilot, Gemini 등)이 필요하신가요? MCP 엔드포인트 페이지 보기 →

03

AI 에이전트 구성

사용하는 AI 에이전트를 선택하고, Godot MCP 서버에 연결하는 정확한 godot-cli 명령을 복사하세요.

사용할 AI 에이전트

프로젝트에서 이 명령을 실행해 Godot용 Claude Code 구성을 완료하세요:

godot-cli setup-mcp claude-code ./MyGodotProject

구성 후에는 에이전트를 다시 시작하세요. 새 MCP 서버는 에이전트를 완전히 다시 시작해야만 인식됩니다. 창만 새로고침하지 말고 에이전트를 완전히 종료한 뒤 다시 여세요.

04

첫 실행

창을 열고 승인한 뒤 첫 프롬프트를 시도해 보세요.

  1. Godot 에디터에서 프로젝트를 열고 AI Game Developer 독을 엽니다.
  2. Cloud 옵션을 선택하고 Authorize 버튼을 클릭해 디바이스 코드 흐름을 완료하세요.
  3. 상태가 녹색으로 바뀔 때까지 기다린 뒤 AI 클라이언트를 연결합니다.
  4. 아래와 같은 프롬프트를 사용해 보고, 에디터에서 어떻게 동작하는지 확인해 보세요.
예시 프롬프트
Camera3D와 MeshInstance3D 큐브가 있는 Node3D 씬을 추가하고 Main.tscn으로 저장합니다.

더 많은 예시 프롬프트와 효과적인 AI 요청 패턴을 원하시나요? Godot 모범 사례 보기 →

Godot 플러그인은 AI 클라이언트에 99개 MCP 도구를 제공합니다.

Godot 도구 카탈로그 둘러보기 →

더 많은 도구가 필요하신가요? Godot 확장 둘러보기 →