Unity MCP:Codex 与 ChatGPT 连接教程
Codex、ChatGPT 怎么接 Unity MCP?Unity 侧与安装教程相同;Codex 用 Open/Copy,ChatGPT 填 STDIO(启动命令、端口、含 Assets 工程根),Hierarchy 验收。含 MCP 安装连接、AI Studio 实操步骤与验收清单,VberAI 官方博客教程。
- unity
- mcp
- codex
- chatgpt
- tutorial
- unity-mcp
- ai
本教程能帮你完成什么
如何把 Codex 或 ChatGPT 接到 Unity MCP? Unity 侧(导入包、激活、启动 Server)与 Unity MCP 安装教程、Claude Code 连接 Unity MCP 相同——本文只讲 客户端 MCP 配置(Codex Open/Copy、ChatGPT STDIO 填表)。
本文覆盖两条常见路径:
- Codex CLI:Unity MCP 面板 One-click Configuration(快速配置) 里选 Codex CLI,可 Open 自动配置,或 Copy 得到
config.toml片段 - ChatGPT 桌面端 / 网页版:没有「Open」,需把 Copy 出来的参数 手工填进 MCP 设置界面(STDIO + relay 路径 + 端口 + Unity 工程工作目录)
完成后你应能:
- Unity 里 Unity MCP Server 为 运行中,端口与面板一致
- 客户端里注册 unity-mcp(或等价名称),并看到 tools 列表
- 用只读提示列出 当前打开场景 的 Hierarchy 根节点
产品页:Unity MCP
前置条件
| 项目 | 说明 |
|---|---|
| Unity | 建议 2022.3+ / Unity 6(以官网为准) |
| Unity MCP | 已导入、已激活(步骤见 安装教程) |
| Server 运行中 | 面板显示 运行中(Running);记下 端口号(常见默认 6589,以面板为准) |
| Codex CLI 或 ChatGPT | 支持 MCP,可添加 STDIO 类 MCP 服务器 |
| Unity 工程 | 目标项目已在 Unity 中打开 |
| 本机网络 | MCP 桥接通常在 127.0.0.1,勿将端口暴露到公网 |
端口不是写死的。 Copy 配置里的
--port必须与 Unity MCP 面板当前端口 完全一致(示例里可能是6589、4008等,以面板为准)。
第一部分:Unity 侧(与安装教程相同)
若尚未安装,请按 Unity MCP 安装教程 完成:
- Package Manager → 从磁盘添加包
- MCP 面板 完成激活
- 启动服务 → 状态 运行中
- 工具管理 中勾选需要的工具
以下假设 Unity 侧已为 运行中,直接进入客户端配置。
第二部分:Codex CLI(推荐:面板一键)
- Unity MCP 面板 → 快速配置 / One-click Configuration
- 选择 Codex CLI
- 任选其一:
- Open:由面板写入 Codex 的 MCP 配置(最省事)
- Copy:得到类似下面的 TOML,粘贴到 Codex 使用的
config.toml(路径以 Codex 文档为准)
Copy 示例(路径与端口请用你面板生成的内容,不要照抄下文):
[mcp_servers.unity-mcp]
command = "/Users/<你>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<面板端口>"]
- 重启 Codex CLI(或按 Codex 要求 Reload MCP)
- 确认列表中出现 unity-mcp 及 tools 列表
更完整的 CLI 安装上下文见 Claude Code 连接教程(步骤 1–4 与 Unity 侧相同,仅客户端不同)。
第三部分:ChatGPT 桌面端 / 网页版(手工填表)
在 Unity MCP 面板 Codex CLI → Copy 得到 relay 配置后,把 TOML 里的 command / args 填进 ChatGPT。新建 MCP 时可能还有名称、类型(选 STDIO);更新 已有 Unity-mcp 时字段与下表一致(见截图)。
| ChatGPT 界面(中文) | 填什么 |
|---|---|
| 名称(新建时) | unity-mcp(与 TOML [mcp_servers.unity-mcp] 一致即可) |
| 类型(新建时) | STDIO(勿选 HTTP/SSE) |
| 启动命令 | command = "..." 的完整绝对路径,指向 unity-mcp-relay(Windows 用 Copy 里的路径,勿照抄 macOS 示例) |
| 参数 | 分三行:--stdio → --port → 面板端口号(纯数字) |
| 环境变量 | 留空 |
| 环境变量传递 | 留空 |
| 工作目录 | Unity 工程根(含 Assets 的文件夹),勿用默认的 ~/code 等 |
ChatGPT 桌面版界面示意

