Codex 安装 MCP for Blender 插件完整指南：原理、步骤与三维工作流（2026）

MCP for Blender 能把 Blender 场景操作接入 Codex：你在 Codex 中描述目标，Codex 可以读取当前场景、运行 Blender Python、查看视口，并按需搜索或导入素材。官方提供的 Codex 插件还把视口预览、素材缩略图选择、场景对象 @ 提及和较长的工具等待时间整合到客户端里。

先说清一个容易混淆的名称：这里的“Codex 插件”是安装在 Codex 客户端中的插件，不是 ChatGPT 网页普通对话里的通用插件。你需要能够运行 Codex 的桌面应用或相应 Codex 环境；同时，Blender 必须安装 MCP for Blender 插件端并保持运行。Codex 插件不会替你安装 Blender，也不会把三维场景自动变成无需人工检查的最终作品。

本文按“理解结构、安装两端、完成第一次验证、选择工作场景、控制风险”的顺序说明。官方页面和仓库可能继续更新；界面、菜单名称和可用素材服务以安装时的官方 Codex 插件文档为准，最近核对日期为 2026 年 10 月 30 日。

先看它适不适合你#

把它看成一个“自然语言到 Blender 操作”的工作接口更准确：它能减少菜单和脚本操作的来回切换，但生成质量仍取决于需求是否具体、模型是否理解正确、Blender 状态是否适合执行，以及你是否持续检查结果。

插件、MCP 服务和 Blender 插件端分别是什么#

整个链路包含三个角色，它们不是同一个安装包：

一次请求大致经过以下路径：

你在 Codex 里写下任务
  -> Codex 选择 MCP for Blender 工具
  -> 本机 Python MCP 服务发送 JSON 命令
  -> Blender 插件端在当前 Blender 会话中调用 bpy
  -> Blender 返回场景信息、执行结果或视口图像
  -> Codex 展示结果并继续下一轮修改

这也解释了为什么只安装 Codex 侧插件还不够：没有运行中的 Blender 和 Blender 插件端，服务就没有可操作的场景。官方架构说明其本地插件端默认通过 localhost:9876 通信；这属于本机进程间连接，不应理解成一个适合公开到互联网的远程 API。

Codex 插件比普通 MCP 配置多什么#

普通 MCP 配置可以让兼容客户端调用 Blender 工具；Codex 插件则进一步适配 Codex 的使用方式。官方文档列出这些客户端侧能力：

• 聊天内视口预览：Codex 获取视口图像后，可在对话中显示；场景发生变化后可继续查看最新结果，也可以展开或放到旁边查看。
• 从画面选择对象：在插件提供的视口里点选对象，可以把对象带入下一条消息，减少描述“左边那个红色物体”造成的歧义。
• 素材缩略图选择：Poly Haven、Sketchfab 和 Poly Pizza 搜索结果可用图片网格浏览，确认具体素材后再导入，而不是只凭文本名称猜测。
• 场景对象 @ 提及：在输入框键入 @，可引用场景里的对象、材质和集合，再针对具体对象下达修改。
• 更长的 Codex 工具等待时间：官方插件说明将客户端工具超时提高到 10 分钟，适合较慢的模型生成或导入任务。等待时间变长不代表服务端、网络或外部生成器一定会成功。

它不会替代 Blender 的视图、时间轴、节点编辑器、渲染器和文件管理，也不会绕过所连接模型本身的能力边界。最终几何、比例、UV、拓扑、动画曲线、渲染质量和资产授权都需要按项目标准验收。

安装前准备#

开始前确认：

1. 电脑已安装 Blender，并能正常打开一个空白或测试 .blend 文件。MCP for Blender 官方快速开始目前要求 Blender 3.0 或更新版本；请在安装时再核对官方页面是否调整。
2. 已安装并登录 Codex 客户端。Codex 插件文档描述的是 Codex，不是 ChatGPT 网页版里一个叫“插件”的按钮。
3. 能够从终端访问 GitHub，并安装项目需要的本地 Python MCP 服务。若公司电脑限制安装脚本或访问外网，先遵循组织的开发环境政策。
4. 准备一个副本或可恢复的测试场景。首次连接不要直接对唯一的生产文件进行批量操作。

官方提供的快速开始包含一键安装方式，也可通过项目安装器配置。其页面给出的跨平台命令为：

uvx mcp-for-blender setup

如果你还没有 uv，请按官方快速开始的操作安装；也可以先查看完整安装脚本和脚本来源，再决定是否运行。快速安装器会查找支持的 MCP 客户端、安装并启用 Blender 插件端，并为所选客户端写入配置。它会修改本机应用配置，因此安装前应确认目标客户端，并保留工具提供的备份文件。

