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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址https://taotoken.net/api拿到 Key 之后去控制台创建并复制后面写进配置文件API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content本地环境这块我实测下来需要这几样组件版本参考作用Claude Desktop最新版承载 MCP 客户端Blender4.2.x3D 建模宿主Python3.10addon 运行依赖uv / uvx最新启动 blender-mcpblender-mcpGitHub 最新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.jsonmacOS~/Library/Application Support/Claude/claude_desktop_config.json用编辑器打开没有就新建写入下面这个骨架。注意TAOTOKEN_API_KEY换成你在控制台复制的真实 Keyblender这一段就是本篇的核心{ 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5. 本篇常见错误排查配置过程中踩坑概率最高的几个点我按出现频率排一下。错误一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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6. 长期用下去把 MCP 接入纳入日常工作流单次配置跑通之后真正提升效率的是把它变成习惯。我自己的做法是开 Blender 之前先确认 MCP Server 已启动然后在 Claude Desktop 里用自然语言描述场景结构让 Claude 先把基础几何体和灯光摆好再手动精修材质和细节。这样省掉的是最枯燥的“搭骨架”阶段。如果你后续还要接更多 MCP Server或者想把 Claude 用在长期编码、Agent 任务上可以考虑 Coding Plan把模型调用和工具链统一管理Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentClaude Code 相关的接入配置也可以参考这份文档思路和 Blender MCP 一致都是把 API 通道和工具调用解耦ClaudeCodeAnthropic 文档https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后给一个实用技巧把常用的建模指令存成片段比如“清空场景并创建地面平面”“给选中物体加细分曲面”下次直接粘贴比每次重新描述快得多。Blender MCP 的价值不在于替代手动建模而在于把重复性的场景搭建交给自然语言让你把精力留在真正需要审美判断的地方。