# Unreal Engine — AI Game Developer Unreal Engine(5.5+)용 AI Game Developer 플러그인을 설치합니다. Fab와 unreal-mcp-cli, 두 가지 설치 경로와 AI 클라이언트 연결 방법, 첫 프롬프트 실행 방법을 안내합니다. 이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/engines/unreal). 엔진 · Unreal Engine Unreal-MCP 플러그인을 C++ 프로젝트에 설치하고 AI로 에디터를 제어합니다. Unreal Engine 5.5+ 5.7에서 테스트 완료 C++ 프로젝트 01 ## 플러그인 설치 프로젝트에 플러그인을 추가하는 두 가지 방법 중 워크플로에 맞는 방식을 선택하세요. 권장 ### CLI npm의 unreal-mcp-cli 도구로 설치합니다. 현재 모든 UE 5.5+ C++ 프로젝트에서 동작합니다. 1 CLI 설치 npm에서 전역으로 설치합니다: unreal-mcp-cli `npm install -g unreal-mcp-cli` 2 플러그인 설치 Unreal-MCP 플러그인을 프로젝트에 설치합니다. `unreal-mcp-cli install-plugin ./YourProject` 3 인증 ai-game.dev를 통해 플러그인이 연결할 수 있도록 로그인합니다. `unreal-mcp-cli login ./YourProject` 4 프로젝트 열기 Unreal Editor에서 프로젝트를 엽니다. `unreal-mcp-cli open ./YourProject` 출시 예정 ### Fab / Epic 마켓플레이스 Epic Games Launcher를 통해 Fab에서 Unreal-MCP 설치 — 미리 컴파일되어 있어 빌드가 필요 없습니다. 아직 Fab에 출시되지 않았으므로, 출시 전까지는 지금도 동작하는 CLI 방식을 사용하세요. 1 Fab에서 설치 Epic Games Launcher를 통해 Fab에서 Unreal-MCP 설치를 진행합니다. 2 플러그인 활성화 에디터에서 **Edit → Plugins** 경로로 이동한 뒤 **Unreal-MCP**을 찾아 활성화합니다. 3 프로젝트 열기 프로젝트를 다시 열면 됩니다. 플러그인이 미리 컴파일되어 있어 빌드할 것이 없습니다. 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 에이전트를 선택하고, Unreal Engine MCP 서버에 연결하는 정확한 `unreal-mcp-cli` 명령을 복사하세요. 사용할 AI 에이전트 **Claude Code** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Claude Code** 구성을 완료하세요: `unreal-mcp-cli setup-mcp claude-code --path ./YourProject` **Claude Desktop** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Claude Desktop** 구성을 완료하세요: `unreal-mcp-cli setup-mcp claude-desktop --path ./YourProject` **Cursor** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Cursor** 구성을 완료하세요: `unreal-mcp-cli setup-mcp cursor --path ./YourProject` **VS Code (Copilot)** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **VS Code (Copilot)** 구성을 완료하세요: `unreal-mcp-cli setup-mcp vscode-copilot --path ./YourProject` **Visual Studio (Copilot)** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Visual Studio (Copilot)** 구성을 완료하세요: `unreal-mcp-cli setup-mcp vs-copilot --path ./YourProject` **Rider (Junie)** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Rider (Junie)** 구성을 완료하세요: `unreal-mcp-cli setup-mcp rider-junie --path ./YourProject` **GitHub Copilot CLI** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **GitHub Copilot CLI** 구성을 완료하세요: `unreal-mcp-cli setup-mcp github-copilot-cli --path ./YourProject` **Gemini** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Gemini** 구성을 완료하세요: `unreal-mcp-cli setup-mcp gemini --path ./YourProject` **Antigravity** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Antigravity** 구성을 완료하세요: `unreal-mcp-cli setup-mcp antigravity --path ./YourProject` **Cline** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Cline** 구성을 완료하세요: `unreal-mcp-cli setup-mcp cline --path ./YourProject` **Open Code** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Open Code** 구성을 완료하세요: `unreal-mcp-cli setup-mcp open-code --path ./YourProject` **Codex** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Codex** 구성을 완료하세요: `unreal-mcp-cli setup-mcp codex --path ./YourProject` **Kilo Code** 프로젝트에서 이 명령을 실행해 Unreal Engine용 **Kilo Code** 구성을 완료하세요: `unreal-mcp-cli setup-mcp kilo-code --path ./YourProject` **구성 후에는 에이전트를 다시 시작하세요.** 새 MCP 서버는 에이전트를 완전히 다시 시작해야만 인식됩니다. 창만 새로고침하지 말고 에이전트를 완전히 종료한 뒤 다시 여세요. 04 ## 첫 실행 창을 열고 승인한 뒤 첫 프롬프트를 시도해 보세요. 1. 에디터의 **Tools** 메뉴에서 AI Game Developer 창을 엽니다. 2. **Cloud** 옵션을 선택하고 **Authorize** 버튼을 클릭해 디바이스 코드 흐름을 완료하세요. 3. 연결 표시가 녹색으로 바뀔 때까지 기다린 뒤 AI 클라이언트를 연결합니다. 4. 아래와 같은 프롬프트를 사용해 보고, 에디터에서 어떻게 동작하는지 확인해 보세요. 예시 프롬프트 ```text 정적 메시 큐브를 사용하는 새 Actor 블루프린트를 만들고 레벨에 세 개 배치해 주세요. ``` 더 많은 예시 프롬프트와 효과적인 AI 요청 패턴을 원하시나요? [Unreal Engine 모범 사례 보기 →](https://ai-game.dev/docs/best-practices/unreal) [Unreal Engine 플러그인은 AI 클라이언트에 **90개 MCP 도구**를 제공합니다.](https://ai-game.dev/docs/tools/unreal) Unreal Engine 도구 카탈로그 둘러보기 → 더 많은 도구가 필요하신가요? [Unreal Engine 확장 둘러보기 →](https://ai-game.dev/docs/extensions/unreal) --- Source (HTML): https://ai-game.dev/ko/engines/unreal Machine-translated (ko) from the English page: https://ai-game.dev/engines/unreal