MCP サーバー：動画アップスケール
VideoUpscaler の MCP サーバーを Claude Code、Cursor、VS Code に接続すれば、AI アシスタントに頼むだけで動画を 1080p・2K・4K にアップスケールできます。
VideoUpscaler は Model Context Protocol に対応した、動画アップスケール用のリモート MCP サーバーを提供しています。AI アシスタントに接続すれば、「この動画を 4K にアップスケールして」のように頼むだけで、アシスタントがこのドキュメントで説明している API を呼び出し、あなたのクレジットを使用します。
サーバー URL: https://videoupscaler.co/api/mcp（Streamable HTTP）
有料アカウント専用
API と同様に、MCP サーバーはクレジットを購入したことがあるアカウント、またはサブスクリプションを契約しているアカウントで利用できます。APIキーが必要です。
クライアントを接続する
設定 → APIキー で APIキーを作成し、VIDEOUPSCALER_API_KEY などの環境変数に保存してください。コミットする設定ファイルにキーを直接貼り付けないでください。
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
--header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
--scope user--scope user を指定すると、すべてのプロジェクトでサーバーを利用でき、キーがプロジェクトの .mcp.json に含まれることもありません。接続を確認するには、Claude Code で /mcp を実行します。
~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加します。
{
"mcpServers": {
"videoupscaler": {
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
}
}
}
}.vscode/mcp.json に追加します。VS Code は初回にキーの入力を求め、安全に保存します。
{
"inputs": [
{
"type": "promptString",
"id": "videoupscaler-key",
"description": "VideoUpscaler API key",
"password": true
}
],
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${input:videoupscaler-key}"
}
}
}
}Streamable HTTP 経由のリモート MCP サーバーに対応したクライアントであれば、どれでも利用できます。次のように設定してください。
- URL:
https://videoupscaler.co/api/mcp - ヘッダー:
Authorization: Bearer <your API key>
OAuth によるサインイン（Claude デスクトップアプリと claude.ai のコネクタ向け）は近日対応予定です。
ツール
| ツール | 内容 |
|---|---|
upscale_video | 公開されている video_url を 1080p、2k、4k にアップスケールする処理を開始し、クレジットを差し引きます。idempotency_key が必要です。 |
get_task | タスクを返します。wait_seconds（最大 45）を指定すると、タスクの完了を待ってから返します。 |
list_tasks | 最近のタスクを一覧表示します。Web サイトで開始したタスクも含まれます。 |
get_account | クレジット残高と、解像度ごとの 1 秒あたりの料金を返します。 |
create_upload | 公開 URL のないローカルファイル（最大 100MB）をアップロードするための署名付き URL を返します。 |
各ツールは対応する API エンドポイントとまったく同じように動作します。詳しくはアップスケールを作成、タスク、クレジットと料金、ファイルをアップロードを参照してください。MCP 経由で開始したタスクにかかるクレジットも同じです。
upscale_video の呼び出しには毎回 idempotency_key が必要です。呼び出しがタイムアウトした場合、アシスタントは list_tasks を確認し、同じキーで再試行する必要があります。これにより、同じ動画に二重に課金されることはありません。
プロンプトの例
- 「VideoUpscaler のクレジットはあとどれくらい残っている？」
- 「https://example.com/clip.mp4 を 4K にアップスケールして、終わったらリンクを教えて。」
- 「
./intro.mp4を 2K にアップスケールして。」（コマンドを実行できるクライアントは、先にcreate_uploadでファイルをアップロードします）
トラブルシューティング
| 問題 | 対処法 |
|---|---|
クライアントに 401 が表示される、またはサインインを求められる | APIキーがないか、間違っています。Authorization ヘッダーと、キーが設定にまだ存在するかを確認してください。 |
ツールが paid_plan_required を返す | このアカウントはクレジットを購入したことがありません。いずれかのクレジットパックを購入してください。 |
ツールが insufficient_credits を返す | 料金ページで残高をチャージしてください。 |
upscale_video がタイムアウトする | サイズの大きいリモート動画はダウンロードに時間がかかります。アシスタントに list_tasks を確認するよう頼んでください。通常、タスクは作成されています。 |