Show3D MCP · 图文教程
连接 Codex 与 Show3D
按照下面的步骤安装 Show3D 插件、完成账号授权，并让 Codex 连接你当前打开的建模场景。无需安装 Codex CLI。
开始前准备
开始前确认以下三项即可，不需要手动配置 MCP 地址。
- 已打开并登录 Codex 桌面客户端
- 已在浏览器中登录 Show3D
- 已经新建或打开一个 Show3D 建模场景
运行一键安装命令
保持 Codex 桌面客户端打开，选择你的系统，在终端中粘贴下面的一键安装命令并执行。
打开“终端”，粘贴命令并按回车。
curl -fsSL https://www.show3d.com/codex/show3d/install.sh | sh终端出现“marketplace has been registered with Codex”即表示命令执行成功。接下来回到 Codex，在自动打开的 Show3D 插件页点击 Install。
在 Codex 插件页点击 Install
命令执行完成后，如果 Codex 已打开，会直接显示 Show3D 插件详情页。点击 Install（安装），然后按提示继续授权。
等待添加截图
执行命令后 Codex 自动显示的 Show3D 插件详情页，清楚展示 Install 按钮。
文件位置: public/images/mcp-guide/03-codex-show3d-plugin-v2.png
授权 Show3D 账号
点击 Install 后，按 Codex 的连接提示前往浏览器，完成 Show3D 账号授权。
- 1浏览器打开 Show3D 授权页；如果尚未登录，请先登录。
- 2确认当前 Show3D 账号，然后点击“允许连接”。
- 3看到 Authentication complete 后返回 Codex，确认授权成功。
等待添加截图
Show3D 授权页面和“允许连接”按钮；请遮挡账号及地址栏参数。
文件位置: public/images/mcp-guide/04-show3d-oauth-consent-v2.png
看到 127.0.0.1 不代表出错
这是 Codex 临时创建的本机 OAuth 回调地址。显示 Authentication complete 后即可关闭该标签页，请不要分享地址栏中的 code。
让当前场景进入连接状态
完成账号授权后，Codex 仍然只能连接你主动打开的场景页面。
- 1在 Show3D 中打开准备建模的场景。
- 2点击左侧 Agent MCP 图标。
- 3确认场景控制开关已开启，状态显示绿色“已连接”。
- 4Codex 建模期间保持这个页面打开。
等待添加截图
建模页面左侧的 Agent MCP 图标和绿色连接状态点。
文件位置: public/images/mcp-guide/05-show3d-agent-connected-v2.png
关闭页面、退出账号或切换场景都会让旧连接失效。这是场景级权限设计，不会影响你的 Show3D 账号授权。
在 Codex 中测试连接
先执行一次只读测试。确认 Codex 能看到场景后，再开始建模。
发送给 Codex
列出我当前打开的 Show3D 场景，并连接唯一场景。先不要修改场景。等待添加截图
Codex 列出当前 Show3D 场景后，按对话提示选择要连接的场景。
文件位置: public/images/mcp-guide/06-codex-scene-test-v2.png
出现以下结果即表示连接完成
- Codex 返回当前 Show3D 场景的名称或 ID
- Show3D 页面仍显示 Agent MCP 已连接
- 只读测试没有修改场景内容
常见问题
命令执行完成后没有打开插件页面+
先打开 Codex，再执行一次同一条命令。如果仍未跳转，进入 Codex 的“插件”，找到 Show3D 后点击 Install（安装）。
授权页面一直等待或要求登录+
先在同一个浏览器中登录 Show3D，再回到 Codex 重新点击连接。不要继续使用已经过期的旧授权页面。
授权成功，但 Codex 看不到场景+
确认 Show3D 建模页面仍然打开、登录的是授权时的同一个账号，并检查 Agent MCP 开关和连接状态。
刷新页面后为什么需要重新选择场景+
刷新会创建新的编辑器会话。回到 Codex 再次列出并选择当前场景即可，不需要重新授权账号。
以后如何更新 Show3D 插件+
重新执行“运行一键安装命令”中对应系统的命令，然后完全退出并重新打开 Codex。
安装完成
保持 Show3D 场景页面打开，现在可以回到 Codex 开始建模。
打开 Show3D 建模