Clipwright

@clipwright/mcp-server

コーディングエージェントがスクリプトを書き、Clipwrightが、デフォルトで1080×1920の、俳優がスクリプトを話す縦型ショート動画をレンダリングします。また、スクリプトや短い概要から、最長90秒の顔出しなし動画も作成できます。冒頭のアニメーションクリップと画像シーンにナレーションを重ね、カメラの前にプレゼンターは登場しません。エージェントは費用が発生する前に無料見積もりを依頼し、APIで対応できない内容は黙って破棄されるのではなく、warnings[]で返されます。

エージェントはすぐにrun_idを取得し、動画URLの準備ができるまでポーリングします。 Clipwrightはファイルを返しますが、どこにも公開しません。見積もり、音声、俳優、アカウント残高は無料です。レンダリングにはクレジットを消費します。サインアップして開設したアカウントには、90秒の顔出しなし動画を1本作成できる420のトライアルクレジットが付与されます。クレジットはclipwright.io/pricingで追加購入できます。

インストール

接続方法は2つあります。ホスト型サーバーhttps://mcp.clipwright.io/mcpを使用する方法と、このパッケージをローカルでstdio経由で実行する方法です。どちらも同じツールを提供します。

キー不要のホステッドサーバー

URLをクライアントに追加します。初回の利用時にクライアントがブラウザーを開き、Clipwrightにサインインしてアプリを承認します。**Claude Codeと以下のデバイスコードフローは、2026-10-18に実機で検証済みです。**ほかのコマンドは各クライアントのドキュメントに記載されたもので、Clipwrightではまだ試していません。

• Claude Code（実機検証済み）：claude mcp add --transport http clipwright https://mcp.clipwright.io/mcpを実行し、セッションで/mcpを実行してサインインします。
• Claude.aiとClaude Desktop：「Customize」→「Connectors」→「Add custom connector」の順に選択し、URLを貼り付けます。
• **ChatGPT：**OpenAIのガイド「Connect and test your plugin」の説明に従って、プラグインのリモートMCPサーバーとしてURLを追加します。ChatGPTはOAuthでサインインします。
• Cursor：~/.cursor/mcp.jsonに次を設定します。 {"mcpServers": {"clipwright": {"url": "https://mcp.clipwright.io/mcp"}}}。
• **VS Code：**ワークスペースのルートにある.mcp.jsonに次を設定します。 {"mcpServers": {"clipwright": {"type": "http", "url": "https://mcp.clipwright.io/mcp"}}}。
• Gemini CLI：gemini mcp add --transport http clipwright https://mcp.clipwright.io/mcpを実行し、その後/mcp auth clipwrightを実行します。
• Codex：codex mcp add clipwright --url https://mcp.clipwright.io/mcpを実行し、その後codex mcp login clipwrightを実行します。

承認ページには、アプリが要求する権限が表示されます。権限は2つあります。

• mcp:read — 読み取り専用のツール：アカウント、実行、ショット、音声、アクター、ワークフロー、引用句。
• mcp:write — そのほかすべてのツール。一部は有料実行を開始してクレジットを消費し、残りはアカウントを変更します（アクター、アップロード、ワークフロー計画）。

mcp:writeのない接続では、これらのツールから403 insufficient_scopeが返され、料金は発生しません。承認できるのは、アクセスが許可されたアカウントのみです。

アプリの接続を解除するには、app.clipwright.io/api-keysを開き、Connected appsからアプリを探して取り消します。次回のリクエストでは401が返されます。接続の有効期間は承認から90日間です。その後、アプリから再度サインインするよう求められます。

ホステッドサーバーのupload_imageでは、お使いのマシン上のファイルを読み込めません。公開https URLをupload_image({url})に渡すと、サーバーがダウンロードします。または、create_uploadを呼び出し、返されたput_urlにcurlでファイルをPUTします。どちらの方法でも、first_frame、last_frame、referencesに使うupload_idを取得できます。

ブラウザーを使わないエージェントは、デバイスコードとファーストパーティクライアントclipwright-agentを使ってサインインします（2026-10-18に実機で検証済み）。

curl -s https://mcp.clipwright.io/device/auth -d client_id=clipwright-agent \
  --data-urlencode "scope=mcp:read mcp:write offline_access" \
  --data-urlencode "resource=https://mcp.clipwright.io/mcp"

