上篇《Unity 放出 29 个官方 Skill》记了官方技能插件，这篇把另一个容易被问混的东西单独记一页：Unity 官方的 MCP Server。查资料时我最关心的问题是「官方有没有指定 MCP 版本」，翻完官方博客和入门文档后发现答案和直觉不太一样，值得记下来。
一、官方到底指定了什么版本
先说结论：官方没有锁定 MCP 协议的规范版本。博客和文档通篇没有出现 2024-11-05、2025-03-26 这类协议日期版本号，协议兼容性由官方组件自己负责，使用者不用操心。
官方明确「指定」的是 Unity 这一侧的门槛：
- 引擎版本：Unity 6（6000.0）或更高；
- 包版本：随官方
com.unity.ai.assistant包分发（AI 工具目前处于 open beta，文档当前对应 2.7.0-pre.3），MCP server 内置在这个包里。
架构一句话：MCP server 本体（官方叫 Unity Bridge）内置在编辑器进程里；编辑器启动时会把一个 relay 二进制装到本机 ~/.unity/relay/，外部 AI 客户端连接的就是这个 relay——它以 --mcp 参数启动为本地 stdio 进程。文档没提任何端口号。
二、部署步骤（编辑器侧）
- Unity 6 项目里通过 Package Manager 安装/启用
com.unity.ai.assistant； - 编辑器启动时 bridge 自动运行，relay 自动装好，不需要手动下载任何东西；
- 验证：Edit > Project Settings > AI > Unity MCP Server，看到 Unity Bridge 是绿色 Running 就绪；如果显示 Stopped，点一下 Start；
- 接客户端：同一个设置页的 Integrations 区可以选客户端（Claude Code、Cursor、Windsurf、Claude Desktop）一键 Configure，能不手写就不手写。
三、手动配置客户端 JSON（Windows 为例）
想手动配 mcpServers 的话，官方给的格式是（以 Claude Code 为例，Cursor 相同）：
{
"mcpServers": {
"unity-mcp": {
"command": "C:\\Users\\<用户名>\\.unity\\relay\\relay_win.exe",
"args": ["--mcp"]
}
}
}其他平台路径：macOS 在 ~/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64（Intel 芯片是 relay_mac_x86_64），Linux 是 ~/.unity/relay/relay_linux。
两个官方特别强调的坑：
- 必须写绝对路径：很多 MCP 客户端不会展开
~，写波浪号会直接连不上； - 多开 Unity 时要指定实例：加
--project-path <项目路径>或--instance-id <编辑器进程 pid>（也可用环境变量UNITY_PROJECT_PATH/UNITY_INSTANCE_ID），命令行参数优先于环境变量。
四、别把三个东西搞混
查资料时名字很像的三样东西，我给自己画了个表区分：
| 名称 | 性质 | 作用 |
|---|---|---|
| Unity Bridge + relay | 官方，随 com.unity.ai.assistant 包内置 | MCP Server：让外部 AI 客户端读写编辑器 |
unity-agent-plugin | 官方插件（Claude Code / Codex，0.1.0-beta） | 31 个官方 Skill（即上篇笔记的主角），不是 MCP server |
mcp-unity（codergamester） | 社区第三方项目 | 与官方无关的社区方案，别误当成官方 |
前两个是官方、可以配合用：agent-plugin 提供领域技能，MCP bridge 提供对编辑器的实时操作。插件安装一行命令：
/plugin marketplace add Unity-Technologies/unity-agent-plugin
/plugin install unity@unity-agent-plugin五、小结
版本口径记一句话就够：引擎要 Unity 6000.0+，MCP 能力随 com.unity.ai.assistant 包走（beta），协议版本不用自己管。部署上真正要动手的只有两件事：确认 bridge 在 Project Settings 里是 Running，以及给客户端配一条指向 relay 绝对路径的 mcpServers 记录。等我把 DeepSeek Harness 那套跑通（见这篇笔记），就按这个步骤把编辑器接上试试。