1. Blender 里接 MCP到底解决什么问题如果你在 Blender 里做过稍微复杂一点的建模大概率经历过这种循环脑子里有个形状手上要一层层加修改器、调参数、对齐坐标一个下午就没了。AI 辅助建模的价值就在于你可以用自然语言描述“给我一个带倒角的低多边形机械臂关节”让模型直接生成脚本或操作指令Blender 执行完你再看效果。而 MCPModel Context Protocol就是让 AI 客户端和 Blender 之间能“对话”的那层协议。Blender MCP 的组合本质是把 Blender 变成一个可被 AI 调用的工具节点。你不需要手动写 bpy 脚本AI 通过 MCP 服务把指令传进 BlenderBlender 执行后把结果返回。适合谁适合已经在用 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它和按量调用是两条路径按自己的使用频率选。模型对话验证可以用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_urlconfig.toml / settings.jsonhttps://taotoken.net/apiapi_key两处一致控制台新建的 Keyportconfig.toml9876transportconfig.tomlstdio4. 验证请求确认 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条测试消息能正常返回就说明 Key 和 API 地址没问题。这一步能把“通道问题”和“Blender 问题”分开省得后面排查时两头猜。4.3 验证 Blender 调用链路回到 AI 客户端发一条会触发 Blender 操作的指令比如“在场景里创建一个立方体并加倒角”。正常的话客户端会通过 MCP 把指令传给 BlenderBlender 执行后场景里出现物体。你可以在 Blender 里看到对象列表多了一个 Cube并且带 Bevel 修改器。如果客户端返回了工具调用记录说明 MCP 连接通了如果 Blender 场景有变化说明调用链路通了。两个都通整条链路就打通了。5. 本篇常见错排查配置和验证过程中最容易卡在这几个地方。端口不一致config.toml 里写 9876启动命令写 9877Blender 侧又是默认值。三处必须一致。排查方法启动服务后看终端输出的监听端口和配置文件对一遍。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 里的 envconfig.toml 基本不用动。如果你后面要接更多 MCP 服务也是同一套骨架复制过去改 name 和 port 就行。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各客户端的配置细节遇到格式问题可以对照。API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 轮换或者加新 Key 都在这里。长期做编码和 Agent 任务的话Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以看下额度方案。最后说个实际经验Blender MCP 的调用链路对端口和 Key 特别敏感配置改完一定重启客户端和服务别指望热加载。每次改完按第 4 节的顺序验一遍能省掉大量“明明配了却不动”的时间。