Clipform

@clipform/mcp-server

适用于 Clipform 的 MCP 服务——可通过任意 MCP 客户端（Claude、ChatGPT、Cursor、Windsurf 等）创建和管理视频风格的表单。

安装

有两种连接方式：远程（推荐，使用你的 Clipform 账户）和本地（匿名使用，受免费套餐限制）。

远程（推荐）

如果你有 Clipform 账户，请使用此方式。表单会直接创建在你的工作区中，并适用你的套餐等级（Pro 套餐不限制 3 个节点）。

Claude（claude.ai）： 设置 → 连接器 → 添加自定义连接器 → 输入 https://mcp.clipform.io

ChatGPT： 设置 → 连接器 → 高级 → 启用开发者模式 → 创建连接器 → 输入 https://mcp.clipform.io（需要 Pro/Team/Enterprise）

支持 OAuth 的任意 MCP 客户端： 将其指向 https://mcp.clipform.io——发现、注册和身份验证都会通过 OAuth 2.1 + 动态客户端注册（RFC 7591）自动处理。

本地 - Claude Code / Claude Desktop / Cursor / 等

适用于基于 stdio 的 MCP 客户端。传入你的 API 密钥，以使用工作区和套餐进行身份验证。

Claude Code：

claude mcp add clipform -e CLIPFORM_API_KEY=cf_xxx -- npx -y @clipform/mcp-server

Claude Desktop / Cursor / Windsurf / OpenClaw - 添加到你的 MCP 配置中：

{
  "mcpServers": {
    "clipform": {
      "command": "npx",
      "args": ["-y", "@clipform/mcp-server"],
      "env": {
        "CLIPFORM_API_KEY": "cf_xxx",
        "API_URL": "https://api.clipform.io"
      }
    }
  }
}

在 Clipform 控制面板的 Developers > API keys 下生成 API 密钥。本地服务始终需要 API 密钥——如需无账户试用 Clipform，请改为连接到 https://mcp.clipform.io（参见“工作原理”）。

环境变量

变量	必需	用途
CLIPFORM_API_KEY	用于工作区身份验证	Bearer 密钥——表单会创建在该密钥所属的工作区中，并受其套餐限制。还可解锁创意工具（搜索、TTS、视频渲染）。本地服务必需。
API_URL	是	Clipform API 基础 URL（https://api.clipform.io，或你的本地/自托管 API）。

工具

连接后，你的 MCP 客户端会自动列出这些工具（通过 tools/list）。完整参考——包括参数、架构和示例——请参阅文档。

工具	描述
clipform_create_form	创建新的 Clipform（交互式视频风格表单）。
clipform_import_form	将公开的 Google Form、Typeform 或 Tally 表单中的问题复制到新的 Clipform 草稿中。
clipform_list_forms	列出工作区中的表单，可选择筛选条件。
clipform_whoami	显示当前身份：认证模式（api key、oauth、session 或 anonymous）、当前工作区和套餐限制。
clipform_get_form	获取表单详情，包括按顺序排列的所有节点及其路由。
clipform_update_form	更新表单标题、发布状态、设置或标签。
clipform_delete_form	将表单及其所有节点移至回收站。
clipform_get_results	查看表单的回复数量、选择题／操作题答案细分，以及近期的开放文本答案。
clipform_get_responses	按时间筛选列出 Clipform 表单的单条回复（提交记录），作为 clipform_get_results（汇总数据）的补充。
clipform_add_node	向现有表单添加新节点。
clipform_update_node	更新一个或多个现有节点的文本、类型、配置或选项。
clipform_delete_node	从表单中删除节点。
clipform_upload_media_asset	将一个或多个媒体文件放入工作区媒体库（最多 10 个，依次上传）。
clipform_complete_media_upload	确认已完成签名 PUT 静态图片上传；需先将字节数据 PUT 到 clipform_upload_media_asset 返回的 upload_url。
clipform_attach_node_media	将现有工作区媒体资源（来自 clipform_upload_media_asset）附加到一个或多个节点（最多 10 个）。
clipform_get_node_media	获取附加到节点的媒体，包括处理状态。
clipform_delete_node_media	通过取消关联来移除节点上的媒体；媒体资源及其文件仍保留在工作区媒体库中，并可继续用于其他节点或使用它们的在线表单。
clipform_set_logic	为一个或多个节点设置下一个节点，连接成线性路径（A 到 B 到 C）。
clipform_log_generation	表单生成工作流执行的内部审计步骤。
clipform_search_news	搜索 NewsAPI 和 The Guardian 的近期新闻文章，并以结构化结果返回。
clipform_generate_tts	根据文本生成带有逐词字幕的旁白音频。
clipform_search_media	搜索图片或库存视频片段。
clipform_render_composition	将专用视频合成渲染为 MP4 或 PNG，适用于视频模板无法提供的自定义动画视觉效果，例如地理动画或设计动效。
clipform_search_music	搜索免版税音乐曲目和环境音效。
clipform_list_compositions	浏览可用的视频合成及其预期的 props 模式。
clipform_list_video_templates	浏览可用的视频模板——精选的 Scene 排列（背景 + 叠加层 + 合理的默认值），通过 Scene 合成使用简易控制对象进行渲染。
clipform_render_video_template	使用简易控制对象，将精选的视频模板（预先排列的 Scene：背景 + 叠加层 + 合理的默认值）渲染为 MP4 或 PNG，而无需手动组装 Scene 图层。
clipform_list_assets	列出可用于视频合成的创意资源（音效、动画、字体）。
clipform_check_render	检查由 clipform_render_video_template 或 clipform_render_composition 启动的渲染任务状态。
clipform_fetch_boundary	获取国家、城市或地区的 GeoJSON 边界多边形。
clipform_get_guide	获取构建特定类型表单的专业知识。
clipform_get_workflow	获取创建特定类型表单的分步构建工作流。

