InstantClips

InstantClips MCP

English · Español · 简体中文

InstantClips 可将电商产品转化为适用于 TikTok、Instagram Reels 和 Stories 的竖屏短视频。它运行在托管的 MCP 服务上，因此 Claude Code、Codex、Cursor、VS Code、Claude 应用、ChatGPT 或任何其他 MCP 客户端，都能像使用 Web 应用一样导入产品、拟定方案并生成视频。

这不是文生视频生成器。 InstantClips 会读取产品页面上的照片、价格和详情，并根据实际信息制作广告。它会先撰写方案并展示给你，然后再按方案生成视频。这使得它的成本足够低，可以用于整个产品目录；生成的内容也会聚焦于你实际销售的产品，而不是对产品的猜测。

免费开始：欢迎赠送的额度可用于制作第一个视频，无需填写银行卡信息。之后可以购买一次性额度包，或选择适合同时运营多个品牌的 Agency 会员。请参阅定价。

• 适用场景。 可配合负责发布内容的排期工具（Postiz、Buffer）使用，也可配合用于判断哪个开场钩子有效的归因工具使用。当你有产品页面却没有视频素材时，可用它替代视频编辑工具。
• 不适用场景。 电影级主打视频、由主持人朗读你的脚本、横屏 4K 视频，以及没有产品页面和照片的产品。
• 适用对象。 Shopify 卖家、代发货商、品牌方，以及同时为多家商店运营社交媒体的代理机构。

产品服务始终托管运行。 此仓库包含连接指南、注册表元数据、HTTP 客户端示例，以及一个小型开源 stdio 适配器，供无法直接连接远程服务的客户端使用。适配器会根据生成的快照响应初始化、ping 和工具发现请求，然后将经过身份验证的工具调用发送到托管端点。托管服务仍是事实来源；此处不会重复实现产品功能。

端点

端点	https://app.instantclips.ai/mcp
传输方式	Streamable HTTP，无状态
方法	POST，JSON-RPC 2.0
身份验证	客户端提示时登录（OAuth 2.1）；不支持浏览器的调用方可使用 Authorization: Bearer <token>

将一个地址粘贴到你的助手中，并按提示登录即可完成设置。首次调用时，服务会将你转到 InstantClips 登录页面，并请求你批准该助手；无需复制任何密钥。所有获批的助手都会列在设置中的 Authorized apps 下，你可以在此断开连接。

连接到的是你自己的账户：与你在 Web 应用中使用相同的品牌、产品、额度和计划限制。如果你还没有账户，登录时会创建一个，并附赠制作第一个视频的额度。

在浏览器中打开端点会显示设置页面，而不是协议错误；页面提供适用于 Cursor 和 VS Code 的一键安装按钮。

安装

只要客户端支持 Streamable HTTP，就可以直接连接到托管端点；首次使用时会引导你完成登录。仅当脚本和自动化运行器无法打开登录页面时，才使用令牌和 stdio 适配器（见下方“没有浏览器？”）。

Claude Code

claude mcp add --transport http --scope user instantclips https://app.instantclips.ai/mcp

然后在 Claude Code 中运行 /mcp，并选择 instantclips 登录。--scope user 会将其添加到每个项目；不加此选项时，Claude Code 只会将服务添加到你运行命令所在的文件夹。

Codex

添加到 ~/.codex/config.toml。Codex CLI、Codex IDE 扩展和 ChatGPT 桌面应用都会读取此文件：

[mcp_servers.instantclips]
url = "https://app.instantclips.ai/mcp"

然后运行 codex mcp login instantclips 登录。

Cursor 和 VS Code

设置页面提供一键安装按钮。点击后会打开应用、添加 InstantClips，并在首次使用时为你登录。

Claude 应用

1. 在 自定义 › 连接器 中，选择 + › 添加自定义连接器，粘贴 https://app.instantclips.ai/mcp，然后选择 添加。
2. 选择 连接，并登录 InstantClips。
3. 在对话中，通过 + › 连接器 开启 InstantClips。

如果使用 Team 或 Enterprise 方案，所有者需先在 组织设置 › 连接器 中添加它，然后每位成员再在 自定义 › 连接器 中连接。

ChatGPT

1. 在 chatgpt.com 上，前往 设置 › 安全和登录，开启 开发者模式。
2. 打开 chatgpt.com/plugins，选择 +，并使用 OAuth 为 https://app.instantclips.ai/mcp 创建应用，然后按提示登录 InstantClips。
3. 在对话中，从 + 菜单选择 开发者模式，再选择 InstantClips。

如果使用 Business、Enterprise 或 Edu 工作区，管理员需在 工作区设置 › 应用 › 创建 下创建应用，并将其发布到工作区。

在 ChatGPT 中，将产品照片附加到对话并请求生成视频：该插件直接接收附件（create_product_from_images 上的 image_files、update_product 上的 add_image_files），因此照片无需适配器，也无需在此处提供令牌。

菜单名称以 2026 年 9 月各应用中的名称为准。如果菜单位置已变更，请参考 Claude 的 自定义连接器指南 和 OpenAI 的开发者模式指南，查看最新名称。

