本頁面由英文機器翻譯而成。閱讀英文原文。

引擎 · 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++ 專案。

1安裝 CLI

從 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 方式,現在就能用。

1從 Fab 安裝

透過 Epic Games Launcher 從 Fab 安裝 Unreal-MCP。

2啟用外掛程式

在編輯器中開啟 Edit → Plugins,找到 Unreal-MCP 並啟用它。

3開啟專案

重新開啟你的專案——外掛程式已預先編譯,無需建置。

02

連接

透過託管的雲端端點執行,或指向你自己的伺服器。

雲端

預設

使用裝置碼 OAuth 流程透過 ai-game.dev 連接 — 不必手動複製權杖。在 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 擴充功能 →