示例

创建一个名为 "Customer Feedback" 的 Clipform，添加一个选择题，询问 "How would you rate our service?"，选项为 Excellent、Good、Fair、Poor；然后添加一个开放式问题，询问 "Any additional comments?"；最后添加一个显示 "Thanks for your feedback!" 的结束屏幕。

工作原理

远程（OAuth）： Bearer 令牌的受众绑定到 https://mcp.clipform.io（RFC 8707），且仅限 mcp 作用域。默认情况下，表单会直接创建在你授权时选定的工作区中。一个连接即可访问你在同一家公司所属的所有工作区：在 clipform_create_form、clipform_import_form、clipform_list_forms、clipform_upload_media_asset 或 clipform_generate_tts 上传入 workspace_id（ID 来自 clipform_whoami），或者在任意表单工具中传入其他工作区的 form_id——包括 clipform_upload_media_asset、clipform_generate_tts 和 clipform_complete_media_upload，此时它仅作为路由提示（结果仍会存放在该工作区的媒体库中，而不会放到某个节点上）。每次调用都会重新检查成员身份，结果会注明工作区。

本地（使用 API 密钥）： CLIPFORM_API_KEY 会通过标准的 Authorization: Bearer 标头发送。表单会直接创建在该密钥所属的工作区中，并受你的套餐等级限制。

远程匿名（无需登录）： 连接到 https://mcp.clipform.io 且不登录时，会在该会话专属的临时账户中创建表单。表单通过内容检查后会立即上线，最多接收 3 条回复，并在 7 天后下线，除非你注册；需要账户的步骤（付款、上传、下载、预约、外部链接）在注册前会被关闭。构建结果会包含一次性注册链接，可将表单转移到你的新账户中（在第一个表单创建时、之后定期以及达到表单数量上限时提供）；如果你已有账户，则回复“sign in”。认领后，包含这些步骤的表单会以草稿形式创建——发布即可启用这些步骤。未认领期间，表单 UUID 是编辑该表单的凭据；适用免费套餐限制。本地 stdio 服务始终需要 CLIPFORM_API_KEY。

以下工具需要已登录的 Clipform 账户（OAuth 或 API 密钥）：clipform_list_forms、clipform_whoami、clipform_get_results、clipform_get_responses、clipform_delete_form。匿名远程会话调用这些工具时，系统会要求登录（对于结果工具，提示为：“Sign in to see this form's responses”）。其他所有工具，包括 clipform_get_guide、clipform_get_workflow 和 clipform_list_assets，都可以在无需账户的情况下使用。

表单会自动创建起始节点和结束屏幕，你只需添加中间的节点。

链接

• Clipform - 创建交互式视频表单
• Documentation - 完整指南，包含节点类型等内容

Craft 指南（clipform://guides/*、clipform_get_guide）会在运行时从 Clipform API 获取，因此服务需要可访问的 API_URL 和有效的 CLIPFORM_API_KEY 才能提供这些指南。