其他 MCP 客户端或 Agent

OpenClaw、Hermes，或你自行编写的 Agent：通过可流式传输的 HTTP 将其指向该地址。服务会按标准方式公布登录流程，因此遵循规范的客户端无需进行其他配置。无法打开登录页面的客户端则使用下文介绍的令牌。

无法使用浏览器？使用访问令牌

无法打开登录页面的脚本、CI 任务和 Agent 可改用长期有效的令牌进行身份验证。请在 app.instantclips.ai/settings#ai-access 创建令牌。该令牌可完全访问你的账户，因此请勿将其放入任何提交的内容中。

使用令牌时，这些客户端的配置如下：

# Claude Code
claude mcp add --transport http --scope user instantclips https://app.instantclips.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"

# Codex, in ~/.codex/config.toml
[mcp_servers.instantclips]
url = "https://app.instantclips.ai/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }

若要避免将令牌写入 Codex 文件，请将请求头替换为 bearer_token_env_var = "INSTANTCLIPS_TOKEN"，并改为在 shell 中导出该环境变量。其他任何客户端都可以发送 Authorization: Bearer 请求头。传输的数据没有任何内容是 InstantClips 专属的。聊天应用始终可以使用浏览器登录，因此应使用上述步骤，而不是令牌。

仅支持 Stdio 的客户端和无头运行器

instantclips-mcp npm 包是一个轻量的 Stdio 到 HTTPS 适配器。它在本地提供初始化和工具发现功能，实现快速、无需凭据的冷启动；随后从环境变量读取令牌，并将工具调用发送到 InstantClips：

