# Godot — AI Game Developer

Godot 4.3–4.5(C# / .NET 8)용 AI Game Developer 애드온을 설치합니다. Asset Library / GitHub 릴리스와 godot-cli, 두 가지 설치 경로와 AI 클라이언트 연결 방법, 첫 프롬프트 실행 방법을 안내합니다.

이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/engines/godot).

엔진 · Godot

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

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

01

## 플러그인 설치

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

권장

### CLI

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

1 CLI 설치

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

`npm install -g godot-cli`

2 플러그인 설치

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

`godot-cli install-plugin ./MyGodotProject`

3 AI 클라이언트 연결

클라이언트(예: 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 패키지를 추가하고 플러그인을 활성화합니다.

[에셋 라이브러리에서 보기](https://godotengine.org/asset-library/asset/5245)

1 애드온 설치

Godot **AssetLib** 탭에서 `godot_mcp`을 받거나 [GitHub Releases](https://github.com/IvanMurzak/Godot-MCP/releases) 페이지에서 zip을 내려받아 프로젝트의 `addons/` 폴더에 넣습니다.

2 NuGet 패키지 추가

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

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 엔드포인트 페이지](https://ai-game.dev/mcp-endpoint-info)에 있습니다.

클라이언트 설정 스니펫(Claude, Cursor, Copilot, Gemini 등)이 필요하신가요? [MCP 엔드포인트 페이지 보기 →](https://ai-game.dev/mcp-endpoint-info)

03

## AI 에이전트 구성

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

사용할 AI 에이전트

**Claude Code**

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

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

**Claude Desktop**

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

`godot-cli setup-mcp claude-desktop ./MyGodotProject`

**Cursor**

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

`godot-cli setup-mcp cursor ./MyGodotProject`

**VS Code (Copilot)**

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

`godot-cli setup-mcp vscode-copilot ./MyGodotProject`

**Visual Studio (Copilot)**

프로젝트에서 이 명령을 실행해 Godot용 **Visual Studio (Copilot)** 구성을 완료하세요:

`godot-cli setup-mcp vs-copilot ./MyGodotProject`

**GitHub Copilot CLI**

프로젝트에서 이 명령을 실행해 Godot용 **GitHub Copilot CLI** 구성을 완료하세요:

`godot-cli setup-mcp github-copilot-cli ./MyGodotProject`

**Codex**

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

`godot-cli setup-mcp codex ./MyGodotProject`

**Gemini**

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

`godot-cli setup-mcp gemini ./MyGodotProject`

**Cline**

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

`godot-cli setup-mcp cline ./MyGodotProject`

**Rider (Junie)**

프로젝트에서 이 명령을 실행해 Godot용 **Rider (Junie)** 구성을 완료하세요:

`godot-cli setup-mcp rider-junie ./MyGodotProject`

**Kilo Code**

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

`godot-cli setup-mcp kilo-code ./MyGodotProject`

**Open Code**

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

`godot-cli setup-mcp open-code ./MyGodotProject`

**Antigravity**

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

`godot-cli setup-mcp antigravity ./MyGodotProject`

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

04

## 첫 실행

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

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

예시 프롬프트

```text
Camera3D와 MeshInstance3D 큐브가 있는 Node3D 씬을 추가하고 Main.tscn으로 저장합니다.
```

더 많은 예시 프롬프트와 효과적인 AI 요청 패턴을 원하시나요? [Godot 모범 사례 보기 →](https://ai-game.dev/docs/best-practices/godot)

[Godot 플러그인은 AI 클라이언트에 **99개 MCP 도구**를 제공합니다.](https://ai-game.dev/docs/tools/godot)

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

더 많은 도구가 필요하신가요? [Godot 확장 둘러보기 →](https://ai-game.dev/docs/extensions/godot)

---

Source (HTML): https://ai-game.dev/ko/engines/godot

Machine-translated (ko) from the English page: https://ai-game.dev/engines/godot