GameDevelop/UnrealEngine

UnrealEngine 5.8 공식 MCP / Codex 연동 튜토리얼

Une_ 2026. 7. 6. 02:18

UnrealEngine 5.8 공식 MCP / Codex 연동 튜토리얼

 

 

 

 

1. Edit - Plugins 창 클릭

 

 

2.

Plugins 창에서

mcp 검색하여 Unreal MCP 체크

 

 

3.

Plugins 창에서

toolset 검색하여 

- Toolset Registry 활성화

- AllToolsets 활성화

 

 

4. Edit - Edit Preferences

 

5.

Model Context Protocol 클릭

- Auto Start Server 체크

 

 

6.

언리얼엔진 재시작 한 번 해줍니다.

 

 

7.

언리얼엔진 콘솔창 ( ~ 또는 ` 키로 오픈) 에 아래 명령 입력.

ModelContextProtocol.GenerateClientConfig Codex

 

 

8.

해당 프로젝트 루트에 생성된 아래 파일 확인

 

 

 

프로젝트마다 세팅하기 싫다면 아래 경로의 toml에 텍스트를 추가해줘야 합니다~

C:\Users\<사용자명>\.codex\config.toml

[mcp_servers.unreal-mcp]
url = "http://127.0.0.1:8000/mcp"

단, 이 경우에는 언리얼엔진 프로젝트가 아닌 경로에서도

Codex를 기동할 때마다 Unreal mcp 서버를 연결하려는 시도를 하기 때문에 

비권장합니다.

 

 

 

9.

언리얼엔진 기동된 상태에서

해당 프로젝트 루트에서 Codex 실행.

 

'/mcp' 명령어로 목록에 잘 뜨는지 확인.

 

 

10. 

간단한 명령으로 테스트.

현재 레벨에 테스트용 큐브 액터를 하나 만들고 이름을 MCP_TestCube로 바꿔줘.
위치는 X=200, Y=0, Z=100으로 배치해줘.