★ FEATURED ARTICLE 1. 为什么 Blender4.2 批量建模需要统一 Key 接入如果你正在用 Blender4.2 做批量建模同时把 CLI-Anything 和 BlenderMCP 串进流水线大概率会遇到一个很烦的问题Codex 侧要同时对接多个工具每个工具一套 Key、一份配置改一处忘一处联调时根本分不清是模型没响应还是 Key 填错了。我这次要记录的就是把这条链路收敛成一份config.toml骨架用 TaoToken 统一 Key 接入 Codex 与 BlenderMCP让 AI 边画你边看效果。先说清楚这套东西是什么、能做什么、适合谁。Blender4.2 是建模主体CLI-Anything 负责把命令行指令转成 Blender 可执行动作BlenderMCP 负责在 Blender 和 Codex 之间做实时双向通信Codex 则是发出建模意图的那一端。适合的人很明确已经在跑 Blender 自动化建模、想让 AI 实时改模型而不是反复生成新文件重载、并且被多工具 Key 分散折磨过的工程向用户。这篇是部署记录的第二篇重点不在从零装环境而在联调环节的配置收敛和端到端验证。上一篇我们把 Blender CLI-Anything 的自动化建模环境搭起来了效果基本达标但痛点也很直接CLI 模式下每次修改都要写完指令、重新加载执行没法实时预览。调一个倒角参数生成一个新文件改一次阵列数量再重载一次项目。高频迭代时流程繁琐、卡顿明显。所以这一篇的核心目标有两个一是用 BlenderMCP 打通实时通信二是把 Codex 侧多工具 Key 分散的问题用 TaoToken 统一 Key 解决掉最后给出一份可直接复制的config.toml骨架。2. TaoToken 前置统一 Key 与 Codex 侧准备在动手改配置之前先把 Key 这一层理顺。多工具 Key 分散的本质问题是CLI-Anything 调模型要 KeyBlenderMCP 转发 Codex 请求也要 Key如果每个环节各配一套联调时出错概率成倍上升。TaoToken 在这里的作用是提供一个统一的接入点让 Codex 和 BlenderMCP 共用同一套凭证和 base_url配置只维护一份。你需要先拿到统一 Key。进入控制台创建 API Key建议按项目维度命名比如blender-batch方便后面在config.toml里对应。创建入口在控制台的 API Keys 页面地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到 Key 之后先别急着写进配置放在环境变量里更安全后面config.toml里用引用方式读取。这里有个容易踩的坑很多人把 Key 直接硬编码进config.toml然后提交到仓库联调时一旦 Key 轮换所有工具一起挂。我的做法是 Key 只进环境变量config.toml里只写变量名。这样 Codex 和 BlenderMCP 读的是同一个来源改一处全生效。统一接入的 base_url 用 https://taotoken.net/api 注意这个地址不带任何查询参数配置里也不要自己拼 UTM。模型对话相关的调试可以在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 里先验证一次请求是否通确认 Key 有效再往下走。如果你后面要长期跑编码和 Agent 任务可以了解下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它更适合高频批量场景。3. 可复制配置config.toml 骨架与 BlenderMCP 联调这一节是全文重点给出可直接复制的config.toml骨架并说明每个字段为什么这么写。先确认基础环境Blender4.2 已装好Conda 可用上一篇的 CLI-Anything 环境保留不动我们单独建一套 BlenderMCP 专属环境避免和 CLI-Anything 冲突排错时边界更清晰。3.1 新建 BlenderMCP 专属 Conda 环境单独建环境的好处是依赖隔离BlenderMCP 出问题不会污染 CLI-Anything。命令如下conda create -n blender-mcp python3.12 pip -y conda activate blender-mcpPython 版本用 3.12适配 BlenderMCP 的运行要求。激活后先升级 uv 工具链BlenderMCP 靠 uvx 启动管理python -m pip install --upgrade uv uv --version uvx --version两条版本命令都能输出版本号说明工具链正常。接着安装 BlenderMCP 插件并注册路径uvx blender-mcp install-addon uvx blender-mcp addon-pathsaddon-paths的输出记一下后面校验插件是否被 Blender 正确加载时会用到。3.2 config.toml 骨架下面是统一 Key 接入的核心骨架。放在 Codex 的配置目录下文件名config.toml。注意 Key 用环境变量引用不硬编码# Codex 侧统一配置骨架 # 统一接入点Codex 与 BlenderMCP 共用 [provider] name taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY # 批量建模建议用稳定模型避免中途切换导致行为漂移 default_model claude-sonnet # BlenderMCP 服务定义 [mcp_servers.blender] command uvx args [blender-mcp, serve] # BlenderMCP 默认通信端口 port 9876 # 复用同一套 Key不单独配置 api_key_env TAOTOKEN_API_KEY base_url https://taotoken.net/api # CLI-Anything 桥接复用统一 Key [mcp_servers.cli_anything] command uvx args [cli-anything, bridge] api_key_env TAOTOKEN_API_KEY base_url https://taotoken.net/api # 批量任务默认参数 [batch] # 单次批量建模的最大并发按机器性能调 max_concurrency 4 # 实时预览开关BlenderMCP 联调时保持 true live_preview true几个关键点解释一下。api_key_env三处都指向同一个TAOTOKEN_API_KEY这就是统一 Key 的落点改 Key 只改环境变量。base_url统一用不带参数的 API 地址。mcp_servers.blender里的port 9876是 BlenderMCP 默认端口和 Blender 端侧边栏里显示的一致不要随意改改了要两边同步。batch.live_preview true是实时预览开关联调阶段保持开启才能做到 AI 边画你边看。环境变量这样设置Linux/macOS 下export TAOTOKEN_API_KEY你的统一KeyWindows PowerShell$env:TAOTOKEN_API_KEY你的统一Key注意不要把 Key 写进config.toml再提交仓库。环境变量方式在 Codex 重启后依然有效前提是写进了 shell 的启动文件。3.3 Blender 端启用 MCP 插件配置写完后Blender 端要配合。打开 Blender4.2先关闭插件的 AllowTelemetry 遥测功能避免后台通信干扰。然后完全关闭 Blender 再重启确保插件生效。在 3D 视图按 N 调出侧边栏找到 BlenderMCP 标签页端口保持默认 9876点击 Connect to MCP server。连接成功后侧边栏状态会变成已连接这一步是后面端到端验证的前提。4. 验证请求一次批量建模任务的端到端动作配置对不对跑一次批量任务就知道。这一节演示从 Codex 发出指令到 Blender 实时预览的完整链路重点看统一 Key 是否被两个工具正确复用。4.1 先验证 Key 连通性在正式跑批量前先用一次最小请求确认统一 Key 有效。可以用模型对话入口发一条测试消息地址 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。如果返回正常说明 Key 和 base_url 没问题可以排除凭证层故障。4.2 启动 BlenderMCP 服务在blender-mcp环境里启动服务conda activate blender-mcp uvx blender-mcp serve --port 9876服务起来后保持这个终端不关。回到 Blender确认侧边栏 BlenderMCP 已连接。此时 Codex 侧读config.toml里的mcp_servers.blender应该能发现这个服务。4.3 发起一次批量建模任务在 Codex 里发一条批量指令比如生成一组按参数递增的立方体阵列。指令大意是在场景中创建 5 个立方体沿 X 轴等距排列每个立方体尺寸依次递增。Codex 会通过 BlenderMCP 把动作实时下发到 Blender。预期结果是Blender 视图里立方体逐个出现你能实时看到排列和尺寸变化而不是等任务跑完才看到最终文件。这就是live_preview true的效果。如果立方体没出现先看 BlenderMCP 终端有没有报错再看 Codex 侧是否读到了mcp_servers.blender配置。4.4 确认统一 Key 被复用验证统一 Key 是否生效看两个地方BlenderMCP 服务日志里请求携带的凭证来源以及 Codex 侧调用记录。如果两处都指向TAOTOKEN_API_KEY说明统一接入成功没有出现某个工具偷偷用了另一套 Key 的情况。这一步是整篇的核心验证点多工具 Key 分散的问题到这里就算收敛掉了。5. 本篇常见错排查联调阶段报错集中在几个地方按出现频率排一下。第一个是 BlenderMCP 连不上侧边栏一直显示未连接。先确认uvx blender-mcp serve的终端还活着端口是不是 9876Blender 端端口有没有被改过。两边端口必须一致。如果端口对但还是连不上检查 Blender 是否在关闭遥测后完整重启过插件没重启有时不生效。第二个是 Codex 读不到 MCP 服务。多半是config.toml路径不对或者 TOML 语法有误。可以用python -c import tomllib; tomllib.load(open(config.toml,rb))快速校验语法。另外确认mcp_servers下的服务名和 Codex 里引用的名字一致。第三个是请求返回鉴权失败。统一 Key 的常见坑是环境变量没生效。Codex 和 BlenderMCP 是两个进程如果其中一个是在设置环境变量之前启动的它读不到TAOTOKEN_API_KEY。解决办法是设置好环境变量后重启两个进程。另一个可能是 Key 本身失效去控制台确认一下状态。第四个是实时预览不生效模型改动要等任务结束才显示。检查batch.live_preview是不是被改成了 false以及 BlenderMCP 连接是否稳定。预览依赖双向通信连接断了就退化成批量执行。第五个是批量并发过高导致 Blender 卡死。batch.max_concurrency默认给的是 4机器性能一般就往下调实时预览场景下并发太高反而拖慢响应。6. 接入文档与后续动作配置骨架和验证动作都跑通后建议把config.toml纳入版本管理但 Key 继续留在环境变量里。后续如果要扩展更多工具进这条流水线统一 Key 的接入方式可以直接复用新增工具只需在config.toml里加一段mcp_serversapi_key_env和base_url照抄即可不用再单独申请凭证。接入细节和参数说明可以对照接入文档地址 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你在跑 Claude Code 相关的 Agent 任务Anthropic 兼容接入的说明在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 配置思路和本篇一致同样是统一 Key 复用。最后留一个实操建议每次改完config.toml先跑一次最小连通性验证再跑批量任务。联调阶段最怕的是配置改了一半就去跑大任务报错时根本定位不到是哪一层的问题。把验证动作前置排错成本会低很多。
阅读完成 · 觉得有帮助？