任意のデバイスでverification_uri（https://mcp.clipwright.io/device）を開き、user_codeを入力してサインインし、承認します。承認ページにもコードが再表示されます。その間、grant_type=urn:ietf:params:oauth:grant-type:device_code、device_code、client_id=clipwright-agentを指定して、POST https://mcp.clipwright.io/tokenをポーリングします。ポーリングは5秒に1回を超えないようにしてください。それより速くポーリングするとslow_downが返されます。access_tokenをAuthorization: Bearerとして/mcpに送信します。有効期間は1時間です。grant_type=refresh_tokenで更新し、更新のたびに最新のリフレッシュトークンを保持してください。デバイスフローを利用できるのは、このクライアントのみです。

cw_*キーを使うホステッドサーバー

CIやスクリプトでは、サインインの代わりにキーを送信します。キーには両方の権限が含まれます。

claude mcp add --transport http clipwright https://mcp.clipwright.io/mcp --header "Authorization: Bearer cw_..."

n8n

n8n に組み込まれている MCP Client ノードは、ノードごとに 1 つのツールを呼び出します。

• Server Transport: HTTP Streamable；MCP Endpoint URL: https://mcp.clipwright.io/mcp。
• Authentication: Bearer Auth を使用し、トークンに cw_... キーを設定した認証情報を指定します。
• Tool: quote_ugc など、リストから選択します；Input Mode: JSON。

2026-10-20 にセルフホスト可能な n8n 2.43.8 でライブ検証済みです。get_account、 quote_ugc、get_run はノード経由で結果を返しました。インポート用のワークフロー seocombat/clipwright-mcp の n8n/clipwright-ugc.json は、スクリプトの見積もりを取得し、見積もりが max_credits を超えると停止し、make_ugc を開始して、 15 秒ごとに get_run をポーリングします。ワークフロー全体は 2026-10-20 に n8n Cloud 上で実行され、約 3 分で 1080×1920 の MP4 が返されました。n8n の OAuth 認証情報は、まだ Clipwright に対して実行していません。

stdio 経由のローカルサーバー

claude mcp add clipwright -e CLIPWRIGHT_API_KEY=cw_... -- npx -y -p @clipwright/mcp-server clipwright-mcp

cw_... の部分を自分のキーに置き換えてください。このコマンドは 1 行で、シェルによる展開がないため、bash、zsh、PowerShell のいずれでも同じように実行できます。Node.js 20 以降が必要です。

どの MCP ホストでも使用できます。ローカルサーバーは stdio 経由で JSON-RPC を使用します。app.clipwright.io/api-keys でキーを発行してください。

環境変数

これらの変数でローカルサーバーを設定します。

変数	必須	意味
CLIPWRIGHT_API_KEY	はい	cw_* トークンです。設定されていない場合、プロセスは直ちに終了します。
CLIPWRIGHT_CLIENT_ID	推奨	このインストールを識別し、冪等性キーに組み込まれるため、2 つのインストールが 1 つの実行にまとめられることはありません。未設定の場合、サーバーは ~/.clipwright/client-id に値を 1 つ保持します。これはノート PC を 1 台だけ使う場合に適しています。ホームディレクトリを共有、複製、または読み取り専用で使う環境（コンテナー、CI、コピーしたイメージなど）では、SKILL.md §2 の説明に従って自分で設定してください。
CLIPWRIGHT_API_URL	いいえ	ホスト型 API がデフォルトです。

レシピ

各レシピには、このサーバーに接続したエージェントに与えたプロンプト、エージェントが送信した呼び出し、動画の費用を記載しています。動画は clipwright.io/mcp で再生できます。

1. 画面上のグラフィックを使ったクリエイター動画

カメラの前に登場するプレゼンターは1人。その発言に反応するグラフィックを重ねます。商品を売り込むトーキングヘッド形式のリール動画です。プロンプトは1つ、編集者は不要です。

アクター ID、スクリーンショットのリンク、サイト名を添えて、プロンプトをそのまま渡しました。

私のAI受付担当者を紹介する30秒の縦型リール動画を、私のプレゼンターアクターと音声「Hope」を使って作成してください。台本：「電話に出られないたびに、商談を1件失います。受付担当者は眠り、休憩を取り、ときにはイライラします。この受付担当者は違います。一日中電話に対応し、24時間休みなく働き、イライラすることもありません。実例をご紹介します。午前2時にお客様からクリーニングの予約電話があり、時間、料金、確認メッセージまで、すべて対応します。小規模事業者は電話の3分の1を取り逃しています。もうその心配はありません。10分で設定して、眠っている間に商談を逃すのをやめましょう。」

