ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

5ire 接入 Unity MCP 小白教程:TaoToken 统一 Key 配置与验证

5ire 接入 Unity MCP 小白教程:TaoToken 统一 Key 配置与验证 1. 5ire 接入 Unity MCP 到底在解决什么问题如果你刚接触 5ire 和 Unity MCP最容易卡住的地方不是 Unity 插件本身而是「AI 客户端怎么把请求稳定地送到 MCP 服务」。5ire 是一个支持 MCP 协议的桌面 AI 客户端能连本地 Ollama 模型也能通过 HTTP 方式对接 Unity 侧的 MCP 服务Unity MCP 则把 Unity 编辑器里的场景、对象、脚本操作暴露成可被调用的工具。两者接上之后你在 5ire 里输入一句「帮我在场景里创建一个旋转的立方体」模型就能触发 Unity MCP 的工具调用真正落到编辑器里执行。这套组合适合谁适合刚学 Unity、不想一上来就写复杂编辑器脚本的新手也适合想用本地模型做 AI 辅助开发、又不想被某些客户端付费机制绑住的开发者。核心检索词就三个5ire、Unity MCP、统一 Key 配置。本文要交付的是一个最小闭环用 TaoToken 统一 Key/API 通道在 5ire 里完成 MCP 服务配置并给出可复制的 settings.json 骨架和 Unity 侧连接验证动作。需要先说明一点5ire 本身可以直连 Ollama 本地模型但当你希望模型走统一的 API 通道、或者想用云端模型补足本地算力时TaoToken 就派上用场了。它提供统一的 Key 和 API 地址让你不用在多个平台之间反复切换配置。下面按「先跑通本地、再接入统一通道、最后验证 MCP 调度」的顺序来。2. 前置准备Ollama、5ire 与 TaoToken 统一 Key2.1 先确认 Ollama 可用Unity MCP 的工具调用需要模型支持 function calling所以本地模型建议选支持工具调用的版本。安装完 Ollama 后先在 PowerShell 里确认环境变量是否生效ollama --version有版本号输出就说明装好了。接着拉取模型比如ollama pull qwen3:8b如果下载慢可以配置镜像源加速。拉完后用下面命令确认模型在列表里ollama list看到模型名称和大小说明本地模型就绪。内存建议 12GB 以上跑 8B 级别机器吃紧就换 4B 级别先保证能跑通流程。2.2 安装 5ire 客户端从 5ire 官方发布页下载 Windows 版本安装后打开。进入设置左下角会列出各个模型平台选择 Ollama再选中你刚拉取的模型。新建一个对话输入「你好」测试能正常回复就说明基础模型通道通了。2.3 拿到 TaoToken 统一 KeyTaoToken 的作用是把模型调用收敛到一个 API 地址和一把 Key 上。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进入控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。API 基础地址统一用 https://taotoken.net/api 注意这个地址不加 UTM 参数。提示Key 只在创建时完整显示一次复制后先存到本地密码管理器别直接贴到公开仓库里。3. 可复制配置5ire 的 settings.json 骨架与 MCP 填写5ire 的 MCP 配置有两种入口图形界面里点「工具」→ 右侧下拉选「远程」或者直接改配置文件。图形界面适合快速试配置文件适合版本管理和复用。下面给一份 settings.json 骨架字段名以你本地 5ire 版本为准核心是 mcpServers 这一段。{ mcpServers: { UnityMCP: { url: http://127.0.0.1:8080/mcp, headers: {}, enabled: true } }, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: qwen3-8b } } }几个关键点解释一下。url 里的 127.0.0.1:8080 是本地 Unity MCP 服务默认监听地址/mcp 是流式 HTTP 端点。headers 留空是因为本地服务没做鉴权如果你的 MCP 部署在远端并加了 token 校验就在这里补Authorization: Bearer 你的token。providers 段是给 5ire 走统一 API 通道用的baseUrl 填 TaoToken 的 API 地址apiKey 填你创建的 Key。如果你更习惯图形界面操作路径是左上角「工具」→ 右侧下拉框选「远程」→ 名称填 UnityMCP名字随意→ URL 填http://127.0.0.1:8080/mcp→ 请求头留空 → 保存后点「打开」。保存成功后工具列表里应该能看到 UnityMCP 处于启用状态。注意配置文件里的 apiKey 属于敏感信息提交到 Git 前务必用环境变量或本地忽略文件处理别把 Key 推到公开仓库。4. 验证请求从 5ire 触发一次 Unity MCP 工具调用配置保存后新建一个文件夹作为工作区在 5ire 里新建对话。这里有个新手常踩的坑模型不会自动去调 MCP你必须在提示词里明确要求它使用 Unity MCP。比如输入请使用 Unity MCP 工具在当前场景中创建一个名为 TestCube 的立方体位置设为 (0, 1, 0)。发送后观察两个信号。第一5ire 界面会弹出「调用工具」的提示说明模型识别到了 MCP 工具并准备执行第二切回 Unity 编辑器场景层级里应该出现 TestCube 对象。如果这两个都出现最小闭环就跑通了。想进一步确认通道是否走的是 TaoToken可以在 5ire 的模型设置里把 provider 切到 taotoken再发一次请求。模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 你可以先在网页端确认 Key 和模型可用再回到 5ire 里对照。如果网页端能正常对话、5ire 里却报鉴权错误多半是 Key 复制时带了空格或者 baseUrl 末尾多了斜杠。对于长期做编码和 Agent 调度的场景可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用和持续开发。接入细节可以查文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。5. 本篇常见错误排查5.1 5ire 里看不到 UnityMCP 工具先确认 Unity MCP 服务是否真的在跑。在 PowerShell 里执行curl http://127.0.0.1:8080/mcp如果连接被拒绝说明服务没启动或端口不对。回到 Unity 侧检查 MCP 插件是否已启用、监听端口是否被占用。端口冲突时换成 8081 之类同时把 5ire 配置里的 url 一起改掉。5.2 模型回复了但没触发工具调用这是最常见的问题原因通常是模型不支持 function calling或者提示词没明确要求用 MCP。先换一个支持工具调用的模型再在提示词里写清「使用 Unity MCP 工具」。部分模型对工具调用支持不完整实测下来 qwen 系列在 MCP 场景里表现比较稳。5.3 走 TaoToken 时报 401 或 404401 一般是 Key 错误或过期去 API Keys 页面重新生成一个。404 多半是 baseUrl 写错确认是https://taotoken.net/api不要多加路径也不要在末尾加斜杠。如果请求头里手动塞了 Content-Type 之外的字段先清空再试。5.4 Unity 侧对象没创建但 5ire 显示成功这种情况通常是 MCP 服务连上了、但工具执行时 Unity 编辑器不在前台或场景未保存。把 Unity 窗口切到前台确认当前打开的是可编辑场景再重试一次。另外检查 Unity MCP 插件版本和 5ire 的 MCP 协议版本是否兼容版本差太多会出现「调用成功但无效果」。6. 把统一 Key 和 MCP 调度固定成日常流程跑通一次之后建议把配置固化成可复用的模板settings.json 里 mcpServers 和 providers 两段分开管理Key 用环境变量注入Unity MCP 的 url 和端口写成注释方便切换。这样下次换机器或换项目改两三个字段就能重新跑起来。如果你还想接其他 MCP比如全栈类工具思路是一样的先确认它是 HTTP 远程还是本地 stdio远程就填 url本地就在工具设置里指向对应的配置 json 和文件夹位置。区别只在于启动方式和鉴权字段核心的「5ire 触发工具调用 → MCP 执行 → 结果回传」这条链路不变。最后留一个实用习惯每次改完配置先用一句最简单的提示词验证工具调用比如「用 Unity MCP 列出当前场景的所有对象」。这一步能快速区分是配置问题还是模型问题比一上来就发复杂指令省时间。
返回列表