Clip Studio MCP

Clip Studio MCP

Clip Studio 的托管式模型上下文协议服务。只需将一个 URL 添加到 Claude、Cursor、ChatGPT 或任何 MCP 客户端，即可使用已登录用户可使用的同一套公开 Clip Studio 产品——Video Lab、Topic Shorts、Talking Shorts、Ad Studio、Last Frame、Image Lab、Audio Lab、Story、Ad Lab、素材库和免费工具——并且使用与网站相同的套餐。

端点： https://clipstudio.ai/api/mcp
传输方式： Streamable HTTP
产品介绍： https://clipstudio.ai/mcp
公开工具列表： https://clipstudio.ai/mcp.md
代码仓库： https://github.com/j-acks0n/clipstudio-mcp
Smithery： https://smithery.ai/servers/clipstudioai/clipstudio

此仓库是一个连接器目录（server.json、安装代码片段和示例）。服务托管在云端，无需克隆和运行。

快速开始

粘贴 URL。OAuth 客户端 ID 留空。客户端打开 Clip Studio 后登录，然后点击 Approve。

Claude Desktop / Claude.ai 连接器

Customize → Connectors → Add custom connector。粘贴：

https://clipstudio.ai/api/mcp

连接。OAuth 客户端 ID 留空。

Cursor

在 ~/.cursor/mcp.json 中添加 HTTP MCP 服务。Cursor 会在首次使用时运行 OAuth。

