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 サーバーはクレジットを購入したことがあるアカウント、またはサブスクリプションを契約しているアカウントで利用できます。クライアントは VideoUpscaler アカウントへのサインイン、または APIキー で接続します。どのアカウントでもサインインして get_account でクレジット残高を確認できます。その他のツールには有料アカウントが必要です。
クライアントを接続する
ほとんどのクライアントはサインインで接続します。サーバー URL を追加するとブラウザが開くので、VideoUpscaler にサインインして 許可 をクリックしてください。サインインできないクライアントは APIキーを使います。設定 → APIキー で作成し、VIDEOUPSCALER_API_KEY などの環境変数に保存してください。コミットする設定ファイルにキーを直接貼り付けないでください。
claude.ai または Claude デスクトップアプリで Settings → Connectors を開き、Add custom connector をクリックして https://videoupscaler.co/api/mcp を入力します。Connect をクリックし、サインインしてアクセスを許可してください。
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope userClaude Code で /mcp を実行し、videoupscaler を選んで Authenticate を選択すると、ブラウザでサインインできます。--scope user を付けると、すべてのプロジェクトでこのサーバーを使えます。
APIキーを使う場合は、コマンドに --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" を追加してください。
Cursor は APIキーで接続します。~/.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 がサインインを求めます:
{
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp"
}
}
}Streamable HTTP のリモート MCP サーバーに対応したクライアントなら利用できます。URL https://videoupscaler.co/api/mcp を入力すると、MCP の認可に対応したクライアントは自動でサインインを案内します。それ以外のクライアントは Authorization: Bearer <APIキー> ヘッダーを送信してください。
ツール
| ツール | 内容 |
|---|---|
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 ヘッダーと、キーが設定にまだ存在するかを確認してください。 |
| サインインページに「認可リンクが無効」と表示される | リンクの有効期限は 10 分です。クライアントから接続をやり直してください。 |
ツールが paid_plan_required を返す | このアカウントはクレジットを購入したことがありません。いずれかのクレジットパックを購入してください。 |
ツールが insufficient_credits を返す | 料金ページで残高をチャージしてください。 |
upscale_video がタイムアウトする | サイズの大きいリモート動画はダウンロードに時間がかかります。アシスタントに list_tasks を確認するよう頼んでください。通常、タスクは作成されています。 |