官方安装脚本提供 macOS/Linux 与 Windows 不同命令。请从官方快速开始页面复制与你的系统对应的当前命令，不要把示例脚本从不明镜像运行。

安装流程：先准备 Blender，再装 Codex 插件#

第一步：安装并启用 Blender 插件端#

按官方快速开始安装 MCP for Blender。完成后完全退出并重新打开 Blender，在 3D 视图中按 N 打开侧栏，查看是否出现 MCP for Blender 面板或连接状态。保持 Blender 处于打开状态。

如果尚未安装 Codex 客户端的 MCP 服务配置，可按安装器提示选择 Codex。若已经手动配置过 MCP，先确认最终只有一个 MCP 服务实例连接这个 Blender 会话；官方特别提醒不要同时通过多个 MCP 客户端启动服务连接同一个 Blender。

第二步：把官方 Codex Marketplace 加入 Codex#

在终端运行官方插件文档提供的命令：

git clone https://github.com/ahujasid/mcp-for-blender.git
codex plugin marketplace add ./mcp-for-blender/integrations/codex

第二条命令把刚克隆仓库中的 Codex 插件目录加入本机 Marketplace。若你把仓库克隆到了其他目录，请把路径换成真实位置。不要在命令行参数中填 GitHub 网页地址代替本地目录。

第三步：重启 Codex 并安装插件#

完全退出并重新打开 Codex，在插件目录中找到并安装 MCP for Blender。官方当前说明该插件尚未进入 Codex 默认插件目录，所以需要从 GitHub 仓库添加 Marketplace。Marketplace 与 Codex 的界面可能随版本更新；若名称或入口略有差异，回到官方Codex 插件页面确认当前菜单位置。

第四步：确认两端都在线#

安装后，依次确认：

• Blender 仍在运行，且 MCP for Blender 面板显示已启用或正在监听。
• Codex 已完全重启，MCP for Blender 插件在插件管理界面处于启用状态。
• Codex 能发现相关 MCP 工具，首次请求时没有“server unavailable”或超时错误。
• 当前连接的是你预期的 Blender 进程和 .blend 文件。

如果此前用快速安装器配置了一个普通 blender MCP 服务，安装插件后也不要同时手动启动另一份服务。遇到重复连接或端口占用时，先在 Codex 的 MCP/插件设置中检查实际启用项，再依官方配置文档处理重复项。

第一次连接：用低风险任务验证#

先打开一个新建的测试文件，发送只读取信息的请求：

请连接当前 Blender，先读取场景信息并用视口截图展示当前画面。暂时不要修改对象、材质或文件。告诉我你检测到的对象名称、相机和灯光。

这条消息同时验证工具发现、Blender 连接、场景读取和视口图像返回。核对 Codex 汇报的对象是否与 Blender Outliner 中的内容一致。接着再做一个容易撤销的操作：

在当前场景中添加一个边长 2 米的立方体，放在世界原点。不要改动其他对象。完成后读取场景并打开视口截图，让我检查结果。

如果执行结果与要求不符，先让 Codex 解释它做了什么，再指定单项修正。不要一开始就要求“把整个项目做完并导出”，因为连接问题、目标歧义和建模错误会混在一起，很难判断故障点。

让 Codex 更准确理解三维任务#

一个能落地的三维请求通常包括目标、当前状态、尺寸/坐标、风格、限制、验收和保存要求。可以复制下面的模板，再删掉不相关内容：

目标：在当前 Blender 场景中制作……
使用场景：用于……，观察角度/画面比例是……
当前文件：保留……，允许新增/修改……
尺寸与位置：……（单位为……；原点和朝向按……）
视觉方向：……（颜色、材质、光线、参考风格）
限制：不要删除……；不要改……；对象命名规则为……
执行方式：先读取场景并给出计划；分阶段操作；每阶段后返回视口截图。
验收：我会检查……；不确定的地方先问我，不要自行补成最终设定。
保存：不要覆盖原文件；完成后另存为……（若需要保存）。

尤其要说明单位和比例。只写“做一个真实大小的房间”并不告诉模型门高、墙厚和家具尺寸；只写“调好灯光”也没有定义主光方向、色温、阴影或最终用途。先要求读取现有场景，通常比直接发一段长需求更稳妥。

不同使用场景怎么用#

1. 产品概念与电商静物图#

适合先做包装、简单消费品、桌面设备或展示台的基础形体和构图，再通过视口截图迭代相机、背景和主光。复杂曲面、品牌文字和精确工业尺寸应由专业流程复核。

