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。不要把 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 user在 Claude Code 中執行 /mcp，選擇 videoupscaler 並選擇 Authenticate，在瀏覽器中完成登入。--scope user 讓這個伺服器在你的所有專案中都可使用。
若要改用 API 金鑰，請在指令中加上 --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY"。
Cursor 透過 API 金鑰連接。加入 ~/.cursor/mcp.json（所有專案）或 .cursor/mcp.json（單一專案）：
{
"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 | 列出你最近的任務，包括在網站上建立的任務。 |
get_account | 你的點數餘額，以及各解析度每秒的價格。 |
create_upload | 回傳簽章 URL，用來上傳沒有公開 URL 的本機檔案（最大 100MB）。 |
這些工具的行為與對應的 API 端點完全相同：請參閱建立畫質提升任務、任務、點數與價格與上傳檔案。透過 MCP 建立的任務，扣除的點數也完全相同。
每次呼叫 upscale_video 都需要 idempotency_key。如果呼叫逾時，助理應先查看 list_tasks，再用相同的 Key 重試，這樣同一支影片絕不會被重複扣點。
提示範例
- 「我的 VideoUpscaler 點數還剩多少？」
- 「把 https://example.com/clip.mp4 提升到 4K，完成後給我連結。」
- 「把
./intro.mp4提升到 2K。」（能執行指令的用戶端會先用create_upload上傳檔案）
疑難排解
| 問題 | 解決方式 |
|---|---|
用戶端顯示 401 或要求你登入 | 在用戶端中重新登入。若使用 API 金鑰，請檢查 Authorization 標頭，並確認該 Key 仍存在於「設定」中。 |
| 登入頁顯示授權連結無效 | 連結會在 10 分鐘後失效。請在用戶端中重新連接。 |
工具回傳 paid_plan_required | 此帳號從未購買過點數。購買任一點數方案即可。 |
工具回傳 insufficient_credits | 請到價格頁面儲值。 |
upscale_video 逾時 | 較大的遠端影片需要一些時間下載。請助理查看 list_tasks，任務通常已經建立。 |