MCP 与 AI 智能体

与 AI 智能体配合使用#

如果你想让助手帮你生成媒体，例如在 Claude Code 或 Cursor 聊天中使用，请使用 MCP 服务器。如果智能体要编写调用 API 的代码，请使用 Agent Skill。两者可以同时使用：连接 MCP 后，Skill 也会提示智能体优先使用 MCP 工具。

服务器 URL 与登录#

• 传输方式：采用 Streamable HTTP，无状态。支持使用 2025 版和 2026-07-28 版 MCP 协议的客户端。
• 登录方式：采用符合 MCP 授权规范的 OAuth 2.1。客户端首次连接时会在浏览器中打开 CheaperGen 页面。登录并批准应用即可。已批准的应用列在 控制面板 → API 密钥 → 已连接的应用 下，你可以随时断开连接。
• 无头环境与 CI：改为传入 API 密钥，方式如下：Authorization: Bearer cg_live_…。参见 使用 API 密钥。

连接客户端#

Claude（claude.ai 和 Claude Desktop）#

1. 打开 自定义 → 连接器 并添加自定义连接器。
2. 将连接器命名为 CheaperGen，粘贴上方 URL，然后选择 添加。
3. 选择 连接，登录到 CheaperGen 并批准。之后，在聊天的工具菜单中启用连接器。

Team 和 Enterprise 套餐可能需要由组织所有者先为整个组织添加连接器。在 claude.ai 添加的连接器也会显示在 Claude Desktop 中。

Claude Code#

claude mcp add --transport http cheapergen https://cheapergen.com/api/mcp

然后运行 /mcp，选择 cheapergen，再选择 Authenticate（或者在终端中运行 claude mcp login cheapergen）。浏览器会打开登录页面，请登录并批准连接。添加 --scope user 即可在所有项目中使用。也可以安装插件，一步添加服务器和 Agent Skill：

/plugin marketplace add CheaperGen/skills
/plugin install cheapergen@cheapergen

ChatGPT#

桌面应用（macOS 和 Windows）。在 Work 或 Codex 模式下，ChatGPT 桌面应用会使用与 Codex CLI 相同的 MCP 设置，因此 codex mcp add 也会连接。你也可以直接在应用中添加：

1. 打开 Settings → MCP servers → Add server。
2. 将连接器命名为 cheapergen，选择 Streamable HTTP，粘贴上方的 URL 并保存。
3. 选择 重启，然后选择 Authenticate，登录到 CheaperGen 并批准。要检查连接，请在输入框中输入 /mcp。

chatgpt.com。自定义 MCP 服务器会成为插件，可在 ChatGPT Business、Enterprise 和 Edu 工作区中使用（Business 工作区需要管理员或所有者添加）。请通过网页版添加，不要使用移动应用：

1. 打开 Plugins → + → Add custom MCP server。
2. 将其命名为 CheaperGen，粘贴上方的 URL，并选择 OAuth 作为身份验证方式。
3. 勾选 我了解并希望继续，选择 创建为插件，然后安装、登录并批准。
4. 在聊天中输入 @ 并选择插件。ChatGPT 会在运行 generate 或 add_credits 前征求你的同意。

Codex#

codex mcp add cheapergen --url https://cheapergen.com/api/mcp

此操作会将服务器添加到 ~/.codex/config.toml 并立即在浏览器中打开登录页面。如果跳过了登录，请运行 codex mcp login cheapergen。Codex CLI、Codex IDE 扩展（齿轮菜单 → MCP 服务器）和 ChatGPT 桌面应用都会读取此文件，因此设置一次即可供它们共用。Codex 云端任务不会读取此文件。要手动编辑该文件：

[mcp_servers.cheapergen]
url = "https://cheapergen.com/api/mcp"

Cursor#

将以下配置添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（仅适用于一个项目）。然后打开 自定义 → MCP 并连接 cheapergen。在 Cursor CLI 中运行 cursor-agent mcp enable cheapergen，再运行 cursor-agent mcp login cheapergen。

{
  "mcpServers": {
    "cheapergen": {
      "url": "https://cheapergen.com/api/mcp"
    }
  }
}

VS Code（GitHub Copilot）#

将以下配置添加到 .vscode/mcp.json，或运行 MCP: 添加服务器… 并选择 HTTP。VS Code 会在服务器首次启动时要求你登录。之后即可在 Copilot Chat 的智能体模式中使用这些工具。

{
  "servers": {
    "cheapergen": {
      "type": "http",
      "url": "https://cheapergen.com/api/mcp"
    }
  }
}

其他客户端#

支持远程服务器和 OAuth 的客户端只需要 URL（有些客户端使用 "serverUrl" 而非 "url"）。仅支持本地 stdio 服务器的客户端可以通过 mcp-remote 桥接连接；该桥接需要 Node.js，并会处理登录流程。

{
  "mcpServers": {
    "cheapergen": {
      "type": "http",
      "url": "https://cheapergen.com/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "cheapergen": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cheapergen.com/api/mcp"
      ]
    }
  }
}

使用 API 密钥（无头环境、CI）#

无法通过浏览器登录时，请从 控制面板 → API 密钥 传入 API 密钥。为每个智能体单独创建密钥，以便分别撤销。请将密钥存入环境变量，如下所示：单引号中存放的是变量名，而不是密钥；客户端连接时会读取变量的值。Claude Code 还会从各开发者环境中展开 ${CHEAPERGEN_API_KEY}，并写入已提交的 .mcp.json。

claude mcp add --transport http cheapergen https://cheapergen.com/api/mcp \
  --header 'Authorization: Bearer ${CHEAPERGEN_API_KEY}'

