
用 Codex 自然语言驱动 Blender 建模关键路径是给它接上 blender-mcp 这个标准 MCP Server真正挡住大多数人的不是插件安装而是 Codex 的模型鉴权。把 Codex 的模型通道接到 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end的兼容 API 后不需要登录 ChatGPT 账号也不用盯着官方 Key 的额度直接在 Blender 里输入中文或英文指令Codex 就会调用 blender-mcp 的工具完成建模操作。下面按完整流程走一遍把原文里「登录 ChatGPT 账号或配置 API Key」那一步整体替换成 TaoToken 的 Key 配置其余 blender-mcp 链路原样保留。1. 接入链路Codex 作为 MCP Client怎么跟 Blender 对话1.1 三个角色各管一段blender-mcp 的官方客户端列表里直接列出的是 Claude Desktop、Cursor、VS Code 这些Codex 不在里面但 Codex CLI 原生支持 stdio 类型的 MCP Server所以实际可以用。整条链路分成三段MCP Server通过uvx blender-mcp启动负责把 Codex 发来的工具调用转给 Blender 插件。Blender 插件装在 Blender 内部接收指令后在当前场景里执行建物体、改材质、摆相机等操作。Codex CLI作为 MCP Client 发起对话决定什么时候该调用哪个工具。Codex 跑一个 MCP 任务时主模型的对话和工具调用都有 Token 消耗这部分由 Codex 配置的模型供应商结算。原文在这一步要求登录 ChatGPT 账号我们把它换成 TaoToken 的 KeyCodex 的模型请求统一走兼容 API 通道Blender 侧的插件照常工作MCP 工具调用本身不换变动的只是模型费用入口。1.2 为什么把模型鉴权切到 TaoTokenCodex 默认的登录方式绑 ChatGPT 账号多台机器、多个终端来回切容易撞上限纯 API Key 方式又得单独准备一个 OpenAI 兼容的 Endpoint。TaoToken 提供的是一条统一兼容通道在官网创建一把 Key把 Codex 的model_provider指向它的 Base URL注册 MCP 和 Blender 插件都不受影响。这样原本 blender-mcp 的「自然语言 → 工具调用 → Blender 操作」链路完整保留只是每次对话和工具调用消耗的 Token 记账到 TaoToken 这把 Key 上。2. 准备材料Codex CLI、uv、TaoToken API Key2.1 版本要求清单对照原文开始前先确认环境Blender 3.0 及以上Python 3.10 及以上uv 包管理器提供uvx命令Codex CLI 已安装Node.js 18npm 方式安装 Codex 时需要Codex CLI 还没有的话用 npm 全局安装npm i -g openai/codex装完执行codex --version确认版本。2.2 安装 uv 包管理器blender-mcp 通过uvx启动所以先装 uv。注意不要用pip install uv安装官方明确提示这种装法可能有兼容问题直接用官方安装脚本。Windows 下用 PowerShell 执行powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iexmacOS / Linux 下执行curl -LsSf https://astral.sh/uv/install.sh | sh装完重新打开一个终端执行uv --version能正常输出版本号即可。2.3 创建 TaoToken Key 并确认模型 ID原文要求「Codex CLI 已安装并完成登录」这一步改成去 TaoToken 拿 Key。打开 TaoToken 注册账号进入控制台创建 API Key把生成的字符串保存到本地。创建完 Key 后顺便在模型广场看一下当前可用的模型 ID记下一个给 Codex 用。模型 ID 以模型广场当时列表为准不要凭记忆填版本号避免 Codex 启动时报模型不存在。拿到 Key 后把它设置成环境变量名字要和后面config.toml里env_key指定的保持一致。macOS / Linux 在终端里执行export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 里执行$env:TAOTOKEN_API_KEYYOUR_API_KEY这里的YOUR_API_KEY就是从 TaoToken 控制台复制出来的真实 Key。环境变量只在当前终端窗口生效重新打开终端后要重新 export或者直接写进 shell profile / 系统环境变量。3. 在 Codex 中注册 blender-mcpcodex mcp add 与 config.toml3.1 把模型供应商指到 TaoToken 兼容通道Codex 的全局配置在~/.codex/config.tomlWindows 下是C:\Users\你的用户名\.codex\config.toml。先打开这个文件加入模型供应商配置model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEYYOUR_MODEL_ID替换成你在模型广场复制的 ID。这里的 Base URL 填接口地址https://taotoken.net/api末尾不要加/v1也不要填官网落地页。官网落地页只用来注册、创建 Key、看用量真正填进 Codex 的只有这行 API 地址。配置好之后Codex 发起对话时会用TAOTOKEN_API_KEY作为凭证请求发往https://taotoken.net/api不再要求codex login登录 ChatGPT 账号。3.2 用 codex mcp add 一键注册 MCP Server模型供应商配好后注册 blender-mcp 就简单了。Codex 支持用命令直接添加 MCP Servercodex mcp add blender -- uvx blender-mcp这条命令会自动把[mcp_servers.blender]配置段写进~/.codex/config.toml不需要手动编辑 MCP 部分。执行后验证一下codex mcp list输出里能看到blender这一项说明注册成功。也可以用codex mcp get blender看具体配置。配置改动后重启 Codex 让它重新加载。3.3 手动编辑 MCP 配置与 uvx 路径修正不方便用命令时也可以直接改config.toml在文件里加一段[mcp_servers.blender] command uvx args [blender-mcp]如果 Codex 启动 MCP Server 时报找不到uvx用which uvxmacOS / Linux或where uvxWindows查完整路径把command改成完整路径[mcp_servers.blender] command C:\\Users\\你的用户名\\.local\\bin\\uvx.exe args [blender-mcp]Windows 路径里的反斜杠要写双份。改完保存并重启 Codex。4. 安装并启用 Blender 插件从 install-addon 到侧边栏启动4.1 用 uvx blender-mcp install-addon 安装插件Codex 侧配好后轮到 Blender 侧。先在终端执行插件安装命令uvx blender-mcp install-addon执行完打开 Blender进入 Edit → Preferences → Add-ons搜索Interface: Blender MCP勾选复选框启用。刚执行完安装命令的话如果搜索不到重启一次 Blender 再搜。4.2 在 Blender 里启动 MCP Server插件启用后回到 Blender 的 3D 视口按 N 键打开侧边栏切换到 BlenderMCP 标签页点击 Start MCP Server服务默认监听localhost:9876。端口有冲突的话可以用BLENDER_HOST和BLENDER_PORT两个环境变量覆盖默认值Codex 的 MCP 配置里也支持给 MCP Server 传环境变量[mcp_servers.blender] command uvx args [blender-mcp] env { BLENDER_HOST localhost, BLENDER_PORT 9876 }MCP 服务同一时间只能跑一个实例。不要同时让 Codex 和 Claude Desktop 之类的其他客户端连接 blender-mcp先在一个客户端用完再换另一个否则会冲突。5. 验证自然语言指令从一条 sphere 指令到完整场景5.1 第一条连接测试全部配置完成后在 Blender 里点击 Start MCP Server确保端口监听正常然后启动 Codex输入第一句测试指令Create a sphere and place it above the cubeBlender 视口里出现球体说明 Codex → blender-mcp → Blender 的整条链路已经通了。这句指令会先由 Codex 的主模型理解意图然后 Codex 决定调用 blender-mcp 的工具最终由 Blender 插件在场景里执行。整个过程的 Token 消耗记在 TaoToken 这把 Key 上。5.2 复杂场景指令与保存习惯链路通了之后可以试官方给的复杂场景指令比如Create a low poly dungeon scene with a dragon guarding a pot of goldCreate a beach scene using HDRIs, textures, and vegetation from Poly HavenCodex 会把描述拆解成一系列 Blender 命令场景实时生成。注意 blender-mcp 提供的execute_blender_code工具可以在 Blender 内执行任意 Python 代码AI 操作前先保存 Blender 工程文件避免复杂场景下误操作丢掉已有成果。建议分步骤下指令别一次让 AI 做太多改动。6. 常见问题uvx 找不到、MCP 连不上、模型鉴权失败6.1 Codex 提示需要登录或鉴权失败如果 Codex 没有走 TaoToken 通道而是弹回默认登录先检查~/.codex/config.toml里的model_provider是否指向了taotoken。再看当前终端有没有设置TAOTOKEN_API_KEY未设置的话 Codex 会报缺少 API Key 或退出登录态。最后确认模型广场里的模型 ID 是否仍存在列表更新后旧 ID 可能失效去官网重新复制一个。6.2 MCP 工具调用失败与多客户端冲突Codex 调用 blender-mcp 失败时按顺序检查三点Blender 插件是否已启用、Blender 里的 MCP 服务是否已点击 Start MCP Server、config.toml里的端口和环境变量是否与 Blender 侧一致。修改配置后记得重启 Codex。codex mcp list里看不到 blender或 Codex 说找不到uvx多半是 PATH 问题。用where uvx或which uvx查到完整路径把command改成完整路径即可。如果 Blender 插件列表里搜不到Interface: Blender MCP先确认执行过uvx blender-mcp install-addon再确认 Blender 版本在 3.0 以上。7. 跑通之后去控制台对一下这次调用配置保存后先在 TaoToken 模型对话 里用同一把 Key 发一条消息确认模型 ID 和 Base URL 没填错。回到 Codex 再跑一次刚才的 sphere 指令看看 Blender 里是否正常生成物体。这次会话产生的 Token 消耗会记录在 TaoToken 控制台。长期用自然语言调 Blender 的话可以看一下 Coding Plan 里的套餐是否够用Key 不够用时直接在 控制台 API Keys 里新建。把模型广场的模型 ID、Codex 的config.toml、Blender 里的 MCP 服务状态三者对齐后面再用就很稳。