Clip Studio MCP

Clip Studio MCP

Clip Studio 用のホスト型 Model Context Protocol サーバーです。Claude、Cursor、ChatGPT、または任意の MCP クライアントに URL を 1 つ追加すると、サインイン済みのユーザーがすでに利用できる 同じ 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 が開いたらサインインし、承認します。

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 で承認を完了します。

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 アカウントでサインインして承認します。トークンはクライアントに保存されます。

貼り付けるクライアント ID はありません。clipstudio.ai でユーザーができない操作は、エージェントにもここではできません。

有料ジョブの仕組み

1. 見積もり（quote_*）。生成は行いません。

2. 月間生成枠で見積もりをまかなえない場合、ツールは数値の JSON フィールド（名前のみ。これらは API キーであり、UI の文言ではありません）を含む HTTP 402 を返します。

   {
     "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	オープニングフックのテンプレート（Problem、Curiosity、Trust、Niche）を一覧表示します。トピック／ブリーフのシードに使用します。キャプションスタイルではありません。
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ビートのスクリプト → カタログのクリエイター → 縦型動画1本。

ツール	説明
research_ad_studio	切り口と、内容が固定された5ビートのスクリプトを調査します。レンダリングは行いません。
quote_ad_studio	Ad Studioジョブの見積もりを取得します。カタログのクリエイターのみ使用できます。
generate_ad_studio	有料動画の生成を開始します。get_ad_studioで状況を確認します。
get_ad_studio	生成結果を取得します。送信して状況を確認します。

Last Frame

生成した映画を再生します。最後のフレームが正史になります。

ツール	説明
list_last_frame_games	ゲーム（Adventure、Heist、Tapeなど）を一覧表示します。
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 パック、Proof パック、または 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 パックの見積もりを取得します。生成は行いません。
generate_ad_tip_pack	tip パックを生成します。get_ad_generation でポーリングしてください。
quote_ad_proof_pack	Proof パックの見積もりを取得します。生成は行いません。
generate_ad_proof_pack	Proof パックを生成します。get_ad_generation でポーリングしてください。
quote_ad_explain	Explain 映画の見積もりを取得します。生成は行いません。
generate_ad_explain	商品写真と概要から Explain 映画を生成します。
list_ad_generations	ジョブを一覧表示します。companyId または kind（tip_pack、proof_pack、explain）を指定できます。
get_ad_generation	1 件のジョブを取得します。

Library

すでに生成したクリップです。公開すると Clip Studio の公開ページが作成されます。SNSへの自動投稿ではありません。

ツール	説明
list_library	ライブラリ内のクリップを一覧表示します。
get_clip	ライブラリ内のクリップを 1 件取得します。
publish_generation	完了した生成結果を公開ページに公開します。
unpublish_generation	公開した生成結果を非公開にします。
get_generation_publication	生成結果が公開されているかどうかと、公開中の場合はその公開 URL を取得します。
list_public_generations	公開中の生成結果を一覧表示します。kind、model、limit を指定できます。
get_public_generation	クリップ ID で公開中の生成結果を 1 件取得します。

Free tools

/tools にあるコピー、フック、概要、プランニング用ツールです。動画は生成しません。

ツール	説明
list_free_tools	公開されている無料ツールを一覧表示します。
run_free_tool	無料ツールを実行します（slug + input）。

Account

プラン、使用状況、請求に関するツールです。

ツール	説明
list_public_products	エージェントがこのサーバー経由で利用できる公開プロダクトを一覧表示します。
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 の非公開ソースをインポートしません。