1. Blender 里接上 MCP 到底解决什么问题Blender 本身是个很成熟的建模工具但它的操作门槛一直摆在那加一个倒角要记快捷键展一次 UV 要来回切编辑器写个批量脚本还得翻 Python API 文档。MCPModel Context Protocol出现之后这件事有了新解法——它把 Blender 变成一个可以被 AI 工具调用的「能力端」你在 Claude 或 Cursor 里用自然语言描述需求AI 通过 MCP 协议把指令翻译成 Blender 能执行的操作模型、材质、UV 这些环节都能被串起来。我第一次接触这套组合的时候最直观的感受是它不是在替代 Blender而是在给 Blender 加一个「会写脚本的助手」。你依然要理解建模逻辑但那些重复性的、记不住 API 的操作可以交给 AI 去生成并执行。这套流程适合几类人一是刚学 Blender、快捷键还没形成肌肉记忆的新手可以用自然语言驱动来降低起步难度二是需要批量处理 UV、批量生成变体模型的开发者MCP 能把脚本能力暴露给 AI三是已经在用 Claude Code 或 Cursor 做开发的工程师想把 3D 资产流程也纳入 AI 工作流。整条链路的核心是三段Blender 端装 MCP 插件并启动服务AI 工具端配置 MCP Server 指向 Blender中间通过统一的 API 通道比如 TaoToken把 Claude、Cursor 这些工具的模型调用收敛到一个 Key 上。下面按这个顺序拆开讲每一步都给可复制的配置。2. TaoToken 前置统一 Key 与 API 通道在配置 Blender MCP 之前先把 AI 工具侧的通道理顺。原因很简单Claude 桌面版、Cursor、Claude Code 这些工具各自要填 API Key 和 Base URL如果每个都单独申请、单独管理后面排障会非常痛苦。TaoToken 的作用就是提供一个统一的 API 入口把这些工具的模型调用收敛到一套 Key 上。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数配置的时候直接填这个。你需要先在控制台创建一个 API Key。进入 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面点新建复制生成的 Key。这个 Key 后面会同时用在 Claude 桌面版的配置、Cursor 的 MCP 配置以及 Claude Code 的环境变量里。模型 ID 这块要注意不同工具对模型名的写法要求不一样。Claude 桌面版走的是 Anthropic 兼容格式Cursor 里如果走 OpenAI 兼容格式模型名要按对应规范填。TaoToken 的文档页 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整的模型列表和对应的 Base URL 写法配置前建议先对一遍。如果你打算长期用这套组合做编码和 Agent 任务可以看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它适合高频调用场景比按量计费更划算。只是想先验证模型对话能不能通用模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 快速测一下就行。这里有个容易踩的坑很多人以为 MCP 配置里填的是 Blender 的地址其实不是。MCP 配置里的 command 和 args 指向的是 blender-mcp 这个本地服务进程而 AI 工具调用模型时走的才是 TaoToken 的 API 地址。这两条链路是分开的别混在一起。3. 可复制配置Blender 插件 Claude/Cursor MCP这一节给完整的配置片段路径和原文保持一致你直接复制改路径就行。3.1 Blender 端安装 MCP 插件先确认 Blender 版本3.0 以上都可以。打开 Blender进入 编辑 首选项 附加组件 安装选择 blender-mcp 仓库里的 addon.py 文件。安装完成后在列表里勾选「界面Blender MCP」启用。如果侧边栏没出来在 3D 视图里按 N 键调出。插件启用后侧边栏会出现「Blender MCP」标签页里面有一个「启动 MCP 服务器」按钮。先别急着点等 AI 工具端配置好再启动。3.2 安装 uv 包管理器blender-mcp 依赖 uv 来管理 Python 环境需要 Python 3.10。Mac 下用 brewbrew install uvWindows 下用 PowerShellpowershell -c irm https://astral.sh/uv/install.ps1 | iex安装完成后在终端跑uv --version确认。如果提示找不到命令把 uv 的安装路径加到环境变量里Windows 一般在%USERPROFILE%\.local\binMac 在~/.local/bin。3.3 Claude 桌面版 MCP 配置打开 Claude 桌面版进入 设置 开发者 编辑配置会打开claude_desktop_config.json。填入以下内容uvx 路径按你实际安装位置改{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后完全退出 Claude 再重启不是关窗口是托盘里也退掉。3.4 Cursor MCP 配置打开 Cursor进入设置左侧点 MCP填入同样的配置。Cursor 的 MCP 配置格式和 Claude 基本一致{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后重启 Cursor。如果你在 Cursor 里同时用 TaoToken 的 API 通道模型配置那块要单独填 Base URL 和 Key和 MCP 配置是两个地方。3.5 Claude Code 的 auth.json 配置如果你用 Claude Code 做命令行侧的 Agent 任务配置文件在~/.claude/auth.jsonWindows 在%USERPROFILE%\.claude\auth.json。三件套要写全{ baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, model: claude-sonnet-4-20250514 }Base URL、Key、Model ID 三个都不能少缺一个就会报 401 或者 model not found。Model ID 按 TaoToken 文档里的实际名称填别自己拼。4. 验证请求从启动服务到第一个模型配置写完接下来验证整条链路能不能通。4.1 启动 Blender MCP 服务回到 Blender在侧边栏「Blender MCP」标签页点「启动 MCP 服务器」。或者在终端直接跑uvx blender-mcp终端会输出服务启动日志看到监听端口和 ready 字样就说明服务起来了。这时候回到 Claude 或 Cursor聊天框旁边应该出现一个锤子图标表示 MCP Server 已连接。4.2 发第一条建模指令在 Claude 聊天框输入清除场景中所有物体创建一个简单的房子带屋顶和门Claude 会通过 MCP 把指令发给 BlenderBlender 端执行后返回结果。你会在 Blender 视图里看到模型被创建出来同时 Claude 会反馈它执行了哪些操作步骤。如果这一步没反应先看 Blender 侧边栏的日志有没有收到请求再看 Claude 的 MCP 状态是不是 connected。两边日志对照着看能快速定位是 MCP 链路断了还是模型调用失败了。4.3 验证 UV 展开场景模型建好后继续发一条 UV 相关的指令给当前选中的模型做智能 UV 展开角度限制 66 度岛间距 0.02这条指令会触发 Blender 的 UV 展开操作。执行成功后切到 UV 编辑器能看到展开后的 UV 布局。这一步是验证 MCP 能不能驱动 Blender 的编辑模式操作不只是创建物体。4.4 验证模型调用通道MCP 链路通了之后单独验证一下 TaoToken 的模型通道。在模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 发一条测试消息确认返回正常。如果这里报错说明是 API Key 或 Base URL 的问题和 MCP 无关。5. 本篇常见错排查配置过程中最容易卡在几个固定报错上逐个说。401 Unauthorized这个基本是 Key 的问题。检查三处TaoToken 控制台里 Key 有没有被禁用、配置文件里 Key 有没有多余空格、Base URL 是不是写成了https://taotoken.net/api而不是带路径的地址。Claude Code 的 auth.json 里如果 baseUrl 写成https://taotoken.net/api/v1也可能 401按文档给的格式来。local proxy failed / connection refused这个报错说明 AI 工具连不上本地 MCP 服务。原因通常是 Blender 端的 MCP 服务器没启动或者 uvx 路径不对。先在终端手动跑uvx blender-mcp看能不能起来。如果终端能起来但 Claude 连不上检查 claude_desktop_config.json 里的 command 是不是 uvx 的绝对路径。Windows 下有时候要写全路径比如C:\\Users\\你的用户名\\.local\\bin\\uvx.exe。reading choices 报错这个通常出现在 Cursor 里说明模型返回格式和预期不符。检查 Cursor 的模型配置是不是走了 OpenAI 兼容格式Base URL 和模型名要匹配。如果用的是 Anthropic 格式的模型名但走了 OpenAI 兼容端点就会报这个。OAuth 相关报错Claude 桌面版有时候会弹 OAuth 登录如果你用的是 API Key 模式在设置里确认没有开启 OAuth 登录选项。auth.json 里如果同时有 OAuth token 和 apiKey可能会冲突清掉 OAuth 部分只留 apiKey。MCP 显示 connected 但指令无响应这种是链路通了但 Blender 端没执行。检查 Blender 是不是在前台、有没有弹窗挡住、侧边栏日志有没有报 Python 异常。blender-mcp 依赖的 Python 环境如果缺包会在日志里打出来按提示补装。uvx 找不到 blender-mcp说明 uv 的包索引没拉到或者网络问题。先跑uvx blender-mcp --help看能不能拉到包。如果一直卡在下载检查 uv 的镜像配置。6. 把这条链路用起来配置跑通之后实际用起来有几个技巧。建模阶段指令要具体。与其说「做个椅子」不如说「创建一个北欧风格的木椅四条腿靠背有横档尺寸 0.5m x 0.5m x 0.9m」。AI 拿到的约束越多生成的脚本越准。UV 展开这块角度限制和岛间距这两个参数对结果影响很大66 度和 0.02 是我试过比较通用的起点具体模型要微调。批量任务用 MCP 特别省事。比如你要给 20 个模型统一做 UV 展开写一条循环指令让 AI 生成脚本比手动一个个展快得多。这种场景下 Claude Code 配合 TaoToken 的 Coding Plan 会比桌面版更顺手因为命令行侧的脚本执行和文件操作更直接。工具分工上Claude 桌面版适合交互式建模边聊边调Cursor 适合在写 Blender Python 脚本的时候用代码补全和 MCP 调用在同一个界面Claude Code 适合跑批量任务和 Agent 流程。三个工具可以共用一套 TaoToken 的 Key切换的时候只改工具侧配置不用重新申请。最后提醒一点MCP 驱动 Blender 执行的是真实操作指令发出去之前确认一下当前场景有没有未保存的改动。AI 执行「清除所有物体」这种指令是不会问你确不确定的该保存的先保存。