在 ChatGPT 中添加 AUVRA
打开 ChatGPT,在 Plugins(插件)中点击「+ → Add custom MCP server」,名称填 AUVRA,服务器地址填下方地址,认证选择 OAuth,创建并安装。
官方做好的工作流,拿去直接用,也可以打开看每一步,照着搭自己的。




日常修复会随服务更新生效,无需重装。新增工具可能需要在 AI 客户端刷新工具清单,再开启新对话;工作区可能需要管理员确认。
Claude:设置 → 连接器 → 已有的 AUVRA → 更多选项 → 重新整理工具清单。旧对话仍看不到新工具时,新开一个对话。
ChatGPT 网页版:插件/应用 → 已有的 AUVRA → 刷新(Refresh),然后新开对话。桌面版若在 MCP servers 中连接,请按下面的 Codex 步骤操作。
Codex/桌面 MCP:先新开会话,输入 /mcp 检查 AUVRA。仍缺少工具时,到设置 → MCP servers 刷新/重启已有连接;有任务进行中时,等任务结束再操作。
无需删除连接或重复安装。只有提示未登录、授权失效或需要认证时,才点击认证(Authenticate),由你在浏览器完成授权。
验证连接只读取账号和生成能力,确认能看到 submit_3d_generation,不要用真实生成测试。已有任务继续查询原任务编号,不要因刷新重新提交,以免重复扣费。
这里只检查 AUVRA 服务;是否已刷新,需要你的 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 也可直接填本机图片路径。
一张图生成四视图:submit_multiview_images;按角度改图:edit_multiview_images;拆分后补全:submit_3d_operation 的 complete。四视图结果的 views 可直接用于多视角出模。
线上上传图片也可用 upload_reference 的 url,填写你授权的短时 HTTPS 公网图片直链,不需要把整张图片变成文字。补全和四视图价格待服务商确认,先 dryRun,再确认提交。
生成与后处理可能收费,先 dryRun 查看参数和估价,再由你确认。3D 自动排队;查进度、取回结果继续使用原任务编号,不重复生成。
下载后的模型可交给已连接的 Unity 或 Blender 工具导入。不能读取本机文件的 AI,请在 AUVRA 网页上传参考图。
Claude 桌面仍缺少新工具时:已连接的用户请在 claude.ai 连接器设置里重新连接 AuvrA,再开新对话;不需要重装,只在提示认证失效时授权。
适用于能执行命令的 AI:Codex(含 ChatGPT 桌面 App 里的 Codex)、Claude Code、CodeBuddy。它会执行安装命令,再由你在浏览器登录 AUVRA、确认授权。在 ChatGPT 或 Claude 的网页聊天里粘贴不会自动安装,请看下面对应的分页手动添加。
也可以按你使用的客户端查看详细步骤。安装、账号授权和查看项目是三个步骤,账号授权只能由你本人完成。
适用于能执行终端命令的 Codex:命令行、IDE 插件和 ChatGPT 桌面 App 里的 Codex 共用同一份配置,装一次都能用。复制给普通 ChatGPT 聊天不会自动安装,请使用 ChatGPT 页签。此 Plugin 连接线上 AUVRA。
在安装 Codex 的电脑上打开终端,逐行执行以下命令。授权需要你在浏览器中确认;完成后新建对话,使用下方的项目检查指令。
提示 codex 命令不存在时,请先安装或更新 Codex。只是不支持 plugin 时,可以直接添加服务器再授权:
在 ChatGPT 聊天里粘贴文字不会自动安装,需要你在 ChatGPT 中手动添加一次 AUVRA 并授权。用 ChatGPT 桌面 App 里的 Codex,可以直接用上方的安装指令自动安装。
打开 ChatGPT,在 Plugins(插件)中点击「+ → Add custom MCP server」,名称填 AUVRA,服务器地址填下方地址,认证选择 OAuth,创建并安装。
按提示登录 AUVRA,确认授权后回到 ChatGPT,在新对话中选择 AUVRA。
如果没有添加入口,请检查客户端版本和账号/工作区权限,或联系管理员;不同套餐看到的菜单可能不同。AUVRA 无法替你开启客户端权限。
ChatGPT 会讲解步骤,但不能替你添加,添加和授权仍由你完成。
在 Claude 聊天里粘贴文字不会自动安装。网页和桌面 App 需要在连接器设置中手动添加一次;Claude Code 可以直接用上方的安装指令。
Claude 网页/桌面:打开「自定义 → 连接器 → + → 添加自定义连接器」,名称填 AUVRA、网址填 ChatGPT 页签中的服务器地址();添加后点「连接」并登录 AUVRA。回到对话,点击「+ → 连接器」启用 AUVRA。团队或企业账号需管理员先添加。
Claude 会讲解步骤,但不能替你添加,添加和授权仍由你完成。
Claude Code:把上方的安装指令粘贴给 Claude Code,或者在运行 Claude Code 的机器上执行:
命令添加后,在 Claude Code 输入 /mcp 完成授权并检查状态。云端代码环境还需要允许访问 AUVRA 域名;复制网址到聊天不等于安装连接器。Claude 官方说明 ↗ · Claude Code 官方说明 ↗
可以把上方的安装指令直接粘贴给 CodeBuddy,也可以自己执行下面的命令。下面的 HTTP 添加命令已对照 CodeBuddy 官方文档。运行后用 codebuddy mcp list 检查配置,再在 CodeBuddy 的 /mcp 中查看连接状态;如出现授权入口,按提示登录 AUVRA。
CodeBuddy 与 AUVRA 的 OAuth 授权还没有完成真实联调。只有成功查看 AUVRA 项目列表,才算连接通过。CodeBuddy 官方说明 ↗
将下面的 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 连接;移除连接不一定等于撤销已签发的令牌。
用你自己的显卡出图、做视频。照着四步做就行。
推荐 RTX 5090 / 4090,数据盘 150GB 以上。
以 AutoDL 为例:注册并充值后,进「算力市场」,选一台 RTX 5090 或 4090 的机器,点「租用」。
计费方式选按量计费;镜像选基础镜像 → PyTorch;数据盘点「扩容」到 150GB 以上,然后创建并开机。
RTX 3080 / 3090 也能用,做视频时选「Pika 6 步」。按小时收费,不用时记得关机。
实例列表 → JupyterLab → Terminal。
开机后,在实例列表点「JupyterLab」,打开的网页里点「Terminal(终端)」图标,会出现一个黑色窗口,可以在里面输入命令。不用改任何设置。
复制命令 → 粘贴到云端 GPU 网页里的终端 → 回车,等到显示「安装完成」。
点下面的「复制安装命令」,回到云端 GPU 网页里的黑色终端窗口,点一下窗口,按 Ctrl+V(Mac 按 Cmd+V)粘贴,再按回车。它会自动安装 ComfyUI、H3、Pika 和 AUVRA 安全桥,第一次大约 20–40 分钟,期间不要关掉网页。看到「安装完成」就好了。
实例列表点「自定义服务」→ 复制 6006 的 https 地址 → 粘贴到下面。
回到实例列表,点「自定义服务」。第一次用,AutoDL 会要求先完成实名认证并同意协议,按提示做完再回来。
找到端口 6006,复制以 https:// 开头的地址,粘贴到下面的框里,点「连接并检查」。看到绿色的「已连接」就成功了。
回到画布:视频节点选「ComfyUI」,图片节点选「ComfyUI → Qwen 2.1」。第一次用会提示一键下载模型,点一下等它下完就能用。
你的 GPU 已经连过了。复制这条命令到 GPU 终端运行一次,就能用上 Pika 6 步和 Qwen 2.1,不会打断正在跑的任务。
先确认需要一台有 NVIDIA 显卡(显存 12GB 以上)的电脑。Mac 或没有独立显卡,请用「云端 GPU」。
到 comfy.org 下载 ComfyUI Desktop 并打开。
到 comfy.org 下载 ComfyUI Desktop,安装后打开。已经装过的,先在 ComfyUI 里更新到最新版。
下载并解压,把 auvra_bridge 文件夹放进 ComfyUI 的 custom_nodes 文件夹,重启 ComfyUI。
① 点下面的按钮下载压缩包,双击解压,得到 auvra_bridge 文件夹。
② 打开 ComfyUI 的安装文件夹,找到里面的 custom_nodes 文件夹。
③ 把整个 auvra_bridge 文件夹拖进去。
④ 关掉 ComfyUI,再重新打开。
以前装过的,用新的 auvra_bridge 文件夹换掉旧的就行。
点画布左侧工具栏的「本地算力」按钮,再点「自动连接」。
打开任意项目画布,在左侧工具栏找到「本地算力」图标。点「自动连接」;浏览器询问「访问本地网络」时,请允许。
连上后检查模型,缺少时点「一键下载模型」。
先确认显卡和空间满足要求,再下载到这台电脑。已有文件会先校验,不会重复下载。准备好后,图片节点选 ComfyUI、Qwen 2.1 和「这台电脑」。
BETA这台电脑目前只能出图(Qwen 2.1);要做视频,请用「云端 GPU」。
填以 https:// 开头的地址,例如 https://abc.example.com:8443,后面不要再加别的内容。填好点「连接并检查」,看到绿色的「已连接」就对了。
这是 AutoDL 的要求:按页面提示完成认证,再回来复制 6006 的地址。认证没通过之前,AUVRA 连不上你的 GPU。
不用重装。开机后在 GPU 终端再粘贴一次「安装命令」:已下载的模型会自动跳过,一两分钟就会把 ComfyUI 重新启动起来。同一台实例的 6006 地址一般不变,AUVRA 里不用重新填写。
多半是 GPU 上的组件还是旧版。复制上面的「更新命令」在 GPU 终端执行一次,再回来点生成。
能。素材和成片在 AUVRA 与你的 GPU 之间经云端中转,和你电脑开不开 VPN 无关。
GPU 按算力平台的价格计时收费。不用的时候记得在算力平台关机。
安装命令运行前会先确认是 AUVRA 的官方文件;装好的组件只接收 AUVRA 发来的任务,不会读取你的密钥、密码或电脑里的其他文件。