FAQ

Unreal Engine용 AI Game Developer 플러그인인 Unreal MCP에 대해 가장 많이 받는 질문에 짧게 답변합니다. 설정 단계는 Installation과 Getting started를 참고하세요.

일반#

Unreal MCP란 무엇인가요?#

Unreal Editor용 C++ 플러그인으로, 에디터 작업을 MCP 도구로 노출하여 Claude Code, Cursor, Copilot, Codex, Gemini 같은 AI 에이전트가 프로젝트를 살펴보고 변경할 수 있게 합니다. Unity, 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를 참고하세요.

Claude Code와 함께 작동하나요?#

네. unreal-mcp-cli setup-mcp claude-code --path ./YourProject를 실행하고 프로젝트 폴더에서 Claude Code를 시작한 뒤 레벨에 대해 질문하면 됩니다. 자세한 내용은 Connecting AI clients에 있습니다.

요구 사항#

어떤 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 또는 unreal-mcp-cli로 설치하세요.

어떻게 업데이트하나요?#

앱에서 Update Package가 나타나면 클릭하거나, unreal-mcp-cli update ./YourProject를 실행하세요. 후자는 이전 빌드 캐시도 정리합니다. Installation을 참고하세요.

플러그인이 출시 게임에 포함되나요?#

에디터 도구는 절대 포함되지 않습니다. 에디터 전용이기 때문입니다. 브리지를 포함한 플러그인 전체를 패키징된 빌드에서 제외하려면 .uproject의 플러그인 항목에 TargetDenyList를 추가하세요. 방법은 Installation에 나와 있습니다.

사용#

AI가 Unreal Editor에서 실제로 무엇을 할 수 있나요?#

RQL로 액터, 컴포넌트, 에셋, 레벨, DataTables, 게임플레이 태그, Project Settings, 블루프린트 그래프, 위젯, Level Sequences를 조회하고 변경하며, 블루프린트를 작성하고 컴파일하고, C++를 읽고 쓰고 컴파일하며, 에디터 Python을 실행하고, 콘솔 명령을 실행하고, 스크린샷을 캡처할 수 있습니다. Tools를 참고하세요.

에이전트가 한 작업을 실행 취소할 수 있나요?#

rql-mutate를 통한 변경은 각각 하나의 실행 취소 단계이므로 에디터에서 Ctrl+Z로 되돌릴 수 있습니다. Project Settings 쓰기, 게임플레이 태그 편집, 파일 변경(C++ 소스, 저장된 에셋)은 실행 취소 기록에 포함되지 않습니다. 이런 경우 버전 관리를 사용하세요.

Python을 사용할 방법이 있나요?#

네. python-execute는 전체 unreal API를 사용해 Python을 실행하며, unreal-mcp-cli exec는 터미널에서 Python을 실행합니다.

나만의 도구를 추가할 수 있나요?#

네, Unreal MCP를 포크하지 않고 모든 C++ 플러그인에서 추가할 수 있습니다. Custom tools를 참고하세요.

AI가 실행 중인 게임을 제어할 수 있나요?#

네, 직접 활성화한 경우에만 가능합니다. 런타임 연결은 Play In Editor, Standalone, 패키징된 Development 빌드에서 작동하며, 기본적으로 꺼져 있고, Shipping 빌드에서는 이를 컴파일해 넣지 않는 한 거부하며, 게임이 등록한 도구만 노출합니다. in-game tools를 참고하세요.

계정, 개인정보, 비용#

ai-game.dev 계정이 필요한가요?#

Cloud 모드에서는 필요합니다. 기기별로 한 번 기기 코드 방식으로 로그인합니다. Custom 모드에서는 로컬 gamedev-mcp-server를 대상으로 모든 것을 실행할 수 있습니다. authentication을 참고하세요.

완전히 오프라인 또는 로컬에서 작업할 수 있나요?#

로컬 서버와 함께 Custom 모드를 사용하세요. AI 클라이언트 자체는 모델 제공자에 접속하기 위해 별도의 인터넷 연결이 필요할 수 있습니다.

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

머신 로그인 정보는 ~/.ai-game-dev/credentials.json에 있으며, 프로젝트별 설정은 Saved/Config/UnrealMcp/에 있고 기본적으로 버전 관리에서 무시됩니다. 프로젝트 .env 파일을 절대 커밋하지 마세요. Configuration을 참고하세요.

플러그인에 비용이 드나요?#

플러그인과 unreal-mcp-cli는 Apache-2.0 라이선스로 오픈 소스입니다. AI 클라이언트의 구독은 AI Game Developer와 별개입니다.

추가 도움말#

• 특정 오류에 대해서는 Troubleshooting을 참고하세요.
• 일반 FAQ와 quickstart도 확인하세요.
• 한 페이지 개요는 Unreal Engine page를 참고하세요.