MCP-Server für Video-Upscaling
Verbinde den MCP-Server von VideoUpscaler mit Claude Code, Cursor oder VS Code und lass deinen KI-Assistenten Videos auf 1080p, 2K oder 4K hochskalieren.
VideoUpscaler betreibt einen Remote-MCP-Server für Video-Upscaling auf Basis des Model Context Protocol. Verbinde ihn mit deinem KI-Assistenten und sag zum Beispiel „Skaliere dieses Video auf 4K hoch“ – der Assistent ruft dieselbe API auf, die in dieser Dokumentation beschrieben ist, und verbraucht deine Credits.
Server-URL: https://videoupscaler.co/api/mcp (Streamable HTTP)
Nur für bezahlte Konten
Wie die API steht auch der MCP-Server Konten zur Verfügung, die Credits gekauft oder ein Abo abgeschlossen haben. Du brauchst einen API-Schlüssel.
Client verbinden
Erstelle einen API-Schlüssel unter Einstellungen → API-Schlüssel und lege ihn in einer Umgebungsvariable ab, zum Beispiel VIDEOUPSCALER_API_KEY. Füge den Schlüssel nicht in eine Konfigurationsdatei ein, die du committest.
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
--header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
--scope userMit --scope user steht der Server in all deinen Projekten zur Verfügung, und der Schlüssel landet nicht in der .mcp.json des Projekts. Führe in Claude Code /mcp aus, um die Verbindung zu prüfen.
Füge Folgendes zu ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein einzelnes Projekt) hinzu:
{
"mcpServers": {
"videoupscaler": {
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
}
}
}
}Füge Folgendes zu .vscode/mcp.json hinzu. VS Code fragt beim ersten Mal nach dem Schlüssel und speichert ihn sicher:
{
"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}"
}
}
}
}Jeder Client, der Remote-MCP-Server über Streamable HTTP unterstützt, funktioniert. Konfiguriere:
- URL:
https://videoupscaler.co/api/mcp - Header:
Authorization: Bearer <your API key>
Die Anmeldung per OAuth (für Claude Desktop und claude.ai-Connectors) folgt in Kürze.
Tools
| Tool | Funktion |
|---|---|
upscale_video | Startet das Upscaling einer öffentlichen video_url auf 1080p, 2k oder 4k und bucht Credits ab. Erfordert einen idempotency_key. |
get_task | Gibt einen Task zurück. Mit wait_seconds (bis zu 45) wartet es zuerst, bis der Task fertig ist. |
list_tasks | Listet deine letzten Tasks auf, auch solche, die auf der Website gestartet wurden. |
get_account | Dein Credit-Guthaben und der Preis pro Sekunde für jede Auflösung. |
create_upload | Gibt eine signierte URL zum Hochladen einer lokalen Datei (bis zu 100 MB) zurück, die keine öffentliche URL hat. |
Die Tools verhalten sich genau wie die entsprechenden API-Endpunkte: siehe Upscaling erstellen, Tasks, Credits & Preise und Datei hochladen. Über MCP gestartete Tasks kosten dieselben Credits.
Jeder Aufruf von upscale_video braucht einen idempotency_key. Wenn ein Aufruf in ein Timeout läuft, sollte der Assistent list_tasks prüfen und es mit demselben Schlüssel erneut versuchen – so wird das Video nie doppelt berechnet.
Beispiel-Prompts
- „Wie viele VideoUpscaler-Credits habe ich noch?“
- „Skaliere https://example.com/clip.mp4 auf 4K hoch und gib mir den Link, wenn es fertig ist.“
- „Skaliere
./intro.mp4auf 2K hoch.“ (Clients, die Befehle ausführen können, laden die Datei zuerst mitcreate_uploadhoch)
Fehlerbehebung
| Problem | Lösung |
|---|---|
Der Client zeigt 401 an oder fordert dich zur Anmeldung auf | Der API-Schlüssel fehlt oder ist falsch. Prüfe den Authorization-Header und ob der Schlüssel in den Einstellungen noch existiert. |
Tools geben paid_plan_required zurück | Das Konto hat noch nie Credits gekauft. Kaufe ein beliebiges Credit-Paket. |
Tools geben insufficient_credits zurück | Lade dein Guthaben auf der Preisseite auf. |
upscale_video läuft in ein Timeout | Große Remote-Videos brauchen eine Weile zum Herunterladen. Bitte den Assistenten, list_tasks zu prüfen; der Task existiert in der Regel bereits. |