先读取场景，不要马上修改。请为一款桌面香薰机规划产品静物场景：主体高度约 18 cm，主体为磨砂白色圆柱，顶部有深灰出雾口；搭配浅色无缝背景和柔和侧后方主光。先列出需要创建或调整的对象与相机角度，等我确认后再分步搭建。每一步后展示视口。

当造型确认后，可以继续要求指定对象或 @ 对象：“只把 @主体机身 的材质改为白色磨砂塑料，保留尺寸、位置与其他对象。”这样比“把产品弄得高级一点”可控得多。

2. 建筑空间与室内方案表达#

可让 Codex 按明确的房间长宽高、墙体开口、门窗位置和家具尺寸搭建白模，设置相机并快速比较空间布局。它更适合前期方案表达和比例草模，不应替代施工图、结构计算、法规检查或专业 BIM 流程。

新建一个 6 m × 4 m × 2.8 m 的矩形客厅白模，坐标原点在西南角地面。北墙留一扇宽 2.4 m、高 2.1 m 的窗，窗台高 0.75 m；东墙中部留 0.9 m 宽门洞。只创建墙体、地面、窗洞、门洞、沙发和茶几的白模。先输出对象清单和坐标计划，确认后再创建；不要生成装饰细节或覆盖现有文件。

可以继续让 Codex 从两个指定机位生成视口截图用于讨论。重要的是先核对坐标、单位和开口位置，再谈材质与氛围；否则精美灯光可能掩盖白模尺寸错误。

3. 游戏关卡与低多边形场景#

适合构造可读性强的关卡灰盒、低多边形环境、道具组合或素材摆放方案。让它限制对象数量、网格尺寸、命名规则和材质数量，能减少场景越来越复杂却无法管理的问题。

请在新场景中搭建一个低多边形森林关卡灰盒：地面为 40 m × 40 m，中心留出 8 m 宽的路径；沿路径放置 12 到 16 棵由简单锥体和圆柱组成的树，左右两侧不要完全对称。对象统一使用 Tree_、Path_、Ground_ 前缀，材质不超过 6 种。先读取场景并说明会新增哪些集合；完成后返回俯视和玩家视角截图。不要导入外部素材。

如果想用素材库，可先搜索并查看缩略图，再选定符合风格和授权要求的资源；导入后检查面数、比例、贴图和对象命名。不同素材服务的账号、额度或 API 凭证可能独立配置，不能假设安装插件后所有生成服务都自动可用。

4. 动画预演与镜头布局#

可先创建简化道具与角色占位物、安排镜头和分镜构图，再指定帧范围、关键动作和镜头节奏。文字描述适合快速预演，但复杂角色绑定、动作曲线细节、碰撞效果和最终渲染仍要人工调校。

请在当前空场景中创建三个占位物：桌子、杯子和一个球。把动画帧率设为 24 fps，时间范围 1 到 120 帧。球从桌面左侧滚到右侧，约第 90 帧停下；摄像机固定在桌面前方 45 度角。先只搭建静态布局并截图，不创建动画。等我确认机位后，再提出关键帧计划。

此处的关键习惯是先锁定静态构图，再单独生成动画。若布局和动画一起做，出现偏差后不容易判断是物体位置、相机还是关键帧导致。

5. 教学演示与重复性脚本任务#

教师或技术美术可以让 Codex 演示一段可解释的操作，例如创建一组不同参数的基础体、展示材质节点结构或整理集合。要求它先说明脚本会改哪些数据，再运行；必要时让它逐对象命名和汇报参数，方便学生对照 Blender 界面学习。

在测试文件中创建 5 个间距为 3 m 的球体，半径依次为 0.5、0.75、1、1.25、1.5 m。为每个球命名 Sphere_01 到 Sphere_05，并设置从蓝到黄的渐变材质。先告诉我将调用哪些 Blender 操作；执行后列出每个对象的半径和位置，并展示视口。不要保存或删除任何文件。

重复性任务尤其适合清楚列出参数和命名规范；如果结果需要进入生产管线，还应由熟悉 Blender 的人员检查对象数据、单位、材质节点和版本兼容性。

6. 外部素材与生成式 3D 模型#

MCP for Blender 的工具体系还包括素材搜索/导入以及部分外部 3D 生成服务。插件中的缩略图选择体验可以帮助你先看结果再决定导入；生成服务可能需要 API Key、账号或单独额度，具体提供商与条件以官方集成说明和对应服务页面为准。

把“生成模型”拆成四步会更稳：先说主体和风格；选择具体服务并核对费用/限制；预览或等待生成；导入后检查尺度、网格、材质和授权。不要把“能生成模型”直接理解为“得到可直接用于商业交付的优化资产”。