彼女が機能を列挙する間、3つのスイッチ（「電話に対応」と「24時間対応」はオフ、「イライラする」はオン）があるチェックリストを表示し、彼女の発言に合わせてカーソルで各スイッチを切り替えてください。午前2時のお客様の話になったら、右側に +1 (305) 555-0147 からの着信を表示し、「対応します」のところで電話に出てください。「小規模事業者は電話の3分の1を取り逃しています」と話す間、私のダッシュボードのスクリーンショットを右上に表示してください。最後は、私のサイトと「アシスタントを作成」という文言を載せたカードで締めくくってください。重要なフレーズだけをハイライトスタイルで字幕にし、「もうその心配はありません。」のところは少しズームインしてください。レンダリングする前に見積もりを出してください。

エージェントが送ったのは、templates（チェックリスト、電話、エンドカード）、1つのoverlays画像、caption_mode: "highlights"、caption_style: "highlighter"、そして強調する1行へのpunch_inを指定したmake_ugcの見積もり1件です。クリック音、スイッチ音、着信音は、デフォルトでテンプレートに含まれています。2026-10-24に、このサーバーで新しいエージェントを使ってプロンプトを確認しました。動画は同じ呼び出しからレンダリングされました。

料金：33秒で400クレジットです。見積もりには、クレジットを消費する前に料金が記載されていました。動画を見る。

ツール

