CutPro MCP

CutPro MCP

AI 画像、動画、ペルソナ、クリップ向けの Model Context Protocol（MCP）サーバーです。CutPro API の全機能をツールとして公開し、LLM で次のことができます。

• あらゆるトップモデルで画像や動画を生成：Veo、Kling、Seedance、Wan、MiniMax、Nano Banana、GPT Image、Seedream などを使い、プロンプトまたは参照画像から生成できます。各モデルの最新料金も確認できます。
• AI ペルソナを作成：写真や動画を通して一貫性を保つリアルな人物を作成し、シーン、カメラワーク、動き、音声を維持したまま、任意の動画に入れ替えられます。
• 長時間の動画やライブ配信をクリップ化：最適な場面を見つけ、完成版の MP4 をレンダリングします。
• 投稿と予約：クリップ、生成した動画、ペルソナ動画を、TikTok、Instagram、YouTube、Facebook、Threads、LinkedIn、Pinterest、Bluesky に今すぐ、または指定した時間に公開できます。
• 文字起こし：あらゆる音声や動画を、タイムコード付きの字幕（SRT、VTT、テキスト、JSON）に変換します。

主な機能

• 常に同期。v1 のすべてのエンドポイントを、最新の API 仕様から生成したツールとして利用できます。画像と動画の生成、ペルソナ、ワークスペース、残高、動画とアップロード、クリッピング、クリップ、チャンネルとライブ配信のモニタリング、テンプレート、レンダリング、文字起こし、投稿、接続に対応しています。
• どこでも実行可能。ローカルクライアント（Claude Code、Cursor、Claude Desktop、Windsurf、VS Code、Cline、Zed）向けの stdio と、ChatGPT および Claude.ai 向けの OAuth 対応ホスト型 Streamable HTTP エンドポイントを利用できます。
• 最新のプロトコルに対応。2026-07-28（ステートレス、server/discover、キャッシュ可能なリスト、複数回のラウンドトリップ要求）およびそれ以前のすべてのリビジョンに、同じエンドポイントで対応しています。
• 結果を確認可能。MCP Apps に対応したクライアントでは、生成された画像や動画、ペルソナ、クリップ、レンダリング結果をインラインプレーヤーで表示できます。ジョブが完了するまで追跡し、CutPro で開く、画像をアニメーション化する、投稿を予約するためのボタンも表示されます。
• 料金が発生する前に確認。エリシテーションに対応したクライアントでは、クレジットを消費するすべての呼び出しで料金を表示し、請求が発生する前にユーザーの確認を待ちます。

はじめに

必要条件

• Node.js 18 以降。
• CutPro アカウント（プランは問いません）と API キー。cut.pro/studio/me/api-keys で生成してください。
• MCP 対応クライアント。

標準設定

ほとんどのクライアントで同じ JSON を使用します。API キーを env に追加してください。

{
	"mcpServers": {
		"cutpro": {
			"command": "npx",
			"args": ["-y", "@cutpro/mcp@latest"],
			"env": { "CUTPRO_API_KEY": "<your-api-key>" }
		}
	}
}

インストール

ボタンからインストールした後、サーバーの env に CUTPRO_API_KEY を追加してください。

claude mcp add cutpro --env CUTPRO_API_KEY=<your-api-key> -- npx -y @cutpro/mcp@latest

{
	"mcpServers": {
		"cutpro": {
			"command": "npx",
			"args": ["-y", "@cutpro/mcp@latest"],
			"env": { "CUTPRO_API_KEY": "<your-api-key>" }
		}
	}
}

gemini mcp add cutpro npx -y @cutpro/mcp@latest -e CUTPRO_API_KEY=<your-api-key>

[mcp_servers.cutpro]
command = "npx"
args = ["-y", "@cutpro/mcp@latest"]
env = { "CUTPRO_API_KEY" = "<your-api-key>" }

https://mcp.cut.pro

claude plugin marketplace add getcutpro/mcp
claude plugin install cutpro@cutpro

更新

インストールしたものはそれぞれ自動で最新の状態に保たれます。

• ホスト型（https://mcp.cut.pro、Claude プラグイン、ChatGPT アプリ）：常に最新リリースが適用されるため、何もする必要はありません。
• ローカル（npx -y @cutpro/mcp@latest）：起動時にサーバーが npm を確認し、新しいリリースがあれば、そのリリースにセッションを引き継ぎます。バージョンを固定している場合や、npx のキャッシュが古い場合でも動作します。インストール済みのバージョンを使い続けるには、CUTPRO_MCP_AUTO_UPDATE=0 を設定してください。その場合、サーバーはモデルに更新が利用可能であることを通知します。
• ツール：新しい API エンドポイントは、リリースを待たずに 10 分以内にツールとして表示されます。

各リリースの説明は、Releases と CHANGELOG.md に掲載されています。

設定

サーバーは環境変数で設定します。

MCP_TRANSPORT=http PORT=8787 MCP_OAUTH=1 \
MCP_PUBLIC_URL=https://mcp.cut.pro MCP_REDIS_URL=redis://127.0.0.1:6379 \
npx -y @cutpro/mcp@latest

ツール

ツールは API 自身の OpenAPI 仕様（/api/v1/openapi.json）から生成されるため、常にAPI リファレンスと一致します。各エンドポイントに 1 つのツールが対応し、operationId をスネークケースにした名前（analyzeVideo は analyze_video、createSubmission は create_submission）が付けられます。また、各エンドポイント固有のパラメーター、説明、レスポンスを備えています。新しいエンドポイントが API に追加されると、このパッケージの新しいリリースなしで 10 分以内にツールとして利用できるようになります。

一般的なワークフロー：

• 画像または動画：list_generation_models、合意した価格で create_generation を実行し、準備が整うまで get_generation を呼び出します。準備が整った画像の output.image_id を渡すと、アニメーション化できます。
• ペルソナ：get_persona_catalog、create_persona を実行し、写真の準備が整うまで get_persona を呼び出します。続いて save_persona を実行し、その後 quote_persona_swap と create_persona_video を使って動画に追加します。
• クリップ：analyze_video、create_submission を実行し、処理が完了するまで get_submission を呼び出します。続いて list_clips、render_clip、get_render、download_render を使います。

アノテーションも仕様から取得します。GET は読み取り専用、PUT、PATCH、DELETE は破壊的な操作です。また、ルートの x-mcp 拡張には、追加の情報（クレジットの消費、ソーシャルネットワークへの公開、任意の公開 URL へのアクセス）が記載されています。ディスクからアップロードするファイルが必要なルートは、ローカル（stdio）サーバーにのみ表示されます。チャットクライアントはバイトデータを送信できないためです。

すべてのツール

ライブ API 仕様とサーバーから生成された 90 個のツールと 5 個のプロンプト。

プロンプト

クライアントがショートカットとして提供する、すぐに使えるリクエストです（Claude の / メニュー）。

ワークスペース

残高

動画

提出

クリップ

レンダリング

接続

モニタリング

投稿

テンプレート

文字起こし

ペルソナ

生成

リンク

• ドキュメント：cut.pro/docs/api-reference/mcp
• npm：@cutpro/mcp
• MCP Registry：io.github.getcutpro/cutpro
• リリース：github.com/getcutpro/mcp/releases · CHANGELOG.md
• コントリビューション：CONTRIBUTING.md · セキュリティ：SECURITY.md · 行動規範

ライセンス

MIT