1. Windows 下 Cursor 驱动 Blender 做 AI 3D 建模MCP endpoint 到底卡在哪BlenderMCP 是什么一句话说清它是 Blender 的 Model Context Protocol 集成插件把 Blender 变成一个可以被 AI 客户端调用的工具服务端。你在 Cursor 里用自然语言说「生成一只小猪」Cursor 通过 MCP 协议把指令发给 BlenderBlender 在场景里真的把模型建出来。适合谁适合想用 AI 辅助 3D 建模、又不想手写 Python 脚本的 Windows 用户尤其是做概念稿、占位模型、批量场景搭建的人。但真正上手时卡点几乎都不在「装 Blender」这一步而是卡在 MCP 服务端的 endpoint 与鉴权配置上。默认的 blender-mcp 走本地 stdio 启动Cursor 里填一段uvx blender-mcp就能跑可一旦你想把模型请求统一走一个可控的入口、想换模型、想集中管理 Key就需要把 MCP 的 endpoint 指向一个兼容 OpenAI 协议的服务地址。这一步在 Windows 上尤其容易翻车路径带空格、PowerShell 执行策略、uvx 找不到、环境变量没生效、Cursor 里 MCP 指示灯一直黄或红。这篇就按「Windows Cursor BlenderMCP Blender」这条链路把 endpoint 改到 TaoToken 的完整落地路径写清楚从插件安装、MCP 配置片段、统一 Key 填写位置到用一次建模指令验证连通与返回结果再到 401、local proxy failed、reading choices 这些真实报错的排查。你照着做能跑通一次完整的「说话→建模」闭环。先说清楚整体数据流后面配置才不会晕Cursor 作为 MCP 客户端读取mcp.json里的 server 定义server 进程blender-mcp负责和 Blender 插件通信而模型推理请求则走你在 Cursor 里配置的模型服务地址。把 endpoint 改到 TaoToken本质是让「模型这一层」走统一入口Blender 插件那一层仍然是本地 socket 通信两者不要混为一谈。很多人配错就是把模型 Base URL 填到了 MCP server 的 args 里结果 Blender 连不上、模型也不回。2. TaoToken 前置准备统一 Key 与 MCP endpoint 的对应关系在动手改配置前先把 TaoToken 这一侧准备好。TaoToken 在这里扮演的角色是「模型请求的统一入口」你拿到一个 Key把 Cursor 的模型 Base URL 指向它之后无论用哪个模型鉴权都用这一个 Key。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM配置里就填它。你需要准备三样东西我把它叫「三件套」后面所有配置都围绕它第一件是 Base URL。填https://taotoken.net/api注意不要带结尾斜杠也不要在后面拼/v1之外的多余路径具体以接入文档为准。第二件是 API Key在控制台的 API Keys 页面创建复制出来是一串以sk-开头的字符串只显示一次丢了就重建。第三件是 Model ID也就是你要调用的模型标识比如常见的对话模型或代码模型 ID填错会直接报 model not found。这里有个 Windows 用户特别容易忽略的点Key 不要写进会提交到 Git 的文件里。Cursor 的mcp.json如果放在项目目录下很容易被一起提交。建议把 Key 放在用户级配置或环境变量里MCP 配置里用引用方式读取。我试过把 Key 直接写死在mcp.json结果一次误提交就得全部重建这个坑你别踩。关于入口选择给你一个分流建议如果你只是排障、验证接入是否通先去 API Keys 页面拿 Key再对照接入文档核对 Base URL 和 Model ID如果你要验证某个模型到底能不能用去模型对话页面直接发一条消息试如果你是长期用 Cursor 做编码和 Agent 任务考虑 Coding Plan额度更稳。这三个入口分别对应不同场景别只盯着首页。还有一个概念要澄清MCP endpoint 和模型 endpoint 不是同一个东西。MCP endpoint 指的是 Cursor 里 MCP server 的启动方式本地 stdio 命令模型 endpoint 指的是 Cursor 设置里模型请求的 Base URL。把「MCP endpoint 改到 TaoToken」这句话拆开理解就是MCP server 仍然本地启动但它背后调用的模型请求走 TaoToken。这样理解配置就不会互相污染。3. 可复制配置mcp.json 与 Cursor 模型设置片段这一节是全文最核心的部分所有片段都可以直接复制。先装环境Blender 3.0 以上、Cursor、Python 3.10 以上然后装 uv 包管理器。在 PowerShell 里执行powershell -c irm https://astral.sh/uv/install.ps1 | iex装完后把 uv 所在目录加进当前会话的 PATH$env:Path C:\Users\Administrator\.local\bin;$env:Path注意这里的用户名要换成你自己的。如果执行策略报错先跑Set-ExecutionPolicy Restricted -Scope CurrentUser再重试。接着装 Blender 插件打开 BlenderEdit → Preferences → Add-ons → Install选中 blender-mcp 仓库里的addon.py安装后勾选Interface: Blender MCP。然后在 Blender 右上角小箭头里找到 BlenderMCP 面板点「连接 MCP 服务」此时 Blender 侧进入监听状态。然后是 Cursor 的 MCP 配置。打开 Cursor Settings → MCP → Add new把下面这段 JSON 粘进mcp.json{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }保存后点 Disabled 切换为启用。这段配置只负责启动本地 MCP server不涉及模型鉴权。真正把模型请求指向 TaoToken 的地方在 Cursor 的模型设置里。找到 Models 或 API 配置区域按下面三件套填写{ baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: 你的Model ID }如果你用的是支持settings.json的客户端形态可以写成{ models: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: 你的Model ID } }三件套必须齐全Base URL、Key、Model ID缺一个都会失败。Base URL 填错会 404Key 填错会 401Model ID 填错会 model not found。填完后重启 Cursor让配置生效。此时 Blender 面板的指示灯应该是绿色黄色和红色都代表没连上先别急着发指令回到第 5 节排查。4. 验证请求用一次建模指令确认连通与返回结果配置完别急着做复杂模型先用一条最小指令验证链路。打开 Cursor 左上角设置旁边的图标切到 Agent 模式输入用 blender 生成一只小猪发送后Cursor 会提示 Run tool点确认。正常情况下你会在 Blender 视口里看到对象被逐步创建出来Cursor 侧会显示工具调用返回结果。这一步验证了三件事MCP server 启动成功、Blender 插件在监听、模型请求经 TaoToken 正常返回。如果想让结果更精细勾选 Hyper3D 选项它会走更高精度的生成路径但耗时更长第一次验证不建议开。验证通过后你可以换成更具体的指令比如「生成一个带材质的地面平面尺寸 10x10」观察 Blender 里是否真的出现对应对象和材质节点。验证时重点看返回结构。一次成功的工具调用返回里应该包含类似content数组里面有文本描述或对象信息。如果你看到的是空数组、或者报reading choices之类的错误说明模型响应结构没被正确解析多半是 Base URL 或 Model ID 不对。这时候回到第 3 节核对三件套别在 Blender 侧反复折腾。再给一个更贴近实战的验证指令用来确认多步工具调用是否稳定在 blender 里创建一个立方体然后把它沿 Z 轴移动 2 个单位并给它加一个红色材质这条指令会触发多次工具调用能暴露「单次能通、连续调用断连」的问题。如果第一次成功、第二次失败通常是 MCP server 进程被回收或 Blender 插件掉线重启 Blender 插件并重新勾选即可。验证通过后你就有了一个可用的 AI 建模闭环后面可以放心做复杂场景。5. 本篇常见错排查401、local proxy failed、reading choices这一节按真实报错来遇到哪个查哪个。401 UnauthorizedKey 错了或没带上。检查apiKey是否是完整的sk-开头字符串有没有多余空格有没有被换行截断。如果你把 Key 放在环境变量里确认 Cursor 是从正确的环境读取的Windows 下改完环境变量要重启 Cursor 才生效。local proxy failed / connection refusedMCP server 没起来。先在 PowerShell 里手动跑uvx blender-mcp看是否能正常启动。如果提示找不到 uvx说明 PATH 没配好回到第 3 节把.local\bin加进 PATH。如果手动能跑、Cursor 里不行检查mcp.json里的command是不是cmdargs是不是[/c, uvx, blender-mcp]Windows 下必须用cmd /c包一层。reading choices / Cannot read properties of undefined模型返回结构不对。这几乎都是 Base URL 或 Model ID 的问题。确认 Base URL 是https://taotoken.net/api没有多余路径确认 Model ID 是当前可用的模型标识。改完重启 Cursor。Blender 指示灯黄/红插件没连上。找到 uv 包目录C:\Users\Administrator\.local\bin在该路径下把地址栏替换成cmd回车输入uvx blender-mcp回车看输出。然后重启 Blender重新勾选 MCP 插件重复第 3 节的连接动作。注意每次重启 Blender 后都要重新勾选插件这是高频坑。OAuth / 鉴权弹窗反复出现说明客户端在尝试走 OAuth 流程而你的配置是 API Key 模式。检查是否误开了某个 OAuth 开关或者在mcp.json里混入了鉴权字段。MCP server 本身不需要 OAuth鉴权只在模型请求层用 Key 就够了。PowerShell 执行策略报错按提示执行Set-ExecutionPolicy Restricted -Scope CurrentUser然后重新运行安装命令。如果还不行用管理员权限开 PowerShell 再试一次。排查顺序建议固定先手动跑uvx blender-mcp确认 server 能起再确认 Blender 插件绿灯最后确认模型三件套。三层分开查比一股脑改配置快得多。6. 把 endpoint 固定下来长期用 Cursor 做 AI 建模的接入建议跑通一次之后建议把配置固定成可复用的形态而不是每次重来。MCP 配置和模型配置分开管理mcp.json只管 server 启动模型三件套放在用户级设置里避免项目切换时丢失。Key 用环境变量或用户级配置引用不要写进项目目录。如果你打算长期用 Cursor 做编码和 Agent 任务包括这种 AI 建模工作流可以了解 Coding Plan额度和稳定性更适合持续使用。需要核对 Key 和 Base URL 时去 API Keys 页面和接入文档想单独验证某个模型能不能用去模型对话页面发一条消息最快。这三个入口按场景选别每次都从首页绕。最后留一个实用习惯每次改完配置先用第 4 节那条「生成一只小猪」的最小指令验证通过了再上复杂场景。这样出问题时你能立刻判断是配置问题还是指令问题排查成本最低。