在 ChatGPT 中添加 AUVRA
打开 ChatGPT，在 Plugins（插件）中点击「＋ → Add custom MCP server」，名称填 AUVRA，服务器地址填下方地址，认证选择 OAuth，创建并安装。
快速开始
START CREATING最近项目
RECENT WORKSPACES风格预设
THE AUVRA LOOKBOOK全部项目
AUVRA PLUGIN · 内测
让你的 Agent 开始影像创作
连接 AUVRA
已经连接？检查更新
日常修复会随服务更新生效，无需重装。新增工具可能需要在 AI 客户端刷新工具清单，再开启新对话；工作区可能需要管理员确认。
Claude：设置 → 连接器 → 已有的 AUVRA → 更多选项 → 重新整理工具清单。旧对话仍看不到新工具时，新开一个对话。
ChatGPT 网页版：插件／应用 → 已有的 AUVRA → 刷新（Refresh），然后新开对话。桌面版若在 MCP servers 中连接，请按下面的 Codex 步骤操作。
Codex／桌面 MCP：先新开会话，输入 /mcp 检查 AUVRA。仍缺少工具时，到设置 → MCP servers 刷新／重启已有连接；有任务进行中时，等任务结束再操作。
无需删除连接或重复安装。只有提示未登录、授权失效或需要认证时，才点击认证（Authenticate），由你在浏览器完成授权。
验证连接只读取账号和生成能力，确认能看到 submit_3d_generation，不要用真实生成测试。已有任务继续查询原任务编号，不要因刷新重新提交，以免重复扣费。
这里只检查 AUVRA 服务；是否已刷新，需要你的 AI 读取后确认。
查看刷新指令
让 AI 完成游戏资产制作
Claude、Codex、ChatGPT 共用同一套工具。告诉它你要做什么道具或植物，它可以查询能力、上传参考图、出概念图、图生 3D、查看模型并减面导出。
上传参考图：upload_reference；图生 3D：submit_3d_generation；查看面数、贴图、包围盒和预览：get_generation；减面、底部中心轴心、缩放和 FBX 导出：submit_3d_operation。
模型分件：submit_3d_segment，分件后用 submit_3d_operation 的 part_names 逐件减面；按概念图给已有模型重画贴图：submit_3d_texture。两者可用已完成的 3D 结果，本机版也可直接用本机模型路径（modelPath）。
同一物体有正面、左侧、背面、右侧多角度图时，submit_3d_generation 用 mode=multiview 和 views 多视角出模（front 必填，至少两张），窗户等结构更清楚；本机版 views 也可直接填本机图片路径。
生成与后处理可能收费，先 dryRun 查看参数和估价，再由你确认。3D 自动排队；查进度、取回结果继续使用原任务编号，不重复生成。
下载后的模型可交给已连接的 Unity 或 Blender 工具导入。不能读取本机文件的 AI，请在 AUVRA 网页上传参考图。
Claude 桌面仍缺少新工具时：已连接的用户请在 claude.ai 连接器设置里重新连接 AuvrA，再开新对话；不需要重装，只在提示认证失效时授权。
复制给你的 AI，让它帮你安装
适用于能执行命令的 AI：Codex（含 ChatGPT 桌面 App 里的 Codex）、Claude Code、CodeBuddy。它会执行安装命令，再由你在浏览器登录 AUVRA、确认授权。在 ChatGPT 或 Claude 的网页聊天里粘贴不会自动安装，请看下面对应的分页手动添加。
也可以按你使用的客户端查看详细步骤。安装、账号授权和查看项目是三个步骤，账号授权只能由你本人完成。
安装 AUVRA Plugin
适用于能执行终端命令的 Codex：命令行、IDE 插件和 ChatGPT 桌面 App 里的 Codex 共用同一份配置，装一次都能用。复制给普通 ChatGPT 聊天不会自动安装，请使用 ChatGPT 页签。此 Plugin 连接线上 AUVRA。
无法自动安装？手动安装与授权
在安装 Codex 的电脑上打开终端，逐行执行以下命令。授权需要你在浏览器中确认；完成后新建对话，使用下方的项目检查指令。
提示 codex 命令不存在时，请先安装或更新 Codex。只是不支持 plugin 时，可以直接添加服务器再授权：
连接 ChatGPT
在 ChatGPT 聊天里粘贴文字不会自动安装，需要你在 ChatGPT 中手动添加一次 AUVRA 并授权。用 ChatGPT 桌面 App 里的 Codex，可以直接用上方的安装指令自动安装。
登录 AUVRA 并确认
按提示登录 AUVRA，确认授权后回到 ChatGPT，在新对话中选择 AUVRA。
如果没有添加入口，请检查客户端版本和账号／工作区权限，或联系管理员；不同套餐看到的菜单可能不同。AUVRA 无法替你开启客户端权限。
需要帮助？复制给 ChatGPT，让它一步步指导你
ChatGPT 会讲解步骤，但不能替你添加，添加和授权仍由你完成。
连接 Claude
在 Claude 聊天里粘贴文字不会自动安装。网页和桌面 App 需要在连接器设置中手动添加一次；Claude Code 可以直接用上方的安装指令。
Claude 网页／桌面：打开「自定义 → 连接器 → ＋ → 添加自定义连接器」，名称填 AUVRA、网址填 ChatGPT 页签中的服务器地址（）；添加后点「连接」并登录 AUVRA。回到对话，点击「＋ → 连接器」启用 AUVRA。团队或企业账号需管理员先添加。
需要帮助？复制给 Claude，让它一步步指导你
Claude 会讲解步骤，但不能替你添加，添加和授权仍由你完成。
Claude Code：把上方的安装指令粘贴给 Claude Code，或者在运行 Claude Code 的机器上执行：
命令添加后，在 Claude Code 输入 /mcp 完成授权并检查状态。云端代码环境还需要允许访问 AUVRA 域名；复制网址到聊天不等于安装连接器。Claude 官方说明 ↗ · Claude Code 官方说明 ↗
连接 CodeBuddy Code
可以把上方的安装指令直接粘贴给 CodeBuddy，也可以自己执行下面的命令。下面的 HTTP 添加命令已对照 CodeBuddy 官方文档。运行后用 codebuddy mcp list 检查配置，再在 CodeBuddy 的 /mcp 中查看连接状态；如出现授权入口，按提示登录 AUVRA。
CodeBuddy 与 AUVRA 的 OAuth 授权还没有完成真实联调。只有成功查看 AUVRA 项目列表，才算连接通过。CodeBuddy 官方说明 ↗
连接 Hermes Agent
将下面的 AUVRA 项合并到 ~/.hermes/config.yaml 的 mcp_servers 下，保留已有配置。cimd: false 让 Hermes 使用 AUVRA 支持的动态客户端注册，别删掉这一项。
授权后运行 hermes mcp test auvra 检查连接，再让它只查看项目列表。Hermes 与 AUVRA 的完整授权流程仍需真实联调。Hermes 官方配置说明 ↗
当前复制的是本地版地址，仅供能访问这台电脑的客户端测试。云端 Agent 不能访问你的 127.0.0.1；正式使用请从线上 AUVRA 页面复制地址。
只有实际读取项目成功才算连接完成，空列表也算成功。如果当前对话没有 AUVRA 工具，请先完成授权，再新建对话并启用 AUVRA。
浏览器直接打开 MCP 地址看到“仅支持 POST”是正常的。授权回调网址和令牌不要复制到聊天中。
从对话开始
查看项目、确认素材，再安排创作。
生成图片与视频
使用账号已配置的生成服务提交任务。
回到画布继续
查看生成结果，继续调整与组织镜头。
接入前，你可能想知道
这是需要安装的插件吗？
能执行命令的 AI（Codex、Claude Code、CodeBuddy）可以用页面上方的安装指令自动安装。ChatGPT 和 Claude 的网页、手机 App 需要你在设置里手动添加一次。其他支持远程 HTTP MCP 和 OAuth 的客户端可以手动添加服务器地址。
生成会产生费用吗？
图片与视频生成按所用服务的计费规则执行，Agent 自身也可能消耗额度。请在提交前明确模型、数量与预算。
结果在哪里查看？
打开对应项目的画布。若画布已满或自动放入失败，检查生成记录，并让 Agent 返回任务状态和结果位置。
连接失败或想取消授权怎么办？
先确认地址可访问、客户端支持远程 HTTP MCP 和 OAuth。若报“无法获取客户端元数据文档”，请联系 AUVRA 处理；反复添加连接器通常无效。取消使用时，在客户端移除 AUVRA 连接；移除连接不一定等于撤销已签发的令牌。
接入你自己的 GPU
用你租的云 GPU 跑 MiniMax H3。照着做四步就能连上；素材和成片经云端中转，保留原画质。
你的浏览器发起生成
指令
AUVRA排队与校验
原文件
云端中转SHA256 校验
素材和成片
你的 GPUComfyUI · H3
还没有连接 GPU按下面四步完成连接。
- 01
租一台 GPU
在 AutoDL 等算力平台租一台 Linux 机器。推荐 RTX 5090 · 32GB 显存，数据盘 120GB 以上，镜像选带 PyTorch / CUDA 的。
- 02
打开网页终端
在实例详情页点「终端」，或在 JupyterLab 里新建 Terminal。不用改任何系统设置。
- 03
粘贴安装命令，按回车
大约 10–20 分钟。命令会先校验脚本，再自动安装并启动 ComfyUI 和 H3。
安装命令运行前自动校验 SHA256查看命令内容
- 04
开放 6006，粘贴地址
在实例的「自定义服务」里开放 HTTP 6006，复制公网 HTTPS 根地址，粘贴到这里。
ALREADY CONNECTED
连过？更新一下 GPU 组件
新版组件让素材和成片走云端中转，不再卡在「上传图片」。在 GPU 终端粘贴这条命令：空闲时会自动重启 ComfyUI；有任务在跑就不会打断，等跑完再执行一次。
更新命令空闲时自动重启，不打断任务
查看命令内容
- 01
安装 ComfyUI Desktop
在你自己的电脑上安装并打开 ComfyUI Desktop（需要 NVIDIA 显卡）。
- 02
- 03
在画布点「本地算力」
打开任意项目画布，点顶部的「本地算力 BETA」，网站会自动找到这台电脑上的 ComfyUI。
BETA本机连接目前完成安全直连检查；用本机显卡接管画布生成即将开放。现在要正式出片，请用「云端 GPU」。
常见问题
地址怎么填？
只填 HTTPS 根地址，例如 https://abc.example.com:8443。不要带 /system_stats，也不要填 127.0.0.1 或 SSH 地址。可以先在浏览器打开「地址/system_stats」，看到 comfyui_version 就说明地址对了。
GPU 关机后再开机，要重新装吗？
不用重装。开机后在 GPU 终端再粘贴一次「安装命令」：已下载的模型会自动跳过，一两分钟就会把 ComfyUI 重新启动起来。同一台实例的 6006 地址一般不变，AUVRA 里不用重新填写。
生成一直卡在「上传图片」？
多半是 GPU 上的组件还是旧版。复制上面的「更新命令」在 GPU 终端执行一次，再回来点生成。
开着 VPN 能用吗？
能。素材和成片在 AUVRA 与你的 GPU 之间经云端中转，和你电脑开不开 VPN 无关。
要花多少钱？
GPU 按算力平台的价格计时收费，AUVRA 不额外收取生成费用。不用的时候记得在算力平台关机。
安全吗？
安装命令会先核对脚本的 SHA256 再运行；组件只接受 AUVRA 签名的短时链接，不读取你的密钥、SSH 密码或其他文件。