언리얼 엔진에 Claude Code·Codex 연결하기

NarshaADK는 Fab 제품명입니다. 플러그인 폴더, 코드 모듈, 실행 파일의 이름은 NarshaMCP입니다. 사용 중인 MCP 클라이언트와 연결해 사용합니다.

요구사항

Windows 64비트, Unreal Engine 5.7 또는 5.8 C++ 프로젝트.
Unreal Engine C++ 빌드 도구가 포함된 Visual Studio 2022.
연결이 검증된 MCP 클라이언트인 Claude Code 또는 Codex. 별도 제품이며 구독이 필요할 수 있습니다.
런타임은 빌드된 실행 파일로 제공하므로 Python이나 Node.js를 설치할 필요가 없습니다.

Blueprint 전용 프로젝트는 지원하지 않습니다. 설치 전 지원 환경과 제한 사항을 확인하세요.

설치

Fab 제품 페이지에서 NarshaADK를 설치하고 C++ 프로젝트에서 NarshaMCP 플러그인을 활성화합니다.
프로젝트를 한 번 빌드합니다. 첫 빌드에서 로컬 설정과 MCP 연결 구성을 생성합니다. 단, plugin-only 모드로 설치한 경우는 제외됩니다. 심볼 분석에 필요한 PDB도 이 빌드에서 생성됩니다.
로컬 대시보드의 AI Clients에서 Claude Code 또는 Codex 연결을 확인합니다.

Unreal Engine 버전에 맞는 패키지를 사용하세요. 업그레이드 전에는 프로젝트를 백업하고, 복원이 필요할 경우를 대비해 기존 플러그인을 복사해 두세요. 현재 다운로드 방법, 가격과 라이선스는 Fab 제품 페이지에서 확인하세요.

MCP 클라이언트 연결

첫 빌드에서 보통 구성이 자동 생성됩니다. 수동 연결 시 플러그인에 포함된 런타임을 지정하세요. Codex TOML의 경로에는 슬래시(/)를 사용합니다.

<Project>를 실제 프로젝트의 절대 경로로 바꾸세요. 코드와 도구 이름은 두 언어에서 동일합니다.

{
  "mcpServers": {
    "narshamcp": {
      "command": "<Project>/Plugins/NarshaMCP/Source/ThirdParty/bin/narshamcp.exe",
      "args": ["connect", "--project-path", "<Project>"],
      "env": { "RUST_LOG": "error" }
    }
  }
}

Claude Code

claude mcp add narshamcp -- "<Project>/Plugins/NarshaMCP/Source/ThirdParty/bin/narshamcp.exe" connect --project-path "<Project>"

Codex — ~/.codex/config.toml

[mcp_servers.narshamcp]
command = "<Project>/Plugins/NarshaMCP/Source/ThirdParty/bin/narshamcp.exe"
args = ["connect", "--project-path", "<Project>"]

connect는 프로젝트의 백그라운드 데몬에 연결하며, 실행 중인 데몬이 없으면 시작합니다. Cursor처럼 서버를 직접 프로세스로 실행하는 클라이언트는 connect 대신 --stdio를 사용합니다.

연결 확인

클라이언트에 ue_check_health 호출을 요청하세요. 응답에 status와 version이 포함됩니다. 첫 시작 시 빌드에서 생성한 PDB를 인덱싱합니다.

응답	확인할 내용
`symbol_index_loading`	인덱싱 중입니다. 전체 수량을 확인하면 `progress` 객체가 표시됩니다. 완료 후 심볼 작업을 다시 호출하세요.
`symbol_index_degraded_budget`	메모리 예산으로 인덱스가 제한되었습니다. 기다려도 해제되지 않습니다. 완전한 심볼 결과로 판단하기 전에 상태와 인덱스 설정을 확인하세요.

Early Access 기간에는 도구 매개변수가 변경될 수 있습니다. ue_tool_docs로 현재 작업과 매개변수를 확인하고, 클라이언트의 tools/list로 도구 목록을 확인하세요.

첫 분석 실행

프로젝트에 있는 함수를 지정해 “이 C++ 함수를 호출하는 Blueprint는?”이라고 요청해 보세요. Lyra 실행 사례에서 실제 요청·응답과 한계를 확인할 수 있습니다.

대부분의 읽기는 에디터 종료 상태에서 동작하며 에셋 수정에는 실행 중인 에디터가 필요합니다. 도움이 필요하면 Fab 제품 페이지의 지원 채널을 이용하세요.