用途 OpenClip 的自动剪辑流程：提交一个播客、网络研讨会、访谈、直播或 YouTube 链接等长视频，返回按传播力评分（0-10）排序的“病毒时刻”，每个片段附带标题、钩子（hook）、引用、社交文案、适用平台、分类、起止时间（毫秒）和片段 CDN 链接。这是一条付费流程，需要有效的 OpenClip 订阅和积分，积分以处理分钟数计量。
主要能力
- 提交长视频：支持通过 submit_video(url) 提交远程链接；如果来源不确定，可先调用 list_supported_providers 检查。对于本地文件，需要依次调用 create_upload(filename, content_type)、上传字节、complete_upload（这一步才会启动付费流程）。
- 状态与结果：通过 get_video_status(job_id) 轮询，直到 completed 或到达终态；完成后用 list_clips(job_id) 获取片段列表。
- 字幕渲染（可选）：render_clip(moment_id, caption_preset) 把字幕烧录进画面，同样为异步。
- 评分解释：每个片段提供 virality_score（0-10）和 viral_score_details 子分（0-100），包括钩子强度、可分享性、可重复观看性、意外感和情感冲击，可用于说明排名原因。
- 可复用预设：用 create_agent 保存一套处理配置（追踪模型、字幕预设、构图、Logo 水印），然后在 submit_video 中传入以复用；describe_agent_settings 说明各字段与取值；update_agent 只修改提交的字段；create_agent_logo_upload 与 set_agent_logo 可附加水印（最大 2 MB）；get_usage 查看积分余额与近期活动。
使用方式 在 https://openclip.app/mcp 配置远端 MCP 服务器，出现 OAuth 提示时用 OpenClip 账号登录，无需复制 API 密钥。
- Claude Code：claude mcp add --transport http openclip https://openclip.app/mcp，然后用 /mcp 授权。
- Claude Desktop / Web：设置 → Connectors → “Add custom connector”，粘贴 URL 并登录。
- Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
- 仅支持请求头的客户端：在 openclip.app/settings/connect 生成 MCP token，连接 https://openclip.app/mcp/key，并使用 Authorization: Bearer <token>。 自检：调用 get_account，确认 credits_remaining > 0。 基本循环：submit_video(url) 返回 job_id（状态 queued）→ 轮询 get_video_status，期间不要调用 list_clips → 在状态为 completed 后调用 list_clips → 可选调用 render_clip。
状态解读 submit_video 在已认证时总是成功并入队，不会预先检查订阅或积分，门槛会在 get_video_status 中表现为状态值：pending / downloading / processing 表示仍在进行，继续轮询；completed 为终态，可以取片段；failed 为终态，若提交后很快出现，通常表示没有有效订阅，应提示用户在 openclip.app 订阅；pending_credits 表示团队的积分已用完，需要充值；嵌套的 video.status 为 download_failed 表示源 URL 无法获取，请用户检查链接。video.progress 是粗略值（失败时约 0、下载时个位数、上传约 10、处理约 20、完成 100），控制流程应以 status 为准。
适用场景与限制 适合把长内容批量拆成竖屏短视频并按传播潜力排序，用于社媒分发。片段 URL 是永久 CDN 链接，不签名、不过期。该 API 不支持项目与文件夹，不要承诺该能力；list_videos 可查看账号内已有视频。这是 MCP 工具而非 REST API，失败以 isError: true 和纯文本消息返回，没有 HTTP 状态码或 JSON 错误结构；常见提示包括未认证需重连、job 未找到、moment 未找到、视频尚不可用等，按提示修正参数后重试。始终轮询，不假定提交立即完成；按 virality_score 从高到低排序；时间单位是毫秒。