codex mcp add cheapergen --url https://cheapergen.com/api/mcp \
  --bearer-token-env-var CHEAPERGEN_API_KEY

gemini mcp add --transport http cheapergen https://cheapergen.com/api/mcp \
  -H 'Authorization: Bearer ${CHEAPERGEN_API_KEY}'

{
  "mcpServers": {
    "cheapergen": {
      "type": "http",
      "url": "https://cheapergen.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${CHEAPERGEN_API_KEY}"
      }
    }
  }
}

npx @modelcontextprotocol/inspector --cli https://cheapergen.com/api/mcp --transport http \
  --header "Authorization: Bearer $CHEAPERGEN_API_KEY" --method tools/list

工具#

每种工具都会调用与 REST API 相同的代码（API 参考文档），因此价格、验证和错误完全一致。结果以精简 JSON 返回。生成完成的图片还会附带一张小尺寸内嵌预览，对话中可直接看到，智能体也能据此检查效果；每个输出文件都会作为资源链接返回，可展示或下载。

图像通常一次 generate 调用即可完成。视频需要几分钟，因此智能体先提交任务，再以 wait_seconds 调用 get_generation，直到任务完成。已完成的 generate 会返回：

{
  "id": "gen_8c2QmX1nq0k4Lw7Z",
  "status": "succeeded",
  "endpoint": "bytedance/seedream-5.0-lite/text-to-image",
  "outputs": [
    "https://cdn.cheapergen.com/outputs/gen_8c2QmX1nq0k4Lw7Z.png"
  ],
  "cost": {
    "amount_usd": 0.0303,
    "official_usd": 0.035,
    "list_price_source": "official",
    "list_price_label": "官方价格",
    "saved_usd": 0.0047,
    "final": true
  },
  "created_at": "2026-10-16T09:12:43.545Z",
  "completed_at": "2026-10-16T09:12:49.058Z",
  "outputs_expire_at": "2026-10-17T09:12:49.058Z",
  "next": "任务完成。请在 outputs_expire_at 之前显示或下载输出 URL。"
}

提示词示例#

• “CheaperGen 哪些视频模型支持参考视频？使用每种模型制作 5 秒、720p 视频分别需要多少钱？”
• “使用 Seedance 2.0 Fast 制作一段 5 秒、720p 的视频：一只纸船沿着雨中的霓虹街道漂流，镜头缓慢推近。先告诉我价格。”
• “使用 Seedream 5.0 Lite 为这个马克杯制作四张产品图，每张低于 $0.05：https://example.com/mug.png”
• “用 Wan 3.0 将这张照片制作成一段 6 秒竖屏视频：https://example.com/portrait.jpg”
• “用 Kling 3.0 把我桌面上的照片（~/Desktop/beach.jpg）做成一段 5 秒视频，先告诉我价格。”
• “使用 Seedance 2.0 将参考素材转换为视频：@Image1 是角色，@Image2 是街道；镜头运动参考 @Video1。素材 URL：…”
• “我的 CheaperGen 余额是多少？够生成多少段 10 秒、1080p 的 Seedance 2.0 视频？”

Agent Skill#

CheaperGen 技能是一个 SKILL.md 文件，采用 Agent Skills 格式。它会教会智能体完整工作流程：选择模型、读取输入结构、查询报价、提交任务、轮询状态或验证 Webhook、引用素材、上传文件，并处理价格和错误。智能体只会在任务需要时加载它。调用 REST API 时，它会从 CHEAPERGEN_API_KEY 读取你的密钥；连接 MCP 后则优先使用 MCP 工具。源代码位于 github.com/CheaperGen/skills。

/plugin marketplace add CheaperGen/skills
/plugin install cheapergen@cheapergen

npx skills add CheaperGen/skills

mkdir -p ~/.claude/skills/cheapergen
curl -fsSL https://cheapergen.com/skills/cheapergen/SKILL.md -o ~/.claude/skills/cheapergen/SKILL.md

mkdir -p .claude/skills/cheapergen
curl -fsSL https://cheapergen.com/skills/cheapergen/SKILL.md -o .claude/skills/cheapergen/SKILL.md

skills CLI 可将其安装到 Claude Code、Cursor、Codex、Gemini CLI 和其他智能体中（-a 可选择单个智能体，-g 可安装到所有项目）。在 Claude 应用中，可将 cheapergen 文件夹压缩成 zip 并上传为自定义 Skill。

限制与计费#

• 每个已连接应用或 API 密钥均采用与 REST API 相同的 速率限制（每次 MCP 请求都会计入），且每个账户的进行中生成任务也有数量限制。
• generate 提交生成任务时会冻结相应金额；如果生成失败或取消，会全额退款。参见 计费与余额。
• 通过 MCP 生成的任务会显示在控制面板和 GET /api/v1/generations 中，并标记为 source: "mcp"。
• 登录令牌有效期为一小时，客户端会自动刷新。你可以在控制面板中断开应用，访问权限会立即失效。
• 输出 URL 为公开链接，并会在 API 数据保留期限结束时失效（默认 1 天）。请下载并保存需要保留的内容。

问题排查#

• 请客户端提示服务器需要身份验证：完成客户端已开始的登录流程（在 Claude Code 中：/mcp → cheapergen → Authenticate）。如果你已断开应用，或 90 天内没有使用过，请重新登录。
• 请登录页面提示应用未注册，或重定向地址不匹配：从客户端移除服务器后重新添加，让客户端重新注册。
• 工具调用超时： 请缩短 wait_seconds 的值。生成任务会继续运行，之后可使用 get_generation 获取。
• invalid_request: 输入与端点的结构不匹配。错误信息会在 param 中指出出错字段；请让智能体先调用 get_model。