把 AgentReel 接入你的 AI 工具（MCP）
AgentReel 在 https://agentreel.co/api/mcp 提供远程 MCP（Model Context Protocol）服务器。把这个地址添加到 Claude Code、Claude、ChatGPT、Codex 或 Cursor，用你的 AgentReel 账号登录，你的 AI 应用就能替你生成图片、AI 视频、模板视频、视频广告和 B-roll 剪辑。它使用的工具、模型和积分都与网站一致。本指南介绍每个应用的接入步骤、应用能用的工具、积分和限制的规则，以及如何断开应用。MCP 服务器页面有简要介绍。
免费吗？连接免费，也无需粘贴任何 API 密钥。首次购买之前，已连接的应用只能把积分用于 Z-Image 图片、视频模板和 Code to Video。其他工具都需要先购买。免费 B-roll 试用和免费 AI 视频只能在网站上使用。
快速解答
AgentReel MCP 服务器是什么？
它是一个支持 MCP 的远程服务器。MCP 是 AI 应用调用其他服务工具的开放标准。你的 AI 应用通过网络连接它，就能使用 AgentReel 的十二个创作工具，以及六个处理文件、任务、余额和本帮助中心的辅助工具。
哪些应用可以连接？
所有支持基于 Streamable HTTP、使用 OAuth 登录的远程 MCP 服务器的应用都可以。本指南介绍 Claude Code、Claude（claude.ai 和 Claude Desktop）、ChatGPT、Codex 和 Cursor。
需要 API 密钥吗？
不需要。应用会在浏览器里打开 AgentReel，你登录后选择允许或拒绝。每次有应用连接时 AgentReel 都会询问你，应用也看不到你的密码。
收费吗？
连接本身不花积分。每个工具花费的积分与它在网站上的页面相同，从同一个余额扣除，失败的任务会退回积分。详情见下文的积分与限制一节。
文件保存在哪里？
每个已连接的应用都有自己的工作区：AI 视频智能体里一个以应用命名的对话。应用导入的每个文件和每个完成的结果都保存在那里。
怎样断开一个应用？
打开已连接的应用，点击应用旁边的断开连接。应用会立即失去访问权限。
开始之前
- 注册账号。 用 Google、GitHub 或邮箱验证码登录。游客会话无法连接应用，请先注册再连接。
- 服务器地址。 所有应用都使用同一个网址：
https://agentreel.co/api/mcp。 - 同一台电脑上的浏览器。 应用第一次调用 AgentReel 时，浏览器会打开 AgentReel 的登录和授权页面。点击允许后，浏览器会带你回到应用。
Claude Code
- 在终端运行
claude mcp add --transport http agentreel https://agentreel.co/api/mcp。如果想在所有项目里使用，而不只是当前项目，在名称前加上--scope user。 - 启动 Claude Code，输入
/mcp，选择 agentreel 并选择登录认证。 - 浏览器会打开 AgentReel。登录，核对应用名称，然后点击允许。
- 回到 Claude Code，说出你的需求，例如「用 AgentReel 把这三张照片做成一个 9:16 的产品视频」。
Claude Code 会保存登录状态并自动续期。再次运行 /mcp 可以查看状态或重新登录。
Claude 与 Claude Desktop
在 claude.ai 添加的连接器同样适用于 Claude Desktop 和 Claude 手机应用，因为它们共用你的 Claude 账号。
- 在 claude.ai 或 Claude Desktop 中打开 Customize，再打开 Connectors。
- 点击 Add custom connector，填写名称（例如 AgentReel），把
https://agentreel.co/api/mcp粘贴为网址，然后点击 Add。 - 点击新连接器旁边的 Connect。在弹出的窗口里登录 AgentReel，然后点击允许。
- 在对话中，从输入框的工具菜单里打开 AgentReel 连接器，再提出你想要的图片或视频。
Claude 免费套餐可以添加一个自定义连接器。Team 和 Enterprise 套餐需要由 Owner 在 Organization settings 的 Connectors 中添加，然后每位成员连接自己的 AgentReel 账号。
ChatGPT
ChatGPT 可以连接使用 OAuth 登录的远程 MCP 服务器。在哪里添加、能否添加，取决于你的 ChatGPT 套餐；在企业工作区中，还取决于管理员的设置。
- 在 chatgpt.com 打开插件页面（
chatgpt.com/plugins），点击 +，再点击 Add custom MCP server。在 ChatGPT 桌面应用中，同样的选项位于 Settings 的 MCP servers。 - 命名为 AgentReel，把
https://agentreel.co/api/mcp粘贴为服务器网址，认证方式选择 OAuth。 - ChatGPT 会打开 AgentReel。登录并点击允许，AgentReel 随后会带你回到 ChatGPT。
- 在对话中，从工具菜单里打开 AgentReel，然后提出你的需求。
如果看不到这个选项，说明你的套餐或工作区暂时不支持自定义 MCP 服务器。本指南中的其他应用用同一个账号、以同样的方式接入。
Codex
- 在终端运行
codex mcp add agentreel --url https://agentreel.co/api/mcp。 - 运行
codex mcp login agentreel。浏览器会打开 AgentReel：登录并点击允许。在没有浏览器的电脑上，加上--no-browser，再在另一台设备上打开输出的链接。 - 运行
codex mcp list，确认 agentreel 显示为已登录。 - 在 Codex 中提出图片或视频需求，Codex 会调用 AgentReel 的工具。
Cursor
- 打开
~/.cursor/mcp.json（不存在就新建），添加服务器：{ "mcpServers": { "agentreel": { "url": "https://agentreel.co/api/mcp" } } }。如果文件里已经有其他服务器，只需在mcpServers中加入agentreel这一项。 - 打开 Cursor 设置，在 MCP 部分找到 agentreel 并启用。
- Cursor 显示登录按钮时点击它。在浏览器里登录 AgentReel，然后点击允许。
- 在 Cursor 的对话中向智能体提出需求，例如为你的应用做一段简短的演示视频。
如果只想在某个项目里使用 AgentReel，把同样的文件放在该项目的 .cursor/mcp.json。
工具
服务器为应用提供 18 个工具。前十二个负责创作并启动任务；后六个是辅助工具，不花积分。
| 工具 | 作用 | 首次购买之前 |
|---|---|---|
generate_image | 根据提示词和可选的参考图片生成图片，可用 AI 图片生成器的任一模型 | 仅限 Z-Image |
generate_video | 根据提示词或首帧图片生成视频片段，可用 AI 视频生成器的任一模型 | 需要购买 |
template_video | 按字段渲染一个 AI 视频模板 | 可以，使用免费积分 |
code_video | 用代码写成的原创动态图形视频，与 Code to Video 相同 | 可以，使用免费积分 |
html_render | 把你已写好的 HTML 动画渲染成 MP4 | 需要购买 |
translate_video | 输出另一种语言的字幕或配音，与视频翻译相同 | 需要购买 |
avatar_video | 让人像照片说出你的脚本，与 AI 数字人视频相同 | 需要购买 |
clone_voice | 用一段简短录音克隆你自己的声音 | 需要购买 |
video_ad | 根据产品简介生成完整的视频广告，与 AI 视频广告生成器相同 | 需要购买 |
talking_head_cut | 剪掉口播录像里的停顿和废镜头，与口播剪辑相同 | 需要购买 |
edit_video | 按一句指令编辑视频，与 AI 视频编辑器相同 | 需要购买 |
broll_cut | 根据脚本和你的片段生成带字幕的 B-roll 视频，与 AI B-Roll 编辑器相同 | 需要购买 |
import_file | 把公开链接上的文件复制到应用的工作区 | 免费 |
list_files | 列出应用工作区里的文件 | 免费 |
get_job_status | 读取任务状态，完成后返回文件 | 免费 |
list_jobs | 列出应用最近的任务 | 免费 |
get_credits_balance | 读取你的积分余额和免费规则 | 免费 |
search_help_docs | 搜索本帮助中心 | 免费 |
每个工具都会把自己的输入和模型告诉应用，所以你可以直接用日常语言提出需求。应用会选择工具并补全细节。
文件与任务
- 你的工作区。 每个已连接的应用都在 AI 视频智能体里有一个以应用命名的对话。在网站上打开它，就能查看、下载或复用每个文件。
- 导入文件。 给应用一个公开的
https链接，import_file会把文件复制到工作区。支持 MP4、MOV、PNG、JPG、WEBP、MP3、WAV 和 M4A 文件，最大约 5 GB，复制的文件计入你的每日上传额度。你也可以在网站上把文件上传到这个应用的对话里，应用会通过list_files找到它。 - 任务。 创作工具会启动一个任务，并返回
job_id和预估积分。应用随后调用get_job_status，直到任务完成。使用wait_seconds（最多 25）时，一次调用会等待结果，应用就不必频繁询问。 - 结果。 完成的任务会返回文件链接，这些文件也会保存在工作区里。
积分与限制
已连接的应用使用你 AgentReel 账号的积分，价格与每个工具页面上的相同。应用可以在开始前用 get_credits_balance 读取你的余额。
- 免费账号。 首次购买之前，已连接的应用只能把积分用于 Z-Image 图片、视频模板和 Code to Video。其他工具都需要先购买。免费 B-roll 试用和免费 AI 视频只能在网站上使用。每日签到可在网站上领取 15 个免费积分，每个 UTC 日一次。
- 付费账号。 所有工具和模型全部开放。详见价格页面和积分、套餐与免费额度。
- 退款。 失败的任务会把积分退回原来的积分池。
- 每个账号的限制。 每分钟 60 次调用、每天 1,000 次计费的工具调用、同时最多 5 个运行中的任务。达到限制时，工具会返回应用能读懂的错误，稍后再试即可。
当工具需要购买或更多积分时，它会返回 PURCHASE_REQUIRED、FREE_MODEL_ONLY 或 INSUFFICIENT_CREDITS，并附上价格页面的链接，不会扣除任何积分。
断开连接
- 打开控制台里的已连接的应用，可以看到你允许过的每个应用、连接时间和最近使用时间。
- 点击断开连接，立即结束该应用的访问权限。只在应用里删除服务器并不会结束访问。
- 一次登录有效一小时，只要应用至少每 30 天使用一次，就会自动续期。连接最长保持 180 天，到期后应用会请你重新登录。
隐私
已连接的应用只能做你在授权页面上允许的事：
- 运行花费你积分的 AgentReel 工具，
- 导入、列出和读取它自己工作区里的文件，
- 读取它的任务和你的积分余额，
- 搜索帮助中心。
它看不到你的密码和支付信息，也无法列出你的其他对话或项目。你通过应用发送的提示词和文件，也会由该应用的提供方按其隐私条款处理。AgentReel 如何处理你的数据，请阅读隐私与安全。