图中 relay 路径、端口、工程目录 仅为示例;请用 Unity MCP 面板 Copy 的内容与本机 含 Assets 的工程根。
点击 保存,完全退出并重启 ChatGPT 桌面客户端(网页版:刷新后重新进入会话),再试 MCP。
为什么必须填工作目录?
Relay 通过 STDIO 与 ChatGPT 对话,但仍需知道你要操作 哪一个 Unity 工程。工作目录应指向 当前在 Unity 里打开的项目根路径;工程切换时,这里也要改成新项目路径。
配置含义(读懂 Copy 出来的参数)
unity-mcp-relay:本机 relay,把 MCP 客户端与 Unity 里已启动的 Unity MCP Server 连起来--stdio:以子进程标准输入输出方式接入 ChatGPT/Codex--port:须与面板 运行中 服务的端口一致;未启动或端口不对会 连接失败或超时
连接成功后的验收
在 Codex 或 ChatGPT 中先发只读提示,例如:
请通过 MCP 列出当前 Unity 活动场景的 Hierarchy 根 GameObject。
若与 Unity Hierarchy 一致,再试小写入(如创建空物体 MCP_SmokeTest 后删除)。大改前先提交版本控制。
排障(服务已运行但编辑器不在 active instances 列表):见 Unity MCP 安装 FAQ。
与 Cursor / Claude Code 的差异(一句话)
| 客户端 | Unity 面板典型操作 |
|---|---|
| Cursor | 快速配置 → 自动配置 |
| Claude Code / Gemini CLI | 快速配置 → Copy CLI command → 终端执行 |
| Codex CLI | 快速配置 → Open 或 Copy → config.toml |
| ChatGPT 桌面/网页 | Copy relay 参数 → 按上表填 STDIO 表单 |
支持哪些客户端的总览:Unity MCP 支持哪些 AI?
常见问题
Copy 里是 Codex CLI,ChatGPT 也能用吗?
可以。relay 的 command + args 与客户端无关;ChatGPT 使用同一组 启动命令 / 参数,并务必填对 工作目录。
ChatGPT 里 MCP 连接失败?
依次查:Unity 运行中;--port 与面板一致;relay 路径存在且可执行;工作目录 指向含 Assets 的工程根;保存 后是否 重启客户端。
Codex 里看不到 Unity tools?
优先用面板 Open 重配;或核对 config.toml 与 Copy 完全一致后重启 Codex。仍无效 → active instances。
还要自己手写 C# 吗?
日常脚本可由 AI 经 Unity MCP 创建/修改并挂到 GameObject;你负责 改动审查、编译与 Play 模式验收。架构、联机、性能热点仍建议人工把关(见 Unity MCP 支持哪些 AI FAQ)。
下一步
- 提示写法与习惯:Cursor / Claude Code 操作 Unity MCP
- 是否值得装 MCP:Godot 要不要装 MCP?(Godot 同理,本文仅 Unity)
继续阅读
你可能还会喜欢这些文章
Godot 要不要装 MCP?AI 操作编辑器指南
Godot 开发要不要装 MCP:对照纯代码助手与 VberAI Studio,说明何时需要 VberAI Godot MCP 让 Cursor 等 AI 操作编辑器,以及启用与验收最短路径。很多人搜 Godot 要不要装 MCP、怎么让 AI 操作 Godot 编辑器,其实是在问两件事:没有 MCP 时 AI 能帮…
- godot
- godot-mcp
- mcp
- cursor
VberAI 官网:是什么?游戏开发平台、MCP 与 AI Studio
VberAI 官网与游戏开发平台入口:Unity / Godot / Cocos Engine MCP、AI Studio(切图/翻译/换皮)、AI 超强抠图,分别处在游戏生产链路的哪一段。VberAI(www.vberai.com)面向游戏开发——游戏团队里常同时出现三件事:编辑器里要改场景和预制体、设计侧持续交付…
- vberai
- mcp
- ai-studio
- ai-super-matting
VberAI 位图字体生成器:上传字形 / 精灵图拆分,BMFont 进 Unity
VberAI Studio 位图字体生成器:支持上传字形图片、上传精灵图自动拆分,输出 AngelCode BMFont(.fnt + PNG),画布可编辑,再导入 Unity / Godot / Cocos。VberAI Studio(短称 AI Studio,≠ Google AI Studio)支持位图字体生成…
- vberai
- ai-studio
- bitmap-font
- bmfont