1. Unity-MCP 到底是什么为什么值得在编辑器里接一条 AI 通道Unity-MCP 是一套把 Unity 编辑器暴露成「可被自然语言调用」的工具链它由两部分组成跑在本机的 MCP 服务器Python 后端和挂在 Unity 里的 C# 插件桥接层。MCP 全称 Model Context Protocol你可以把它理解成 AI 客户端和本地工具之间的一份「对话契约」——AI 不需要知道 Unity 的 C# API 长什么样只要按契约发出「创建物体」「修改属性」「导入资源」这类结构化请求桥接层负责翻译成编辑器里真实执行的操作。它能做的事很具体在场景里批量生成物体、改 Transform、切图层、挂材质、导入 FBX、读取 Console 日志、进出 Play Mode。适合谁独立开发者、做原型验证的策划、以及被重复拖拽操作磨掉耐心的程序。你不需要先写一堆 Editor 脚本直接用一句话描述意图AI 拆成若干条命令下发。但这里有个现实问题AI 客户端要调用模型就得有稳定的 API 入口和一把能统一管理的 Key。Unity-MCP 本身只负责「Unity 这一侧」的桥接模型侧怎么接、Key 放哪、Base URL 填什么是另一条链路。这篇就聚焦这条链路的配置起点——用 TaoToken 统一 Key/API把 settings.json 骨架搭起来再验证 AI 和 Unity 的对话是否真的通了。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。很多人卡住不是因为 Unity 插件装不上而是模型侧配置写错了一个字段导致请求发出去石沉大海。下面从环境准备一路走到连通性验证每一步都给可复制的片段。2. 前置准备Unity 版本、Python 环境与 TaoToken Key 的获取先把地基打平。Unity 侧建议 2022.3 LTS 及以上2020.3 也能跑但部分编辑器 API 覆盖不全。Python 用 3.10包管理器推荐 uv装依赖比裸 pip 干净。Node.js 18 在部分 MCP 客户端里会用到顺手装上不亏。Unity 插件安装走 Package Manager 的 git URL 方式在manifest.json里加一行依赖或者直接在 Package Manager 里 Add package from git URL。装完点Window → Unity MCP控制台出现 Connected 就说明桥接层活了。这一步和模型无关先把 Unity 这侧跑通。接下来是模型侧。打开 TaoToken 控制台进 API Keys 页面创建一把 Key。地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建时给它起个能认出来的名字比如unity-mcp-dev方便以后按项目区分。Key 只在创建时完整显示一次复制下来存到本地密码管理器别直接贴进会提交到 Git 的文件里。模型 ID 这块做 Unity 编辑器操作这类任务选一个指令跟随稳、工具调用能力好的模型即可。你可以在模型对话页先试几句确认这个模型对结构化指令的响应符合预期再去配 MCP。模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。这里要强调一个概念Base URL 和 Key 是两件事。Base URL 告诉客户端「请求发到哪」Key 告诉服务端「你是谁、有没有额度」。Unity-MCP 的 settings.json 里这两个字段必须成对出现缺一个都会在验证阶段报错。很多人只填了 Key 忘了改 Base URL结果请求打到了默认地址自然连不上。环境清单核对一遍Unity 2022.3、Python 3.10、uv 已装、Node 18、TaoToken Key 已创建、模型 ID 已选定。齐了再往下走。3. 可复制的 settings.json 骨架Base URL、Key 与 Model ID 三件套这一节是全文的核心。MCP 客户端的配置文件通常叫settings.json或mcp.json不同客户端路径不同但结构一致一个mcpServers对象里面每个键是一个服务器名值是启动命令加环境变量。下面这份骨架你可以直接抄把占位符替换成自己的值。{ mcpServers: { unity-mcp: { command: uv, args: [ run, --directory, /absolute/path/to/unity-mcp-server, server.py ], env: { UNITY_MCP_HOST: 127.0.0.1, UNITY_MCP_PORT: 6500, OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的TaoTokenKey, OPENAI_MODEL: 你的模型ID } } } }逐字段说清楚。command是启动器用 uv 跑 Python 服务args里的--directory指向你 clone 下来的 unity-mcp 服务器目录必须是绝对路径相对路径在客户端拉起子进程时经常解析失败。UNITY_MCP_HOST和UNITY_MCP_PORT是桥接层监听地址默认 127.0.0.1:6500和 Unity 插件里显示的一致。OPENAI_BASE_URL填https://taotoken.net/api注意结尾不要多加斜杠也不要写成/v1之外的变体客户端拼接路径时多一个斜杠就可能 404。OPENAI_API_KEY填你刚创建的那把 Key。OPENAI_MODEL填模型 ID这个值要和你在模型对话页验证过的保持一致。如果你用的是支持 TOML 的客户端等价写法是这样[mcp_servers.unity-mcp] command uv args [run, --directory, /absolute/path/to/unity-mcp-server, server.py] [mcp_servers.unity-mcp.env] UNITY_MCP_HOST 127.0.0.1 UNITY_MCP_PORT 6500 OPENAI_BASE_URL https://taotoken.net/api OPENAI_API_KEY sk-你的TaoTokenKey OPENAI_MODEL 你的模型ID注意Key 不要写进会被 Git 追踪的文件。如果客户端支持读环境变量优先用环境变量注入settings.json 里只留变量名。三件套的对应关系再强调一次Base URL 决定请求去哪Key 决定身份Model ID 决定用哪个模型。这三者在 Unity-MCP 场景里缺一不可而且必须和 Unity 插件那侧的端口配置对齐。配完保存重启客户端让配置生效。4. 连通性验证从一次自然语言指令到 Unity 控制台的真实回显配置写完不算完得验证链路真的通了。验证分两层先确认 MCP 服务器能被客户端拉起再确认 AI 下发的指令能在 Unity 里执行。第一层重启客户端后看 MCP 服务器列表unity-mcp应该显示为已连接或 running。如果显示 failed先看客户端日志里子进程的报错八成是--directory路径写错或者 uv 不在 PATH 里。第二层在客户端对话框里输入一句最简单的自然语言指令比如「在场景原点创建一个立方体命名为 TestCube」。观察两个地方Unity 的 Hierarchy 面板是否出现 TestCube以及 Console 是否有对应日志。如果物体出现了说明整条链路——客户端 → TaoToken API → 模型 → MCP 服务器 → Unity 插件——全部打通。再补一个读取类指令验证反向通道「读取当前 Console 里最近三条日志」。这类指令不改变场景但能确认 AI 能拿到 Unity 返回的数据。正向创建加反向读取都通过链路才算稳。如果你想更直接地测 API 侧可以用 curl 打一次模型对话接口确认 Key 和 Base URL 本身没问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 回复 ok}] }返回里带choices数组且内容正常说明模型侧配置无误。这一步能把「API 配置错」和「Unity 桥接错」两类问题分开定位省很多排查时间。验证通过后你可以试着下一条稍复杂的指令比如「创建 10 个随机分布在 XZ 平面上的立方体都加上 BoxCollider」。看 AI 是否拆成多条命令依次执行。这一步能顺带观察模型的工具调用稳定性。5. 常见报错排查401、local proxy failed 与 reading choices 报错配 MCP 最烦的就是报错信息不直观。下面按真实遇到的几类错误对照排查。401 UnauthorizedKey 错了、过期了或者Authorization头没带上。检查 settings.json 里OPENAI_API_KEY是否完整有没有多余空格。如果 Key 是从控制台复制的确认没漏字符。也有一种情况是 Base URL 写成了别的域名请求打到了不认这把 Key 的服务端。local proxy failed / connection refused客户端连不上 MCP 服务器。先确认uv run server.py能手动跑起来再确认--directory路径存在。端口被占用也会报这个换一个UNITY_MCP_PORT并同步改 Unity 插件里的端口。reading choices 相关报错通常是响应体不是预期的 JSON 结构常见原因是 Base URL 少了或多了路径段导致返回了 HTML 错误页。把OPENAI_BASE_URL严格写成https://taotoken.net/api不要自己加/v1客户端会按协议拼接。OAuth / 认证跳转类报错说明客户端在尝试走交互式登录流程而 MCP 场景应该用 Key 直连。检查配置里是否误开了 OAuth 模式把它关掉改用OPENAI_API_KEY注入。Unity 侧 Connected 但指令无反应桥接层活着但命令没执行多半是模型没正确调用工具。回模型对话页确认该模型支持工具调用或者换一个指令跟随更强的模型 ID。排查顺序建议先用 curl 确认 API 侧通再看 MCP 服务器进程是否活着最后看 Unity 插件状态。三层逐层排除比盲目改配置快得多。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 字段含义和路径规则那里写得更细。6. 把这条链路用起来从验证通过到日常开发链路验证通过后真正的价值在日常使用里。我的习惯是先把重复性最高的操作交给它批量摆放场景物件、统一改材质引用、按命名规则整理 Hierarchy。这些活手工做又慢又容易错用自然语言描述一遍AI 拆成命令执行省下来的时间拿去调玩法。如果你要长期跑编码和 Agent 类任务比如让 AI 连续多轮操作场景并保持上下文可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它更适合这种需要持续对话、多步工具调用的场景。Key 的管理也别偷懒。不同项目用不同的 Key出问题能快速定位是哪个项目超了额度或配错了。控制台里可以随时吊销重建地址还是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。最后留一个实用技巧把 settings.json 里的路径和端口做成模板换项目时只改--directory和 Key其余不动。这样新项目接入的时间能从十几分钟压到两分钟。链路通了之后你会发现真正花时间的不是配置而是想清楚要让 AI 帮你做什么——那才是值得投入的地方。
Unity-MCP 配 TaoToken：用自然语言驱动 Unity 引擎的 settings.json 骨架
1. Unity-MCP 到底是什么为什么值得在编辑器里接一条 AI 通道Unity-MCP 是一套把 Unity 编辑器暴露成「可被自然语言调用」的工具链它由两部分组成跑在本机的 MCP 服务器Python 后端和挂在 Unity 里的 C# 插件桥接层。MCP 全称 Model Context Protocol你可以把它理解成 AI 客户端和本地工具之间的一份「对话契约」——AI 不需要知道 Unity 的 C# API 长什么样只要按契约发出「创建物体」「修改属性」「导入资源」这类结构化请求桥接层负责翻译成编辑器里真实执行的操作。它能做的事很具体在场景里批量生成物体、改 Transform、切图层、挂材质、导入 FBX、读取 Console 日志、进出 Play Mode。适合谁独立开发者、做原型验证的策划、以及被重复拖拽操作磨掉耐心的程序。你不需要先写一堆 Editor 脚本直接用一句话描述意图AI 拆成若干条命令下发。但这里有个现实问题AI 客户端要调用模型就得有稳定的 API 入口和一把能统一管理的 Key。Unity-MCP 本身只负责「Unity 这一侧」的桥接模型侧怎么接、Key 放哪、Base URL 填什么是另一条链路。这篇就聚焦这条链路的配置起点——用 TaoToken 统一 Key/API把 settings.json 骨架搭起来再验证 AI 和 Unity 的对话是否真的通了。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。很多人卡住不是因为 Unity 插件装不上而是模型侧配置写错了一个字段导致请求发出去石沉大海。下面从环境准备一路走到连通性验证每一步都给可复制的片段。2. 前置准备Unity 版本、Python 环境与 TaoToken Key 的获取先把地基打平。Unity 侧建议 2022.3 LTS 及以上2020.3 也能跑但部分编辑器 API 覆盖不全。Python 用 3.10包管理器推荐 uv装依赖比裸 pip 干净。Node.js 18 在部分 MCP 客户端里会用到顺手装上不亏。Unity 插件安装走 Package Manager 的 git URL 方式在manifest.json里加一行依赖或者直接在 Package Manager 里 Add package from git URL。装完点Window → Unity MCP控制台出现 Connected 就说明桥接层活了。这一步和模型无关先把 Unity 这侧跑通。接下来是模型侧。打开 TaoToken 控制台进 API Keys 页面创建一把 Key。地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建时给它起个能认出来的名字比如unity-mcp-dev方便以后按项目区分。Key 只在创建时完整显示一次复制下来存到本地密码管理器别直接贴进会提交到 Git 的文件里。模型 ID 这块做 Unity 编辑器操作这类任务选一个指令跟随稳、工具调用能力好的模型即可。你可以在模型对话页先试几句确认这个模型对结构化指令的响应符合预期再去配 MCP。模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。这里要强调一个概念Base URL 和 Key 是两件事。Base URL 告诉客户端「请求发到哪」Key 告诉服务端「你是谁、有没有额度」。Unity-MCP 的 settings.json 里这两个字段必须成对出现缺一个都会在验证阶段报错。很多人只填了 Key 忘了改 Base URL结果请求打到了默认地址自然连不上。环境清单核对一遍Unity 2022.3、Python 3.10、uv 已装、Node 18、TaoToken Key 已创建、模型 ID 已选定。齐了再往下走。3. 可复制的 settings.json 骨架Base URL、Key 与 Model ID 三件套这一节是全文的核心。MCP 客户端的配置文件通常叫settings.json或mcp.json不同客户端路径不同但结构一致一个mcpServers对象里面每个键是一个服务器名值是启动命令加环境变量。下面这份骨架你可以直接抄把占位符替换成自己的值。{ mcpServers: { unity-mcp: { command: uv, args: [ run, --directory, /absolute/path/to/unity-mcp-server, server.py ], env: { UNITY_MCP_HOST: 127.0.0.1, UNITY_MCP_PORT: 6500, OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的TaoTokenKey, OPENAI_MODEL: 你的模型ID } } } }逐字段说清楚。command是启动器用 uv 跑 Python 服务args里的--directory指向你 clone 下来的 unity-mcp 服务器目录必须是绝对路径相对路径在客户端拉起子进程时经常解析失败。UNITY_MCP_HOST和UNITY_MCP_PORT是桥接层监听地址默认 127.0.0.1:6500和 Unity 插件里显示的一致。OPENAI_BASE_URL填https://taotoken.net/api注意结尾不要多加斜杠也不要写成/v1之外的变体客户端拼接路径时多一个斜杠就可能 404。OPENAI_API_KEY填你刚创建的那把 Key。OPENAI_MODEL填模型 ID这个值要和你在模型对话页验证过的保持一致。如果你用的是支持 TOML 的客户端等价写法是这样[mcp_servers.unity-mcp] command uv args [run, --directory, /absolute/path/to/unity-mcp-server, server.py] [mcp_servers.unity-mcp.env] UNITY_MCP_HOST 127.0.0.1 UNITY_MCP_PORT 6500 OPENAI_BASE_URL https://taotoken.net/api OPENAI_API_KEY sk-你的TaoTokenKey OPENAI_MODEL 你的模型ID注意Key 不要写进会被 Git 追踪的文件。如果客户端支持读环境变量优先用环境变量注入settings.json 里只留变量名。三件套的对应关系再强调一次Base URL 决定请求去哪Key 决定身份Model ID 决定用哪个模型。这三者在 Unity-MCP 场景里缺一不可而且必须和 Unity 插件那侧的端口配置对齐。配完保存重启客户端让配置生效。4. 连通性验证从一次自然语言指令到 Unity 控制台的真实回显配置写完不算完得验证链路真的通了。验证分两层先确认 MCP 服务器能被客户端拉起再确认 AI 下发的指令能在 Unity 里执行。第一层重启客户端后看 MCP 服务器列表unity-mcp应该显示为已连接或 running。如果显示 failed先看客户端日志里子进程的报错八成是--directory路径写错或者 uv 不在 PATH 里。第二层在客户端对话框里输入一句最简单的自然语言指令比如「在场景原点创建一个立方体命名为 TestCube」。观察两个地方Unity 的 Hierarchy 面板是否出现 TestCube以及 Console 是否有对应日志。如果物体出现了说明整条链路——客户端 → TaoToken API → 模型 → MCP 服务器 → Unity 插件——全部打通。再补一个读取类指令验证反向通道「读取当前 Console 里最近三条日志」。这类指令不改变场景但能确认 AI 能拿到 Unity 返回的数据。正向创建加反向读取都通过链路才算稳。如果你想更直接地测 API 侧可以用 curl 打一次模型对话接口确认 Key 和 Base URL 本身没问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 回复 ok}] }返回里带choices数组且内容正常说明模型侧配置无误。这一步能把「API 配置错」和「Unity 桥接错」两类问题分开定位省很多排查时间。验证通过后你可以试着下一条稍复杂的指令比如「创建 10 个随机分布在 XZ 平面上的立方体都加上 BoxCollider」。看 AI 是否拆成多条命令依次执行。这一步能顺带观察模型的工具调用稳定性。5. 常见报错排查401、local proxy failed 与 reading choices 报错配 MCP 最烦的就是报错信息不直观。下面按真实遇到的几类错误对照排查。401 UnauthorizedKey 错了、过期了或者Authorization头没带上。检查 settings.json 里OPENAI_API_KEY是否完整有没有多余空格。如果 Key 是从控制台复制的确认没漏字符。也有一种情况是 Base URL 写成了别的域名请求打到了不认这把 Key 的服务端。local proxy failed / connection refused客户端连不上 MCP 服务器。先确认uv run server.py能手动跑起来再确认--directory路径存在。端口被占用也会报这个换一个UNITY_MCP_PORT并同步改 Unity 插件里的端口。reading choices 相关报错通常是响应体不是预期的 JSON 结构常见原因是 Base URL 少了或多了路径段导致返回了 HTML 错误页。把OPENAI_BASE_URL严格写成https://taotoken.net/api不要自己加/v1客户端会按协议拼接。OAuth / 认证跳转类报错说明客户端在尝试走交互式登录流程而 MCP 场景应该用 Key 直连。检查配置里是否误开了 OAuth 模式把它关掉改用OPENAI_API_KEY注入。Unity 侧 Connected 但指令无反应桥接层活着但命令没执行多半是模型没正确调用工具。回模型对话页确认该模型支持工具调用或者换一个指令跟随更强的模型 ID。排查顺序建议先用 curl 确认 API 侧通再看 MCP 服务器进程是否活着最后看 Unity 插件状态。三层逐层排除比盲目改配置快得多。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 字段含义和路径规则那里写得更细。6. 把这条链路用起来从验证通过到日常开发链路验证通过后真正的价值在日常使用里。我的习惯是先把重复性最高的操作交给它批量摆放场景物件、统一改材质引用、按命名规则整理 Hierarchy。这些活手工做又慢又容易错用自然语言描述一遍AI 拆成命令执行省下来的时间拿去调玩法。如果你要长期跑编码和 Agent 类任务比如让 AI 连续多轮操作场景并保持上下文可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它更适合这种需要持续对话、多步工具调用的场景。Key 的管理也别偷懒。不同项目用不同的 Key出问题能快速定位是哪个项目超了额度或配错了。控制台里可以随时吊销重建地址还是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。最后留一个实用技巧把 settings.json 里的路径和端口做成模板换项目时只改--directory和 Key其余不动。这样新项目接入的时间能从十几分钟压到两分钟。链路通了之后你会发现真正花时间的不是配置而是想清楚要让 AI 帮你做什么——那才是值得投入的地方。