• list_workflows — ワークフローのメソッドと現在の利用可否を確認します。無料です。
• get_workflow — 1 つのメソッドに必要な入力、スクリプトのルール、証拠、制限事項を確認します。無料です。
• prepare_workflow_plan — 完全なドキュメントを使ってプランを作成するか、plan_id と base_version の両方を指定して保存します。無料です。実行は開始しません。
• get_workflow_plan — 現在の所有プラン、リビジョン、準備状況を確認します。無料です。
• approve_workflow_plan — 選択したリビジョンとコンテンツダイジェストを明示的に承認します。無料です。実行は開始しません。
• quote_workflow_plan — クレジットを消費せずに、承認済みリビジョンの見積もりを取得します。
• run_workflow_plan — 正確な見積もりフィールドと明示的な冪等性キーを使用して、有料ワークフローを開始します。レシートと実行 ID をすぐに返します。get_run をポーリングしてください。不確かな購入は、元のリクエストとキーを使って復旧できます。
• list_voices — voice で使用する音声です。プリセット、音声モデル gemini-3.8-flash-tts の 30 種類の音声、make_ugc のカタログが含まれます。言語、性別、年齢、ユースケース、モデルで絞り込めます。また、音声にサンプルがある場合は短い音声サンプルも確認できます。 make_faceless のナレーション音声 17 種類は、skill: "make_faceless" を指定して表示します。無料で、クレジットを消費しません。
• list_template_sounds — make_ugc のテンプレートが再生するサウンドをビートごとに表示します。各ビートの再生位置、デフォルト値、template_sounds が受け付けるすべての名前を確認できます。無料です。
• list_actors — 安定した ID と検証済み形式を持つ既製の顔を表示します。無料です。
• quote_ugc — 推定時間と料金を表示します。また、同じ入力で make_ugc を実行した場合に、料金またはアクセス上の理由で拒否されるときは警告します。無料です。
• get_account — アカウントの残高、債務、保留額を確認します。無料です。
• make_ugc — **クリップをレンダリングします。料金が発生する呼び出しです。**レンダリングには数分かかるため、処理をブロックせずに run_id をすぐに返します。
• get_run — 実行のステータスを確認します。無料です。数秒ごとにポーリングしてください。
• get_run_shots — 完成した動画のショットを表示します。各ショットの範囲、種類、説明、プレビューリンクに加えて、ナレーションの語句とそのタイミングを確認できます。無料で、読み取り専用です。表示できるショットがない実行では、その理由が返されます。
• quote_revision — フェイスレス動画のリビジョンの料金を表示します。変更内容と費用を確認できます。無料です。
• revise_run — リビジョンを開始します。変更したショットで動画を再レンダリングする新しい実行で、料金が発生します。changes（ショットと、そのショットで生成する内容）または編集済みのドキュメント全体を渡します。正常に納品されたリビジョンには見積もり総額が請求されます。失敗した場合は、有料作業がすでに完了していても請求されません。同一のリクエストには同じ実行が返されます。意図的に 2 回目の実行を開始するには attempt を指定します。run_id をすぐに返します。succeeded になるまで get_run をポーリングしてください。
• quote_candidate — フェイスレス動画のショット候補の料金を表示します。リビジョンで採用または破棄する、1 つのショット用に生成した画像またはクリップです。無料です。
• create_candidate — **ショット候補を作成します。料金が発生します。**ショットと、そのショット用に生成する操作を渡します。候補が納品されると、採用するか破棄するかにかかわらず、1 単位分が請求されます。失敗した場合は、有料作業がすでに完了していても請求されません。同一のリクエストには同じ実行が返されます。意図的に別の候補を作成するには take を指定します。run_id をすぐに返します。succeeded になるまで get_run をポーリングしてください。
• list_generation_models — 単体生成で使えるモデルと、測定済みの形状、画像 1 枚または 1 秒あたりのクレジットを表示します。無料です。
• quote_image、quote_video — 画像 1 枚またはクリップ 1 本の料金を表示します。無料です。
• generate_image、generate_video — **画像 1 枚または無音クリップ 1 本を生成します。料金が発生します。**失敗した場合は、ベンダーへの支払いがすでに済んでいても請求されません。同一のリクエストには同じ実行が返されます。意図的に別の実行を開始するには attempt を指定します。get_run をポーリングしてください。generation.url がファイルです。
• upload_image — ローカルの path または公開 HTTPS url から PNG/JPEG をアップロードし、upload_id と、image として渡す署名付き HTTPS URL を取得します。無料です。1 日 20 回まで、URL からのダウンロードは 1 時間あたり最大 30 回までです。URL は 24 時間有効です。その後、aspect_ratio を明示的に設定してください。
• create_upload — サーバーがリモートの場合に、ローカルの PNG/JPEG 用の署名付き PUT URL を作成します。curl でファイルを PUT してから、upload_id を使用してください。無料です。
• get_upload — 1 件のアップロードについて、新しい URL、サイズ、usable_until を確認します。create_upload の後に、PUT が完了したことも確認できます。無料です。
• create_asset — 画像または MP4 クリップをアカウントのアセットとして保存します。削除するまで保持されます。run_id、upload_id、公開 url（kind: "video" を指定したクリップ）、base64、署名付き put、または stdio でのローカル path から作成できます。クリップはバックグラウンドでチェックされ、準備ができると get_asset で確認できます。自分の素材を使うには、rights_confirmed: true を 1 回指定する必要があります。無料です。アカウントごとにアセット 2000 件、20 GB、1 日あたり新規 100 件までです。
• list_assets、get_asset — アカウントのアセットを新しい URL と上限の使用状況とともに表示します。無料です。
• update_asset — アセットの名前または役割を変更します。無料です。
• delete_asset — アセットを削除します。7 日経過すると、毎日のクリーンアップでファイルも削除されます。無料です。
• quote_actor — パーソナルアクターを作成する前に、料金を確認します。無料です。
• create_actor — **説明からパーソナルアクターを作成します。料金が発生します。**リクエストした形式ごとに、画像 1 枚分の料金が発生します。run_id をすぐに返します。succeeded になるまで get_run をポーリングし、その後 created_actor.actor_id を actor_id として make_ugc に渡してください。
• quote_faceless — フェイスレス動画の作成前に、料金を確認します。無料です。
• make_faceless — **スクリプトまたは短い概要からフェイスレス動画を作成します。料金が発生します。**長さは 30～90 秒から選択できます。動画は選択した長さの 25 秒前から 15 秒後までのナレーションに合わせて終了し、料金は見積もり以下です。ナレーションは冒頭のアニメーションクリップと画像シーンに重ねて再生されます。字幕はデフォルトでオンです。ナレーションの音声は voice で名前を指定して選びます。run_id をすぐに返します。succeeded になるまで get_run をポーリングしてください。
• delete_actor — このアカウントのパーソナルアクターを削除します。そのアクターを使ってすでに作成した動画には影響しません。無料です。
• get_actor_defaults、set_actor_defaults — アクターの B-roll のデフォルト設定を確認、保存します。設定は保存されますが、今日のトーキングアクター動画では使用されません。無料です。 make_ugc を呼び出す前に quote_ugc を呼び出してください。見積もりでは、契約上対応できる内容と対応できない内容を確認できます。API で対応できない内容は、黙って破棄されるのではなく warnings[] で返されます。また、サポートされていないフィールドは、受け入れて無視されるのではなく、事前に拒否されます。

attempt フィールドを増やすと、新たに料金が発生するレンダリングが開始されます。意図的に失敗した実行を再試行するためのものであり、無料で再読み込みするためのものではありません。顔出しなしの動画では、attempt は make_faceless に指定します。見積もりには指定せず、quote_faceless はこれを拒否します。

完全な操作手順を記載した SKILL.md はパッケージに含まれています。その隣にある CHANGELOG.md には、各リリースでの変更点と削除された内容が記載されています。

プライバシー

サーバーは、スクリプトまたは概要、選択したオプション、アップロードした画像を Clipwright API に送信し、動画の見積もりとレンダリングを行います。データの取り扱いについては、こちらをご覧ください： clipwright.io/privacy。ドキュメント： clipwright.io/docs。