企业官网建设流程全解析

1. Windows 下 Cursor 驱动 Blender 做 AI 3D 建模，MCP endpoint 到底卡在哪

BlenderMCP 是什么？一句话说清：它是 Blender 的 Model Context Protocol 集成插件，把 Blender 变成一个可以被 AI 客户端调用的工具服务端。你在 Cursor 里用自然语言说「生成一只小猪」，Cursor 通过 MCP 协议把指令发给 Blender，Blender 在场景里真的把模型建出来。适合谁？适合想用 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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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 插件：打开 Blender，Edit → 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 填错会 404，Key 填错会 401，Model 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 Unauthorized：Key 错了或没带上。检查apiKey是否是完整的sk-开头字符串，有没有多余空格，有没有被换行截断。如果你把 Key 放在环境变量里，确认 Cursor 是从正确的环境读取的，Windows 下改完环境变量要重启 Cursor 才生效。

local proxy failed / connection refused：MCP server 没起来。先在 PowerShell 里手动跑uvx blender-mcp，看是否能正常启动。如果提示找不到 uvx，说明 PATH 没配好，回到第 3 节把.local\bin加进 PATH。如果手动能跑、Cursor 里不行，检查mcp.json里的command是不是cmd，args是不是["/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 节那条「生成一只小猪」的最小指令验证，通过了再上复杂场景。这样出问题时你能立刻判断是配置问题还是指令问题，排查成本最低。