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

엔진 · Unreal Engine

Unreal Engine사용 가능

Unreal-MCP 플러그인을 C++ 프로젝트에 설치하고 AI로 에디터를 제어합니다.

Unreal Engine 5.5+5.7에서 테스트 완료C++ 프로젝트
01

플러그인 설치

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

권장

CLI

npm의 unreal-mcp-cli 도구로 설치합니다. 현재 모든 UE 5.5+ C++ 프로젝트에서 동작합니다.

1CLI 설치

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 방식을 사용하세요.

1Fab에서 설치

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 엔드포인트 페이지에 있습니다.

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

03

AI 에이전트 구성

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

사용할 AI 에이전트

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

unreal-mcp-cli setup-mcp claude-code --path ./YourProject

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

04

첫 실행

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

  1. 에디터의 Tools 메뉴에서 AI Game Developer 창을 엽니다.
  2. Cloud 옵션을 선택하고 Authorize 버튼을 클릭해 디바이스 코드 흐름을 완료하세요.
  3. 연결 표시가 녹색으로 바뀔 때까지 기다린 뒤 AI 클라이언트를 연결합니다.
  4. 아래와 같은 프롬프트를 사용해 보고, 에디터에서 어떻게 동작하는지 확인해 보세요.
예시 프롬프트
정적 메시 큐브를 사용하는 새 Actor 블루프린트를 만들고 레벨에 세 개 배치해 주세요.

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

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

Unreal Engine 도구 카탈로그 둘러보기 →

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