用途 该技能用于从结构化创意简报生成短竖屏 UGC 风格广告片段，长度约 7 至 12 秒，并从 OpenClip 的 AI 创作者名单中选择出镜角色。典型使用场景包括为应用制作 UGC 广告、测试不同广告角度、复用此前作品中的创作者，以及查询当前团队可用的创作者。
主要能力
- list_ugc_creators：返回当前团队可用的 creator 与 start_frame 取值，名单包含精选创作者和团队自建创作者，并按细分领域分组。每次会话首次生成前应先调用，名单与团队相关且会变化，不应猜测创作者名称。
- generate_ugc：以 brief_name（服务端预设，快速路径）或 brief（内联的结构化创意字段对象）生成广告，返回 ugc_job hashid。
- get_ugc_job_status：轮询任务状态，建议每 10 至 15 秒一次。queued 与 rendering 表示处理中；completed 返回 video_url 与 result_meta（时长、尺寸、帧率、seed）；failed 返回 error。
- list_ugc_jobs：列出团队此前生成的 UGC 片段，可用于找回丢失的 ugc_job id。
- get_account：用于连接后的检查，也可在承诺批量生成前确认每日额度。
使用方式 OpenClip 是位于 https://openclip.app/mcp 的远程 MCP 服务器。出现 OAuth 提示时用 OpenClip 账户登录，无需复制 API key。 Claude Code：claude mcp add --transport http openclip https://openclip.app/mcp，然后使用 /mcp 授权。 Claude Desktop / web：在 Settings 的 Connectors 中选择 "Add custom connector"，粘贴 URL 并登录。 Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } } 仅支持 Header 的客户端：在 openclip.app/settings/connect 签发 MCP token，连接 https://openclip.app/mcp/key，并携带 Authorization: Bearer <token>。 连接后调用 get_account 做检查。
创意简报的写法 brief 不是一段散文式提示词，而是由离散创意字段（character 等 API 接受的字段）组成的对象。每个字段应写具体、物理、可拍摄的细节：说明画面里有什么，而不是感受如何，例如 "Holding the bottle at chest height, kitchen counter behind" 优于 "energetic and aspirational vibes"。每个字段只表达一个想法；具体场景、具体道具与具体动作比形容词更有效。
测试广告角度 需要多个变体时，每次渲染只改变一个变量：同一创作者换钩子；同一钩子换创作者；其余不变仅换 start_frame 以测试缩略图时刻。免费账户每天仅一次生成，应把额度用于差异最大的角度而非近似重复；承诺批量前先调用 get_account 确认额度。
适用场景 为应用或产品制作 UGC 风格短视频广告；在预算有限时比较不同钩子、创作者或起始帧；复用受喜欢的渲染结果（保留 result_meta 中的 seed 以制作接近的变体）；回顾团队历史作品。
限制与规则
- 片段按设计很短，约 7 至 12 秒，不应承诺 60 秒广告。
- 免费账户每天仅一次生成；付费账户按渲染秒数用 credits 计量。
- 渲染较重，每个片段通常需要几分钟而非几秒，generate_ugc 会立即返回，必须轮询。
- 每次会话首次生成前先调用 list_ugc_creators。
- 错误以 isError: true 的工具结果和纯文本消息返回，而非 HTTP 状态码；"Not authenticated. Reconnect your OpenClip token." 表示需重新连接或重新签发 token；校验类消息（未知创作者、格式错误的 brief）需修正参数后重试。
- 免费修剪、裁剪与压缩生成片段属于 openclip-video-editing；将真实长视频剪辑为短片属于 openclip-clipping。