1. Blender 里接 MCP，到底解决什么问题
如果你在 Blender 里做过稍微复杂一点的建模，大概率经历过这种循环：脑子里有个形状，手上要一层层加修改器、调参数、对齐坐标，一个下午就没了。AI 辅助建模的价值就在于，你可以用自然语言描述“给我一个带倒角的低多边形机械臂关节”，让模型直接生成脚本或操作指令，Blender 执行完你再看效果。而 MCP（Model Context Protocol）就是让 AI 客户端和 Blender 之间能“对话”的那层协议。
Blender + MCP 的组合，本质是把 Blender 变成一个可被 AI 调用的工具节点。你不需要手动写 bpy 脚本，AI 通过 MCP 服务把指令传进 Blender，Blender 执行后把结果返回。适合谁？适合已经在用 Claude、Cursor 这类支持 MCP 的客户端，又想在 Blender 里做 AI 辅助建模的开发者。但这里有个现实问题：不同 AI 客户端的 Key 和接入地址各管各的，Claude 一套、Cursor 一套，切换起来很烦。这篇教程用 TaoToken 统一 Key 和 API 通道，把配置收敛到一处，后面不管换哪个客户端，改的都是同一份骨架。
我试过把 Claude 和 Cursor 分别配一遍，结果两边配置格式不一样，改一个忘一个。统一走 TaoToken 之后，config.toml 和 settings.json 各写一次，后面只维护这两个文件就行。下面从环境准备开始，一步步把链路打通。
2. TaoToken 前置：统一 Key 与 API 通道
在动手配 Blender 之前，先把 TaoToken 这边的准备工作做完。TaoToken 在这里的角色是统一入口：你拿到一个 Key，配一个 API 地址，后面 Claude、Cursor 都指向它，不用每个客户端单独申请。
第一步，打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册并登录。登录后进控制台，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，在控制台里找到 API Keys 页面，新建一个 Key。这个 Key 就是后面所有客户端共用的那一把。
API 通道地址统一用 https://taotoken.net/api ，注意这个地址不带 UTM 参数，配置里直接写这个。Key 拿到后先别急着关页面，后面 config.toml 和 settings.json 都要填。
注意：Key 只显示一次，复制后存到安全的地方。不要写进会提交到 Git 的公开文件里。
如果你后面主要做长期编码或者 Agent 类任务，可以顺带看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，它和按量调用是两条路径，按自己的使用频率选。模型对话验证可以用 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 先确认通道通不通。
3. 可复制配置：config.toml 与 settings.json
这一节是全文的核心，配置写对了，后面验证基本一次过。分两块：一块是 MCP 服务端的 config.toml，一块是 AI 客户端的 settings.json。
3.1 环境准备与 Blender MCP 插件
先确认本机环境：Blender 装好（官网下载对应系统版本即可），Python 3.10+，以及 uv 包管理器。uv 用来装 MCP 依赖，没装的用官方脚本装一下。
Blender MCP 插件这边，克隆 blender-mcp 仓库后，打开 Blender，依次点 编辑 > 首选项 > 附加组件 > 安装，选择仓库里的 addon.py。装完勾选“界面：Blender MCP”启用。如果侧边栏没出来，在 3D 视图里按 N 键调出。
3.2 config.toml 示例
MCP 服务端的配置文件用 config.toml，放在你的 MCP 工作目录下。内容骨架如下：
# config.toml [mcp] name = "blender-mcp" transport = "stdio" [api] base_url = "https://taotoken.net/api" api_key = "你的_TaoToken_Key" model = "claude-sonnet" [blender] host = "127.0.0.1" port = 9876 timeout = 30这里 base_url 固定写 https://taotoken.net/api ，api_key 填第 2 步拿到的 Key。model 按你实际要用的填，port 是 Blender MCP 服务监听的端口，默认 9876，后面 Blender 侧要一致。
3.3 settings.json 示例
AI 客户端这边，Claude 和 Cursor 都用 settings.json 这类配置。以 Cursor 为例，进设置，左侧找 MCP，填入：
{ "mcpServers": { "blender": { "command": "uv", "args": ["run", "blender-mcp"], "env": { "TAOTOKEN_BASE_URL": "https://taotoken.net/api", "TAOTOKEN_API_KEY": "你的_TaoToken_Key" } } } }Claude 的配置结构类似，把同样的 command、args、env 填进去就行。保存后重启客户端。这样两个客户端指向的是同一个 TaoToken 通道和同一把 Key，后面换客户端不用重配。
| 配置项 | 位置 | 值 |
|---|---|---|
| base_url | config.toml / settings.json | https://taotoken.net/api |
| api_key | 两处一致 | 控制台新建的 Key |
| port | config.toml | 9876 |
| transport | config.toml | stdio |
4. 验证请求：确认 MCP 连接与 Blender 调用链路
配置写完，必须验证，不然你不知道是配置错了还是服务没起来。分三步走。
4.1 启动 Blender MCP 服务
在 Blender 侧边栏按 N 键，找到“Blender MCP”标签页，点“启动 MCP 服务器”。或者在终端里直接跑：
uv run blender-mcp --port 9876看到服务监听在 127.0.0.1:9876 就说明起来了。如果端口被占，改 config.toml 里的 port 和启动参数保持一致。
4.2 验证 TaoToken 通道
先用模型对话页面确认通道可用，打开 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，发一条测试消息，能正常返回就说明 Key 和 API 地址没问题。这一步能把“通道问题”和“Blender 问题”分开，省得后面排查时两头猜。
4.3 验证 Blender 调用链路
回到 AI 客户端，发一条会触发 Blender 操作的指令，比如“在场景里创建一个立方体并加倒角”。正常的话，客户端会通过 MCP 把指令传给 Blender，Blender 执行后场景里出现物体。你可以在 Blender 里看到对象列表多了一个 Cube，并且带 Bevel 修改器。
如果客户端返回了工具调用记录，说明 MCP 连接通了；如果 Blender 场景有变化，说明调用链路通了。两个都通，整条链路就打通了。
5. 本篇常见错排查
配置和验证过程中，最容易卡在这几个地方。
端口不一致：config.toml 里写 9876，启动命令写 9877，Blender 侧又是默认值。三处必须一致。排查方法：启动服务后看终端输出的监听端口，和配置文件对一遍。
Key 没生效：settings.json 里 env 的变量名和 MCP 服务读取的变量名对不上。有的服务读 TAOTOKEN_API_KEY，有的读 API_KEY。以你用的 blender-mcp 版本实际读取的变量名为准，不确定就两个都填。
uv 找不到：终端报 command not found: uv。说明 uv 没装或者没进 PATH。重新跑一遍安装脚本，装完开新终端再试。
Blender 侧边栏没有 MCP 标签：插件没启用，或者装的时候选错了文件。回 首选项 > 附加组件，确认“界面：Blender MCP”是勾选状态。没勾就勾上，还不行就重装 addon.py。
客户端重启后配置丢失：settings.json 改完没保存，或者保存到了错误的路径。Cursor 的 MCP 配置在设置里填，Claude 的配置文件路径按官方文档确认，改完确认文件真的写入了。
调用超时：config.toml 里 timeout 设太小，复杂操作没跑完就断了。调到 60 或更高再试。
提示：排查顺序建议从通道到服务再到 Blender。先用模型对话确认 TaoToken 通，再确认 MCP 服务起来，最后确认 Blender 执行。这样每步只验证一件事，不会互相干扰。
6. 后续接入与 Key 管理
链路打通之后，日常维护其实很轻。Key 和 API 地址都在 TaoToken 控制台统一管，换客户端只改 settings.json 里的 env，config.toml 基本不用动。如果你后面要接更多 MCP 服务，也是同一套骨架复制过去，改 name 和 port 就行。
接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有各客户端的配置细节，遇到格式问题可以对照。API Keys 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，Key 轮换或者加新 Key 都在这里。长期做编码和 Agent 任务的话，Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 可以看下额度方案。
最后说个实际经验：Blender MCP 的调用链路对端口和 Key 特别敏感，配置改完一定重启客户端和服务，别指望热加载。每次改完按第 4 节的顺序验一遍，能省掉大量“明明配了却不动”的时间。