{
  "mcpServers": {
    "instantclips": {
      "command": "npx",
      "args": ["-y", "instantclips-mcp"],
      "env": {
        "INSTANTCLIPS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

如需进行自动化连通性检查（包括获取实时工具名称）：

INSTANTCLIPS_TOKEN="your-token" npx -y instantclips-mcp --check --json

令牌只能通过 INSTANTCLIPS_TOKEN 提供，不能作为命令行参数，因此不会出现在进程列表中。调用工具时需要令牌，但执行 initialize、ping 或 tools/list 时不需要。需要 Node.js 20 或更高版本。

这台机器上的照片：适配器可以自行上传照片，因此可以用从未离开笔记本电脑的文件制作视频。通过适配器调用 create_product_from_images 时，使用 image_paths（文件路径，最多 9 个文件，每个不超过 8 MB）代替 image_urls；调用 update_product 时使用 add_image_paths。文件会打包后直接发送到 InstantClips，作为产品照片——不会从任何地方下载文件。将文件拖入能把文件路径交给助手的客户端（Claude Code、Cursor、VS Code、终端 Agent），然后告诉它你想制作什么。单独发送 image_paths：如果同一次调用还带有托管的 image_urls，适配器会拒绝该调用，而不是丢弃这些 URL；之后可通过 update_product 添加托管照片。

入门提示词

从以下五条开始。替换其中的链接或产品名称。

1. “为这个产品制作一则视频广告：[URL]”
2. “导入此系列页面上的所有产品，并为每个产品拟定计划。暂时不要生成任何内容。”
3. “展示 [product] 的计划，并改写开场钩子，让它以价格为主。”
4. “为 [URL] 制作三条视频，每条使用不同的开场钩子，方便我测试。”
5. “这个产品属于我的哪个品牌？然后制作视频。”

工具

工作流，按顺序如下：

1. 导入 — 对于商店页面，使用 import_product_from_url；如果没有可读取的页面，则使用 create_product_from_images。
2. 等待导入完成 — 轮询 get_product，直到 import_status 为 "imported"。
3. 选择创意，再查看计划 — 像网站一样提供产品的 ideas。将用户的选择或用户自己的表述写入 update_video_direction 的 creator_note，以生成计划；如果没有指定创意，则由 redraft_video_direction 为用户选择。计划会以文本形式返回，供用户查看；update_video_direction 可修改其中的任何内容。
4. 生成 — 调用 generate_video，并传入 expected_credit_cost：即告知用户的费用，也就是 get_product 报告的费用。如果两者不匹配，则会拒绝生成且不扣费。
5. 收集 — 轮询 get_video，直到视频完成，然后向用户提供 download_url、视频本身的页面以及公开分享链接。

为同一产品制作另一条视频时，仍使用该产品的相同工作流：编辑或重新起草会打开下一条视频的草稿；如果没有草稿，调用 generate_video 会根据上一个计划渲染另一版视频。生成的视频本身无法修改。每个 get_product 响应都包含 next_step，用于说明现在该做什么。用户观看视频后，rate_video 会记录其评价；经用户同意后，send_feedback 会向团队发送关于工具本身的反馈。

品牌的操作方式相同：list_brands、create_brand、set_product_brand。每条视频都会按照某个品牌的风格起草，因此如果导入的产品店面与现有品牌都不匹配，系统会暂停并询问，而不是自行猜测。

每个工具的确切参数都由托管服务端发布。生成的 manifest/instantclips-mcp.json 快照让仅支持 Stdio 的客户端和注册表无需凭据即可查看相同的 Schema。维护者可通过 INSTANTCLIPS_TOKEN="..." npm run sync:manifest 更新快照；如果已提交的快照与实时服务端不一致，运行 npm run check:manifest 会失败。如果你需要通过 HTTP 打印实时 Schema，请在下方运行 python example.py tools。

积分

导入产品、起草计划和编辑计划都免费。只有 generate_video 工具会消耗积分，而且需要你明确批准——工具会先报告费用，generate_video 会将该数值作为 expected_credit_cost 传回，并拒绝启动费用已变动的任务。Agent 无法悄悄累积账单。请参阅定价。

example.py

一个无需依赖的 MCP 客户端——Python 3.9+，仅使用标准库，无需 pip install。它使用令牌进行身份验证，因为脚本无法通过浏览器登录。

export INSTANTCLIPS_TOKEN="your-token"

python example.py tools                 # every tool, with its live input schema
python example.py call list_brands '{}' # call one tool with JSON arguments

应当先运行 tools：它会打印每个工具的实际参数名称和类型，这正是你编写上述工作流脚本所需要的信息。

链接

• instantclips.ai/automate — 介绍自动化的用途：根据商店页面、入门提示词、按顺序调用的工具以及相关规则生成实际结果。此页面不会重复介绍设置；相关内容请见本文档和应用的设置页面。
• app.instantclips.ai/llms.txt — 以机器可读格式介绍产品和工具调用顺序
• 条款 · 隐私

Registry

server.json 是此服务在官方 MCP 注册表中的条目，其他目录会从该注册表导入信息。一个 ai.instantclips/instantclips 条目同时在 remotes 中包含托管端点，并在 packages 中包含 stdio 适配器，因此主机可以选择其支持的传输方式，无需为相同的工具界面创建两个身份。

npm 包的 mcpName 必须与该注册表名称完全一致。仓库链接指向开源适配器；托管产品的实现不在此仓库中。

ai.instantclips 命名空间是域名的反向 DNS 格式，因此必须通过 DNS 或 HTTP 域名身份验证发布，而不能使用 GitHub 身份验证。改用 GitHub 身份验证会迫使该条目使用 io.github.instantstudioai/...，并放弃品牌命名空间。

先发布 npm 包，然后在提升其 version 后，使用 mcp-publisher publish 重新发布同一注册表条目。域名身份验证会保留品牌命名空间 ai.instantclips；不要将其替换为 io.github.* 名称。签名密钥不能放入仓库；.gitignore 已涵盖 *.pem，而已提交的私钥就等于已公开的私钥。

npm 包通过 GitHub Actions 发布，而不是从笔记本电脑发布。提交版本更新（package.json、server.json 以及 test/shim.test.js 中的固定值），然后推送以该版本命名的标签（git tag v1.7.2 && git push origin main v1.7.2）；.github/workflows/publish.yml 会运行测试，并通过 npm 的可信发布机制发布，无需 npm 令牌，也无需浏览器确认。如果标签与 package.json 中的 version 不一致，作业就会停止。npmjs.com 上该包的可信发布者配置指向此仓库和 publish.yml，因此重命名工作流文件会导致发布失败。

新版本可能需要几分钟才会出现在 npm 上；如果注册表找不到对应的 npm 版本，就会拒绝该条目（“version … was not found”；不会有任何更改）。等到 https://registry.npmjs.org/instantclips-mcp/<version> 有响应后，再运行 mcp-publisher 步骤。

登录和发布必须在同一条命令中完成——注册表令牌会在登录五分钟后过期；域名通过 HTTP 而非 DNS 验证：营销网站上的 instantclips.ai/.well-known/mcp-registry-auth 会提供此密钥的公钥部分（v=MCPv1; k=ed25519; p=…），且没有 TXT 记录，因此 login dns 会因“no MCP public key found”而失败。

mcp-publisher login http --domain instantclips.ai \
  --private-key "$(openssl pkey -in key.pem -text -noout | awk '/priv:/{f=1;next} /pub:/{f=0} f' | tr -d ' :\n')" \
  && mcp-publisher publish

test/shim.test.js 固定了快照中的服务版本以及 server.json 的 version；发布新版本时需要同时更新二者。

glama.json 是 Glama 专用的独立文件，用于认领在 Glama 上的列表。如果服务归某个组织所有，而非个人账户所有，则只有提供该文件才能认领。 该文件仅声明所有权。对于 Glama 的 Dockerfile 格式，请使用构建步骤 ["npm install --omit=dev"]、CMD 参数 ["node", "./bin/instantclips-mcp.js"]，并为必填的 INSTANTCLIPS_TOKEN 占位符填入任意虚拟值。Glama 的初始化和工具质量检查会使用随附的清单，绝不会将该占位符传送到上游。不要将真实账户令牌放入第三方构建沙箱。

许可证

MIT——详见 LICENSE。该许可证涵盖此仓库的内容；托管服务的使用受服务条款约束。