AI 编码助手

将受支持的编码代理连接到 Unreal Editor，以便它为你设置 Convai 角色并读取 Convai 的技能库。

Convai Unreal Engine 插件会将 Convai 工具集注册到引擎自带的模型上下文协议（MCP）插件中，新增七个 Convai 专用编辑器操作以及一套 Convai 技能文档，连接的编码代理可以读取并调用这些文档。安装 Convai 插件后，当你希望由 Claude Code 或 Cursor 之类的编码代理在你的 Unreal 项目中为你设置 Convai 角色、玩家和动作，而不是由你手动搭建时，请使用本节。

开始之前： AI 编码支持需要 Unreal Engine 5.8 或更高版本 并且仅存在于 编辑器 构建版本中—— ConvaiToolset 该模块在任何非 Editor 目标上都会抛出构建错误。在 UE 5.0–5.7 中，插件仍可编译，但 AI 编码工具并不存在。参见 AI 编码助手快速入门 获取完整的设置流程。

Convai 工具集新增了什么

引擎的 ModelContextProtocol 插件已经为连接的编码代理提供了用于编辑项目的通用 MCP 工具。在此基础上，Convai 工具集新增了七个可由 AI 调用的编辑器操作—— SetupConvaiCharacter, SetupConvaiPlayer, SetupConvaiPawnMovement, AddNavMeshVolumeForCurrentLevel, SetBlueprintPropertyAndPropagate, AddConvaiAction，以及 CreateConvaiActionHandler ——由引擎的 ToolsetRegistry 插件注册。参见 Convai 工具集参考 了解每个操作的作用及其参数。

插件还在 Content/Skills/ 下随附了 17 份技能文档，位于插件自身内容中，代理可通过工具集的 AgentSkillToolset (ListSkills 和 GetSkills) 列出并阅读这些文档。这些文档描述了 Convai 的工作流，例如项目设置、MetaHuman 设置、动作和动态上下文，因此代理在调用工具集操作之前可以先查阅某个功能的工作方式。参见 Convai AgentSkills 以查看完整列表。

受支持的编码代理

设置支持五种代理： Claude Code, Cursor, VS Code, Gemini，以及 Codex。每个代理都会获得自己的项目根上下文文件——例如 CLAUDE.md 适用于 Claude Code——如果你选择添加，还会带有一个由标记分隔的 Convai 导言块。参见 受支持的编码代理 了解确切的文件以及各代理的行为。

将编码代理连接到你的项目

打开 Convai 编辑器窗口，点击 设置 图标，然后选择 设置 AI 编码（MCP）。选择一个代理，设置安装选项，并在提示时重启编辑器。参见 AI 编码助手快速入门 获取完整的流程说明和验证步骤。

这与角色自己的 MCP 连接不同

本节讲的是在你使用 Unreal Editor 构建项目时，由编码代理调用 Convai 的编辑器工具。这与 MCP 服务器是不同的话题，后者讲的是 Convai 角色在与玩家进行实时对话时调用外部 MCP 服务器。

AI 编码助手页面

AI 编码助手快速入门 打开“设置 AI 编码（MCP）”，选择一个代理，并端到端验证设置。

受支持的编码代理 查找五个受支持代理各自的上下文文件、终端支持和代理特定选项。

Convai 工具集参考 七个可由 AI 调用的编辑器操作及其参数的参考。

Convai AgentSkills 17 份随附技能文档及代理如何列出和读取它们的参考。