{
  "mcpServers": {
    "clipstudio": {
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

ChatGPT（开发者模式连接器）

启用开发者模式，添加自定义 MCP 连接器，粘贴 https://clipstudio.ai/api/mcp，然后完成 Clip Studio 的 Approve 流程。

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json（远程字段为 serverUrl）：

{
  "mcpServers": {
    "clipstudio": {
      "serverUrl": "https://clipstudio.ai/api/mcp"
    }
  }
}

保存，然后在 Cascade 中刷新 MCP。

VS Code / Copilot

用户或工作区的 mcp.json：

{
  "servers": {
    "clipstudio": {
      "type": "http",
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

命令面板 → MCP: Open User Configuration，或在工作区中使用 .vscode/mcp.json。

仅支持 Stdio 的客户端

桥接到 Streamable HTTP：

npx -y mcp-remote https://clipstudio.ai/api/mcp

包装器示例：

{
  "mcpServers": {
    "clipstudio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clipstudio.ai/api/mcp"]
    }
  }
}

身份验证

首次调用时进行一键式 OAuth。未经身份验证的请求（包括 initialize 和 tools/list）会返回带有 WWW-Authenticate 和受保护资源元数据的 HTTP 401。客户端会动态注册（OAuth 2.1 + PKCE，公共客户端）。使用 Clip Studio 账号登录并点击 Approve。令牌保留在客户端。

无需粘贴客户端 ID。如果用户无法在 clipstudio.ai 上完成某项操作，Agent 也无法在此完成。

付费任务的工作方式

1. 获取报价（quote_*）。不会生成内容。

2. 如果每月生成额度不足以支付报价，工具会返回带有数值 JSON 字段的 HTTP 402（仅列出字段名称——这些是 API 键，并非 UI 文案）：

   {
     "requiredCredits": 120,
     "availableCredits": 0
   }
   

   然后使用 get_account.offerCheckout 中的 priceId 调用 create_checkout_url。它会返回 Stripe Checkout URL，且不会收集银行卡信息。

3. 生成（generate_* / start_last_frame / render_storyboard / …）。使用本月的生成额度。

4. 轮询对应的 get_* 工具，直到任务完成。

提交后轮询。不要让 MCP 请求等待完整的服务商渲染过程。

示例提示词

• 预览一条 15 秒的 Topic Short，主题是为什么大多数晨间习惯都会失败，然后获取报价并生成。
• 列出 Video Lab 模型，为一段 8 秒、16:9 的雨后跑道上跑鞋片段获取报价，生成并轮询，直到内容就绪。
• 继续我的故事：载入最新项目，撰写下一部分，然后渲染。
• 查看我每月剩余的生成额度。如果报价返回 402，则从 offerCheckout 打开结账页面。
• 根据此产品 URL 调研一条 Ad Studio 短片，选择一位目录中的创作者，获取报价、生成并轮询。

操作指南：examples/。

工具

名称与 https://clipstudio.ai/mcp.md 中的名称一致。付费工具使用本月的生成额度。

Video Lab

前沿的文本和图像转视频工具。生成前先获取报价。

工具	描述
list_video_lab_models	列出模型、模式和默认设置。与 /video-lab 使用相同的目录。
quote_video_lab	为配置获取报价。不会生成内容。付费生成需要此报价。
generate_video_lab	开始付费生成。轮询 get_video_lab_generation。
list_video_lab_generations	列出此账户的 Video Lab 生成记录。
get_video_lab_generation	按视频 ID 获取一条生成记录。
reconcile_video_lab_generation	从服务提供方刷新任务状态。不会再次扣费。
presign_generation_asset	为源图像或 MP4 创建上传位置。然后调用 complete_generation_asset。
complete_generation_asset	将源图像或 MP4 上传标记为就绪。

Topic Shorts

主题 → 故事 + 素材库内容 + 配音。字幕模式默认值为 current。转场模式默认值为 dynamic。

工具	描述
list_hook_bank	开场钩子模板（问题、好奇心、信任、细分领域）。为主题/简报提供种子内容；不是字幕样式。
create_topic_short_story	预览节拍、旁白和英文素材库搜索词。不会渲染。
quote_topic_short	为 Topic Short 获取报价。不会渲染。按时长报价。
generate_topic_short	根据主题或经审核的 storyPlan 生成。轮询 get_topic_short。
get_topic_short	获取一条生成记录。

Talking Shorts

产品 URL 或简报 → 口播短片。提供目录中的面孔和声音。

工具	描述
research_talking_short	根据 URL 或简报进行调研。不会渲染。
quote_talking_short	为 Talking Short 获取报价。不会渲染。
generate_talking_short	开始付费 Talking Short。轮询 get_talking_short。
get_talking_short	获取一条生成记录。
list_talking_short_actors	列出目录中的静态图像。不会渲染。

Ad Studio

产品 → 切入角度 → 5 节拍脚本 → 目录创作者 → 一段竖屏片段。

工具	描述
research_ad_studio	调研切入角度并生成锁定的 5 节拍脚本。不会渲染。
quote_ad_studio	为 Ad Studio 任务获取报价。仅限目录中的创作者。
generate_ad_studio	开始生成付费片段。轮询 get_ad_studio。
get_ad_studio	获取一条生成记录。提交并轮询。

Last Frame

播放生成的影片。最后一帧即为正史。

工具	描述
list_last_frame_games	列出游戏（冒险、劫案、磁带等）。
list_last_frame_worlds	列出目录中的世界/地图。
quote_last_frame	为开场镜头或下一个镜头获取报价。不会拍摄。
start_last_frame	开始一轮并拍摄开场镜头。
get_last_frame_run	获取一轮的信息，包括最新镜头和选项。
choose_last_frame	选择一个带编号的选项。拍摄下一个镜头。
type_last_frame	输入自定义动作。拍摄下一个镜头。
timeout_last_frame	应用选项超时（HUD 计时器）。
end_last_frame_clip	告知本轮当前镜头已播放完毕。
arm_last_frame_item	为下一步操作装备一个库存物品（itemIndex 从 0 开始计数）。
create_last_frame_world	根据描述创建自定义世界。

Image Lab

静态图需先获取报价。与 /image-lab 使用相同的目录。

工具	描述
list_image_lab_models	列出模型、模式和宽高比。
quote_image_lab	为静态图获取报价。不会生成内容。付费生成需要此报价。
generate_image_lab	开始生成付费静态图。轮询 get_image_lab_generation。
list_image_lab_generations	列出此账户的 Image Lab 生成记录。
get_image_lab_generation	获取一条生成记录并从服务提供方刷新其状态。

Audio Lab

脚本 → 使用 Clip Studio 声音生成可下载的旁白。

工具	描述
list_audio_lab_voices	列出旁白声音（口音和地区设置）。
quote_audio_lab	获取脚本报价。不生成内容。
generate_audio_lab	开始付费旁白生成。轮询 get_audio_lab_generation。
list_audio_lab_generations	列出此账户的 Audio Lab 生成记录。
get_audio_lab_generation	获取一条生成记录，并从服务提供方刷新状态。

Story

完整故事 → 分集 → 影片。在同一个 projectId 上续写故事。

工具	描述
list_storyboard_themes	列出视觉主题（各集沿用）。
list_storyboard_voices	列出旁白声音（各集沿用）。
estimate_storyboard	根据脚本估算下一集。不渲染。
create_storyboard	根据完整故事创建项目。不撰写分集或制作影片。
get_storyboard	获取项目，或省略 projectId 以列出最近的项目。
generate_storyboard_part	在现有项目中撰写下一集。不制作影片。
render_storyboard	为最新一集制作影片。轮询 get_storyboard。

Ad Lab

网站 → 静态版式、tip pack、Proof pack 或 Explain 影片。

工具	描述
import_ad_website	将公开网站读取为公司资料。
quote_ad	获取静态版式报价。不生成内容。
generate_ad	生成静态图（layout 为 9:16、1:1、4:5 或 16:9）。轮询 get_ad_generation。
quote_ad_tip_pack	获取 tip pack 报价。不生成内容。
generate_ad_tip_pack	生成 tip pack。轮询 get_ad_generation。
quote_ad_proof_pack	获取 Proof pack 报价。不生成内容。
generate_ad_proof_pack	生成 Proof pack。轮询 get_ad_generation。
quote_ad_explain	获取 Explain 影片报价。不生成内容。
generate_ad_explain	根据产品照片和简报生成 Explain 影片。
list_ad_generations	列出任务。可选参数 companyId 或 kind，取值为 tip_pack、proof_pack、explain。
get_ad_generation	获取一项任务。

Library

已生成的片段。发布会生成公开的 Clip Studio 页面，不会自动发布到社交媒体。

工具	描述
list_library	列出资料库中的片段。
get_clip	获取资料库中的一段片段。
publish_generation	将已完成的生成内容发布到公开页面。
unpublish_generation	取消公开你发布的生成内容。
get_generation_publication	查询生成内容是否公开；若已公开，则返回其公开 URL。
list_public_generations	列出公开发布内容。可选参数 kind、model、limit。
get_public_generation	根据片段 ID 获取一项公开发布内容。

免费工具

位于 /tools 的文案改写、钩子、简报和规划工具。不生成视频。

工具	描述
list_free_tools	列出公开的免费工具。
run_free_tool	运行免费工具（slug + input）。

账户

套餐、用量和账单辅助工具。

工具	描述
list_public_products	列出 Agent 可通过此服务使用的公开产品。
get_account	获取已登录账户的套餐和用量；402 后还会包含 offerCheckout 价格 ID。
create_checkout_url	为 priceId 创建 Stripe Checkout URL。不接收银行卡信息。

链接

• 产品：https://clipstudio.ai/mcp
• 定价：https://clipstudio.ai/pricing
• 支持：https://clipstudio.ai/support
• 电子邮件：[email protected]
• Smithery：https://smithery.ai/servers/clipstudioai/clipstudio
• 注册表条目：server.json（ai.clipstudio/mcp）——参见 PUBLISHING.md

保持同步

工具列表与 https://clipstudio.ai/mcp.md 保持一致。该页面发生变化时，请手动更新此处的表格。请参阅 scripts/sync-tools.md。此仓库不会导入 Clip Studio 的私有源代码。