连接 Codex 与其他 MCP 客户端

连接信息

官方服务已开放公开测试：

MCP 配置中不需要 API Key。注册账户使用开发者基础限额，并与网页共用积分余额。公开工具清单用于查询工具与 Schema，不要把清单 URL 当成服务器地址。

Claude 自定义连接器

打开 Claude 并预填 AnimGen 连接信息，检查服务器名称和 URL 后选择 Add。新建对话，在连接器菜单中启用 AnimGen，并按提示完成 AnimGen OAuth 授权。

AnimGen 当前按自定义连接器提供，不表示它已经进入 Claude 连接器目录。自定义连接器是否可用，以及组织级管理方式，取决于 Claude 套餐与管理员设置。该入口只会预填公开连接信息，不会自动授权，也不会消费 AnimGen 积分。

连接后先使用下方只读提示验证，再尝试文件传输或生成。Claude 自定义连接器的行为和套餐要求以 Anthropic 官方指南为准。

ChatGPT 开发者模式测试

AnimGen 当前不声称已经进入 ChatGPT Plugin Directory。正式发布前，可先在 ChatGPT 的 Settings → Security and login 中开启 Developer mode，打开 ChatGPT Plugins 页面并新建连接，把 https://api.animgen.com/mcp 填为公开 MCP URL。检查扫描到的工具，完成 OAuth 后，再使用下方只读提示验证。

开发者模式是否可用取决于账户与工作区策略。这是测试连接；公开的 AnimGen 插件仍需单独经过 OpenAI 审核和发布。具体步骤以官方 ChatGPT 插件测试指南为准。

Codex CLI

在可信终端中添加远程服务器并登录：

codex mcp add animgen --url https://api.animgen.com/mcp
codex mcp login animgen

在浏览器授权流程中检查 AnimGen 账户与请求权限，再返回 Codex。如果本地已存在同名服务器，应先检查当前配置，不要直接覆盖。OAuth 登录方式已按 Codex 官方 MCP 文档核对，客户端版本和界面位置可能不同。

不要将 OAuth Token 粘贴进聊天，也不要用通用 Bearer API Key 配置绕过 OAuth 错误。

Gemini CLI

把 AnimGen 加入当前用户的 Gemini CLI 配置：

gemini mcp add --transport http --scope user animgen https://api.animgen.com/mcp

随后打开 Gemini CLI 并完成 OAuth：

/mcp auth animgen

不要手动添加 Authorization Header，也不要开启跳过确认的 trust 配置。Gemini CLI 可对兼容的远程 HTTP 服务器发现 OAuth 元数据并执行动态客户端注册。先用 /mcp 或 gemini mcp list 检查连接，再执行下方只读验证提示。详见 Gemini CLI 官方 MCP 指南。

其他远程 MCP 客户端

在客户端的远程服务器或连接器设置中填写相同 URL。客户端需要支持 Streamable HTTP，以及本服务使用的 OAuth 发现和授权流程。只能启动本地 stdio 服务的客户端不等价。

客户端是否开放相关功能、所需套餐、管理员策略，以及上传下载能力，由对应客户端决定。本指南不声称每种客户端都已实测，也不意味着其他平台的账号自动获得 AnimGen 访问权。

授权失败时，按接入排障检查，不应放宽安全校验或猜测回调配置。

不花积分验证连接

可以对已经连接的客户端说：

调用 AnimGen 的 list_models，不传参数。
告诉我当前支持哪些输入模式和参数。
不要上传文件、启动生成、取消任务或消费积分。

返回结构化模型列表，表示只读连接可用，不代表后续生成已获批准，也不等于每个下游功能都已验证。

接着确认客户端是否有获准的能力传输本地图片字节、保存下载资产。仅在聊天里提到路径，不能让远程 MCP 读取本地文件。完整工作流说明上传准备、字节传输、完成确认、报价、批准、轮询与下载。

管理权限与支出

查看工具 Scope，只授予必要访问，并在账户 → 开发者撤销不再使用的应用。本地删除配置与撤销服务端授权是两件事。

OAuth 授权不等于批准消费。调用 generate_animation 前，应确认具体请求和积分；调用需要 quote_id 或 max_credits，并携带幂等键。详见支出保护。不要把“测试连接”自动变成付费生成。