如何安排一次可靠的协作#

如果输出不符合预期，先引用截图中能观察到的具体问题，例如“窗洞落在东墙外侧约 0.3 m”，再要求修复一个问题。不要用“再优化一下”这种无法验收的反馈。

安全、文件和素材授权#

MCP for Blender 的 execute_blender_code 会在 Blender 中执行 Python。官方架构页面明确提醒：这具有访问 Blender 环境甚至文件系统的能力；官方默认本地连接监听 localhost，该 socket 默认没有认证或加密。基于这些事实，建议：

• 仅从项目官方文档和仓库安装。运行安装脚本前先核对官方来源、命令和组织策略。
• 首次操作使用测试文件，重要阶段另存版本或使用 Git/LFS 等已有资产版本管理方案；Codex 生成的操作可能破坏场景或覆盖对象数据。
• 让 Codex 在破坏性操作前说明对象范围，并在删除、批量重命名、覆盖文件和导出前要求确认。
• 不要把 Blender MCP 端口 9876 暴露到公网或不可信局域网。不要为了远程访问直接把 BLENDER_HOST 指向未受保护主机；官方建议需要远程连接时优先使用 SSH 隧道并由有经验者配置。
• 不要同时让多个 MCP 客户端连接并控制同一个 Blender 会话；官方说明这可能发生冲突。
• 搜索/导入外部模型和纹理时，单独确认来源许可、署名要求、商业使用限制和服务条款。能下载不代表能用于商业项目。
• 不要把客户模型、未发布产品、个人资料或商业机密发送给外部生成服务，除非已确认其数据处理规则和组织授权。

安全模式可以由环境配置启用，对部分直接文件访问、进程或网络操作做限制；这不是对所有风险的保证，也不替代隔离测试文件和审查操作。以官方配置参考当前说明为准。

常见问题排查#

遇到问题时先保存日志中的错误文本、Codex 工具名称、Blender 版本以及 MCP 面板状态。排错顺序建议是：客户端插件加载 → MCP 服务启动 → Blender 插件端监听 → 单一连接 → 工具调用 → 外部素材服务。每次只改一层，更容易定位原因。

常见问题#

这是 ChatGPT 网页版的插件吗？#

不是。官方链接描述的是 MCP for Blender 的 Codex 插件，应在支持 Codex 插件的 Codex 客户端中安装。不要在 ChatGPT 网页普通对话的设置里寻找同名按钮。

只安装 Codex Marketplace 插件就能控制 Blender 吗？#

不能。Blender 本身必须安装并运行 MCP for Blender 插件端；本机 MCP 服务还需要正常启动。Codex 插件负责 Codex 一侧的集成体验。

能不能同时在 Codex、Cursor 和 Claude Desktop 里连接同一个 Blender？#

不建议。官方提醒同一个 Blender 会话只应有一个 MCP 服务实例连接，同时从多个客户端启动可能导致冲突。切换客户端时先退出或断开旧服务。

插件会自动保存或覆盖我的 .blend 文件吗？#

不要假定它会按你的预期保存，也不要假定它绝不会触及文件。对另存、覆盖、删除和批量修改明确给出路径与范围，并在执行前建立副本；完成后检查实际文件。

安装后为什么 @ 或素材缩略图没有出现？#

确认安装的是官方 Codex 插件而非仅普通 MCP 配置，客户端已重启，插件已启用，并按官方页面检查当前 Codex 版本和功能。素材服务还可能依赖独立配置。若基础 get_scene_info 和视口工具可用而扩展 UI 不可用，应先排查插件加载与版本，而非 Blender 场景本身。

可以用它做最终商业模型吗？#

可以把它用于草模、重复操作和方案探索，但最终模型的尺寸、拓扑、UV、材质、授权、渲染和交付格式要由专业人员检查。生成结果不是质量或授权保证。

安装完成检查表#

• Blender 已安装，测试文件能正常打开。
• MCP for Blender Blender 插件端已安装并启用，Blender 保持运行。
• 官方 integrations/codex Marketplace 已加入 Codex，MCP for Blender 插件已安装启用。
• Codex 已重启，能读取场景信息并返回视口画面。
• 同一个 Blender 会话只有一个 MCP 服务实例连接。
• 已用副本完成小范围测试，理解 execute_blender_code 的执行权限。
• 导入外部素材前核对服务要求和许可，重要项目保留可恢复版本。

官方资料#

• MCP for Blender Codex 插件说明
• MCP for Blender 快速开始
• MCP for Blender 工作原理与安全模型
• MCP for Blender 安装文档
• MCP for Blender 配置参考
• MCP for Blender GitHub 仓库