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)

Für bezahlte Konten (Guthaben für alle)

Wie die API steht auch der MCP-Server Konten zur Verfügung, die Credits gekauft oder ein Abo abgeschlossen haben. Clients verbinden sich über die Anmeldung mit deinem VideoUpscaler-Konto oder mit einem API-Schlüssel. Jedes Konto kann sich anmelden und mit get_account sein Guthaben abfragen; die übrigen Tools erfordern ein bezahltes Konto.

Client verbinden

Die meisten Clients verbinden sich per Anmeldung: Du fügst die Server-URL hinzu, ein Browserfenster öffnet sich, du meldest dich bei VideoUpscaler an und klickst auf Erlauben. Clients, die keine Anmeldung unterstützen, nutzen einen API-Schlüssel: Erstelle ihn 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.

Öffne in claude.ai oder der Claude-Desktop-App Settings → Connectors, klicke auf Add custom connector und gib https://videoupscaler.co/api/mcp ein. Klicke auf Connect, melde dich an und erlaube den Zugriff.

claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope user

Führe in Claude Code /mcp aus, wähle videoupscaler und dann Authenticate, um dich im Browser anzumelden. Mit --scope user ist der Server in all deinen Projekten verfügbar.

Um stattdessen einen API-Schlüssel zu verwenden, ergänze den Befehl um --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY".

Cursor verbindet sich mit einem API-Schlüssel. Füge Folgendes zu ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein 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. Beim ersten Start des Servers fordert VS Code dich zur Anmeldung auf:

{
  "servers": {
    "videoupscaler": {
      "type": "http",
      "url": "https://videoupscaler.co/api/mcp"
    }
  }
}

Jeder Client, der Remote-MCP-Server über Streamable HTTP unterstützt, funktioniert. Gib die URL https://videoupscaler.co/api/mcp ein: Clients mit MCP-Autorisierung fordern dich automatisch zur Anmeldung auf. Andere Clients senden den Header Authorization: Bearer <dein API-Schlüssel>.

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.mp4 auf 2K hoch.“ (Clients, die Befehle ausführen können, laden die Datei zuerst mit create_upload hoch)

Fehlerbehebung

Problem	Lösung
Der Client zeigt `401` an oder fordert dich zur Anmeldung auf	Melde dich im Client erneut an. Bei einem API-Schlüssel prüfe den `Authorization`-Header und ob der Schlüssel in den Einstellungen noch existiert.
Die Anmeldeseite meldet einen ungültigen Autorisierungslink	Der Link läuft nach 10 Minuten ab. Starte die Verbindung in deinem Client neu.
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.

MCP-Server für Video-Upscaling

Client verbinden

Tools

Beispiel-Prompts

Fehlerbehebung

On this page