1. 为什么要在 Claude Desktop 里接 Blender MCP Server
如果你平时用 Blender 做 3D 建模，大概率经历过这种循环：脑子里想好一个形状，然后手动去点菜单、拉参数、调坐标，一个简单场景折腾半小时。Claude Desktop 接入 Blender MCP Server 之后，你可以直接用自然语言描述需求，比如“在原点创建一个半径 2 的球体，加一个金属材质，再打一盏面光”，Claude 会通过 MCP 协议把指令转成 Blender 里的实际操作，模型直接出现在视口里。
这套流程适合三类人：一是刚学 Blender、对快捷键和面板还不熟的新手，用说话代替找按钮；二是需要快速搭场景草模的创作者，先把构图跑通再精修；三是想研究 MCP 协议怎么落地的开发者，Blender MCP 是一个结构清晰、反馈直观的案例。
整个链路的核心是 MCP Server 作为桥梁：Claude Desktop 负责理解你的话并生成工具调用，Blender 端的 addon 负责执行建模命令，中间通过本地 socket 通信。而 Claude Desktop 本身要能稳定调用模型，就需要一个可靠的 API 通道。这篇就用 TaoToken 作为统一接入点，把 Key 配置、MCP Server 启动、验证请求三步串起来，全程可复制。
2. 前置准备：TaoToken 通道与本地环境
在动 Blender 之前，先把两件事准备好：模型通道和本地依赖。
TaoToken 在这里的角色是提供统一的 API 接入点，让 Claude Desktop 能通过一个 Key 访问模型能力。你不需要在多个平台之间切换，配置一次就能在 Claude Desktop、Coding Plan 等场景复用。先到官网注册并拿到 Key：
官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= API 地址：https://taotoken.net/api
拿到 Key 之后，去控制台创建并复制，后面写进配置文件：
API Keys 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
本地环境这块，我实测下来需要这几样：
| 组件 | 版本参考 | 作用 |
|---|---|---|
| Claude Desktop | 最新版 | 承载 MCP 客户端 |
| Blender | 4.2.x | 3D 建模宿主 |
| Python | 3.10+ | addon 运行依赖 |
| uv / uvx | 最新 | 启动 blender-mcp |
| blender-mcp | GitHub 最新 | MCP Server 本体 |
Python 建议 3.10 以上，Blender 4.2 自带的 Python 一般够用。uv 的安装命令：
pip install uv装完确认一下：
uv --version uvx --version两个都能输出版本号就说明工具链就绪。接下来去 GitHub 拉 blender-mcp 仓库，把里面的addon.py下载到本地，这个文件待会儿要装进 Blender。
3. 可复制配置：Claude Desktop 配置文件骨架
Claude Desktop 的 MCP 配置集中在一个 JSON 文件里。不同系统路径不一样：
- Windows：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
用编辑器打开（没有就新建），写入下面这个骨架。注意TAOTOKEN_API_KEY换成你在控制台复制的真实 Key，blender这一段就是本篇的核心：
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"], "env": { "TAOTOKEN_API_KEY": "sk-你的Key", "TAOTOKEN_BASE_URL": "https://taotoken.net/api" } } } }如果你之前已经配过 filesystem、fetch 之类的 Server，把blender这一段追加到现有mcpServers对象里就行，不用删旧的。保存后完全退出 Claude Desktop 再重启，托盘里右键退出才算彻底关闭。
重启后打开 Claude Desktop，在输入框附近能看到工具图标，点开如果列表里出现blender，说明 MCP Server 已经被识别。这一步是整个流程里最容易出错的环节，配置格式、路径、Key 三者任一有问题都会导致 Server 不加载。
4. Blender 端启动 MCP Server 并验证连接
Claude Desktop 认到 Server 只是第一步，Blender 那边还得把服务跑起来，两边才能握手。
打开 Blender，进入Edit > Preferences > Add-ons，点右上角Install，选中刚才下载的addon.py。装好后在列表里搜索 “Blender MCP”，勾选启用。启用后 3D 视口侧边栏（按N键调出）会出现一个BlenderMCP面板。
在面板里点Start MCP Server，下方状态会变成类似Server running on port 9876的提示。这个端口是 addon 默认的监听端口，Claude Desktop 侧的 blender-mcp 会去连它。
注意：如果端口被占用，可以在面板里改端口，同时确认没有其他程序占用 9876。
两边都起来之后，回到 Claude Desktop 发一条测试指令，比如：
用 Blender 在场景原点创建一个立方体，边长 2，然后把它沿 Z 轴向上移动 1 个单位。正常情况下 Claude 会先说明它要调用 blender 工具，然后你会在 Blender 视口里看到立方体出现并上移。如果 Claude 回复“我没有可用的 blender 工具”，说明 MCP Server 没连上，回到第 5 节排查。
想更直观地验证模型通道是否正常，可以先用模型对话页面发一条普通请求，确认 Key 和 API 地址可用：
模型对话：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
5. 本篇常见错误排查
配置过程中踩坑概率最高的几个点，我按出现频率排一下。
错误一：Claude Desktop 里看不到 blender 工具。九成是 JSON 格式问题。常见的是多了一个逗号、少了一个引号，或者mcpServers拼错。把配置贴到任意 JSON 校验工具里过一遍，确认无误再重启。另外确认改的是当前用户目录下的配置文件，不是安装目录里的。
错误二：uvx 找不到 blender-mcp。首次运行uvx blender-mcp会去拉包，如果网络环境导致拉取失败，可以手动先跑一次：
uvx blender-mcp --help能正常输出帮助信息，说明包已缓存，Claude Desktop 再调用就不会卡在下载。
错误三：Blender 面板点了 Start 但 Claude 连不上。检查 addon 是否真的启用（勾选框），以及端口是否和默认一致。如果 Blender 重启过，MCP Server 不会自动启动，需要重新点一次Start MCP Server。
错误四：指令发出后 Blender 没反应。看 Blender 左下角状态栏有没有报错，常见的是 addon 版本和 Blender 版本不匹配。去仓库确认 addon 支持的最低 Blender 版本，必要时升级 Blender。
错误五：Key 无效或额度问题。如果 Claude 能识别工具但调用时报鉴权错误，去控制台确认 Key 是否复制完整、是否被禁用。接入文档里有各语言的调用示例，可以对照检查：
接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
6. 长期用下去：把 MCP 接入纳入日常工作流
单次配置跑通之后，真正提升效率的是把它变成习惯。我自己的做法是：开 Blender 之前先确认 MCP Server 已启动，然后在 Claude Desktop 里用自然语言描述场景结构，让 Claude 先把基础几何体和灯光摆好，再手动精修材质和细节。这样省掉的是最枯燥的“搭骨架”阶段。
如果你后续还要接更多 MCP Server，或者想把 Claude 用在长期编码、Agent 任务上，可以考虑 Coding Plan，把模型调用和工具链统一管理：
Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
Claude Code 相关的接入配置也可以参考这份文档，思路和 Blender MCP 一致，都是把 API 通道和工具调用解耦：
ClaudeCodeAnthropic 文档：https://taotoken.net/doc/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
最后给一个实用技巧：把常用的建模指令存成片段，比如“清空场景并创建地面平面”“给选中物体加细分曲面”，下次直接粘贴，比每次重新描述快得多。Blender MCP 的价值不在于替代手动建模，而在于把重复性的场景搭建交给自然语言，让你把精力留在真正需要审美判断的地方。
