# FAQ — Unreal Engine · AI Game Developer Wiki Unreal MCP에 관한 자주 묻는 질문의 답변 - 지원 엔진 버전, AI 클라이언트, 블루프린트 전용 프로젝트, Fab, 오프라인 사용, 비용, 패키징된 게임. 이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/docs/wiki/unreal/faq). Unreal Engine용 AI Game Developer 플러그인인 Unreal MCP에 대해 가장 많이 받는 질문에 짧게 답변합니다. 설정 단계는 [Installation](https://ai-game.dev/ko/docs/wiki/unreal/installation)과 [Getting started](https://ai-game.dev/ko/docs/wiki/unreal/getting-started)를 참고하세요. ## 일반 ### Unreal MCP란 무엇인가요? Unreal Editor용 C++ 플러그인으로, 에디터 작업을 MCP 도구로 노출하여 Claude Code, Cursor, Copilot, Codex, Gemini 같은 AI 에이전트가 프로젝트를 살펴보고 변경할 수 있게 합니다. [Unity](https://ai-game.dev/ko/docs/wiki/unity), [Godot](https://ai-game.dev/ko/docs/wiki/godot) 플러그인과 함께 AI Game Developer의 일부입니다. ### 안정적인가요? 현재 **베타** 단계입니다. 플러그인, 브리지, `unreal-mcp-cli`, 에디터 창은 출시되어 CI에서 테스트되며, 현재 릴리스는 0.26.2입니다. ### 어떤 AI 클라이언트가 지원되나요? 모든 MCP 클라이언트가 지원됩니다. `unreal-mcp-cli setup-mcp`와 에디터의 AI agent 섹션은 Claude Code, Claude Desktop, Cursor, VS Code 및 Visual Studio Copilot, Rider (Junie), GitHub Copilot CLI, Gemini, Antigravity, Cline, Open Code, Codex, Kilo Code용 설정 파일을 작성하며, 범용 `custom` 설정도 제공합니다. [Connecting AI clients](https://ai-game.dev/ko/docs/wiki/unreal/connecting-ai-clients#agents)를 참고하세요. ### Claude Code와 함께 작동하나요? 네. `unreal-mcp-cli setup-mcp claude-code --path ./YourProject`를 실행하고 프로젝트 폴더에서 Claude Code를 시작한 뒤 레벨에 대해 질문하면 됩니다. 자세한 내용은 [Connecting AI clients](https://ai-game.dev/ko/docs/wiki/unreal/connecting-ai-clients#claude-code)에 있습니다. ## 요구 사항 ### 어떤 Unreal Engine 버전이 지원되나요? Unreal Engine 5.5 이상입니다. 릴리스는 5.5, 5.6, 5.7, 5.8에서 검증됩니다. 선택적 확장 기능은 5.7 이상이 필요합니다. ### 어떤 운영체제를 지원하나요? Windows (x64), macOS (Apple silicon 및 Intel), Linux (x64)입니다. ### 블루프린트 전용 프로젝트에서 사용할 수 있나요? 플러그인은 프로젝트에 맞게 컴파일되므로 프로젝트에 C++ 지원이 필요합니다. 프로젝트에 C++ 클래스를 한 번 추가하면(C++ 프로젝트로 전환됨) 플러그인을 설치할 수 있습니다. 게임은 계속 블루프린트로 만들 수 있으며, 에이전트가 블루프린트를 대신 작성할 수도 있습니다. ### Node.js나 .NET이 필요한가요? AI Game Dev 앱을 사용한다면 필요하지 않습니다. `unreal-mcp-cli`는 Node.js가 필요합니다. .NET 9 SDK는 브리지를 소스에서 빌드할 때만 필요하며, 패키지 설치본에는 포함되어 있습니다. ## 설치 ### Fab이나 Epic Marketplace에 있나요? 아직 없습니다. Fab 등록을 계획 중입니다. 현재는 [AI Game Dev app](https://ai-game.dev/ko/docs/wiki/app/installation) 또는 `unreal-mcp-cli`로 설치하세요. ### 어떻게 업데이트하나요? 앱에서 **Update Package**가 나타나면 클릭하거나, `unreal-mcp-cli update ./YourProject`를 실행하세요. 후자는 이전 빌드 캐시도 정리합니다. [Installation](https://ai-game.dev/ko/docs/wiki/unreal/installation#update)을 참고하세요. ### 플러그인이 출시 게임에 포함되나요? 에디터 도구는 절대 포함되지 않습니다. 에디터 전용이기 때문입니다. 브리지를 포함한 플러그인 전체를 패키징된 빌드에서 제외하려면 `.uproject`의 플러그인 항목에 `TargetDenyList`를 추가하세요. 방법은 [Installation](https://ai-game.dev/ko/docs/wiki/unreal/installation#editor-only)에 나와 있습니다. ## 사용 ### AI가 Unreal Editor에서 실제로 무엇을 할 수 있나요? RQL로 액터, 컴포넌트, 에셋, 레벨, DataTables, 게임플레이 태그, Project Settings, 블루프린트 그래프, 위젯, Level Sequences를 조회하고 변경하며, 블루프린트를 작성하고 컴파일하고, C++를 읽고 쓰고 컴파일하며, 에디터 Python을 실행하고, 콘솔 명령을 실행하고, 스크린샷을 캡처할 수 있습니다. [Tools](https://ai-game.dev/ko/docs/wiki/unreal/tools)를 참고하세요. ### 에이전트가 한 작업을 실행 취소할 수 있나요? `rql-mutate`를 통한 변경은 각각 하나의 실행 취소 단계이므로 에디터에서 **Ctrl+Z**로 되돌릴 수 있습니다. Project Settings 쓰기, 게임플레이 태그 편집, 파일 변경(C++ 소스, 저장된 에셋)은 실행 취소 기록에 포함되지 않습니다. 이런 경우 버전 관리를 사용하세요. ### Python을 사용할 방법이 있나요? 네. `python-execute`는 전체 `unreal` API를 사용해 Python을 실행하며, `unreal-mcp-cli exec`는 터미널에서 Python을 실행합니다. ### 나만의 도구를 추가할 수 있나요? 네, Unreal MCP를 포크하지 않고 모든 C++ 플러그인에서 추가할 수 있습니다. [Custom tools](https://ai-game.dev/ko/docs/wiki/unreal/custom-tools)를 참고하세요. ### AI가 실행 중인 게임을 제어할 수 있나요? 네, 직접 활성화한 경우에만 가능합니다. 런타임 연결은 Play In Editor, Standalone, 패키징된 Development 빌드에서 작동하며, 기본적으로 꺼져 있고, Shipping 빌드에서는 이를 컴파일해 넣지 않는 한 거부하며, 게임이 등록한 도구만 노출합니다. [in-game tools](https://ai-game.dev/ko/docs/wiki/unreal/custom-tools#runtime)를 참고하세요. ## 계정, 개인정보, 비용 ### ai-game.dev 계정이 필요한가요? Cloud 모드에서는 필요합니다. 기기별로 한 번 기기 코드 방식으로 로그인합니다. Custom 모드에서는 로컬 `gamedev-mcp-server`를 대상으로 모든 것을 실행할 수 있습니다. [authentication](https://ai-game.dev/docs/auth)을 참고하세요. ### 완전히 오프라인 또는 로컬에서 작업할 수 있나요? 로컬 서버와 함께 Custom 모드를 사용하세요. AI 클라이언트 자체는 모델 제공자에 접속하기 위해 별도의 인터넷 연결이 필요할 수 있습니다. ### 토큰은 어디에 저장되나요? 머신 로그인 정보는 `~/.ai-game-dev/credentials.json`에 있으며, 프로젝트별 설정은 `Saved/Config/UnrealMcp/`에 있고 기본적으로 버전 관리에서 무시됩니다. 프로젝트 `.env` 파일을 절대 커밋하지 마세요. [Configuration](https://ai-game.dev/ko/docs/wiki/unreal/configuration#credentials)을 참고하세요. ### 플러그인에 비용이 드나요? 플러그인과 `unreal-mcp-cli`는 Apache-2.0 라이선스로 오픈 소스입니다. AI 클라이언트의 구독은 AI Game Developer와 별개입니다. ## 추가 도움말 - 특정 오류에 대해서는 [Troubleshooting](https://ai-game.dev/ko/docs/wiki/unreal/troubleshooting)을 참고하세요. - 일반 [FAQ](https://ai-game.dev/docs/faq)와 [quickstart](https://ai-game.dev/ko/docs/quickstart)도 확인하세요. - 한 페이지 개요는 [Unreal Engine page](https://ai-game.dev/ko/engines/unreal)를 참고하세요. --- Source (HTML): https://ai-game.dev/ko/docs/wiki/unreal/faq Machine-translated (ko) from the English page: https://ai-game.dev/docs/wiki/unreal/faq