MCP-Server für KI-Videogenerierung

Was ist der VidFlux Video-MCP-Server?

Das Model Context Protocol (MCP) ist der offene Standard, über den KI-Assistenten externe Tools aufrufen. VidFlux MCP ist ein gehosteter Endpunkt, der Ihrem Assistenten Werkzeuge zur Videoerstellung gibt: Text-zu-Video-, Bild-zu-Video- oder Motion-Control-Jobs starten, den Fortschritt prüfen und das fertige MP4 abrufen. Der Assistent schreibt den Prompt, wählt Modell, Länge und Seitenverhältnis, wartet auf das Rendering und übergibt Ihnen die Datei, ohne dass Sie Chat oder Editor verlassen.

Hinter dem Endpunkt läuft dieselbe Pipeline wie im Videogenerator auf vidflux.ai. Modellversionen, Preise und Erstattungen sind identisch, und jeder Auftrag erscheint auch in Ihrem Kontoverlauf.

Unterstützte KI-Videomodelle

Übergeben Sie die Modell-ID im Argument model. Die Credits gelten für die Standardeinstellungen; längere Videos, höhere Auflösungen oder Ton kosten mehr. dry_run liefert den exakten Preis für beliebige Einstellungen.

Bildmodelle für Keyframes und Thumbnails

Erstellen oder bearbeiten Sie Startbilder, Produktfotos und Thumbnails und animieren Sie sie anschließend mit einem der Bild-zu-Video-Modelle oben.

Schnellstart: in 3 Schritten verbunden

1. Melden Sie sich bei VidFlux an und erstellen Sie unter Einstellungen → API & MCP einen Schlüssel. Neue Konten erhalten kostenlose Test-Credits.
2. Fügen Sie den Server mit einer der Konfigurationen unten zu Ihrem KI-Client hinzu.
3. Bitten Sie um ein Video, zum Beispiel: „Erstelle mit Seedance 2 ein 5-sekündiges 9:16-Video, in dem Latte Art in Zeitlupe gegossen wird, und speichere es in ./assets“.

Konfiguration der MCP-Clients

Ersetzen Sie vf_your_api_key durch Ihren Schlüssel. Bei Clients, die Umgebungsvariablen lesen, speichern Sie den Schlüssel besser in VIDFLUX_API_KEY statt in der Konfigurationsdatei.

Claude Code

claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \
  --header "Authorization: Bearer vf_your_api_key"

# verify
claude mcp list

Claude Desktop

Claude Desktop verbindet sich mit Remote-Servern per API-Schlüssel über mcp-remote (Node.js erforderlich). Bearbeiten Sie claude_desktop_config.json und starten Sie Claude neu:

{
  "mcpServers": {
    "vidflux": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vidflux.ai/api/mcp",
        "--header", "Authorization: Bearer vf_your_api_key"
      ]
    }
  }
}

Cursor

In ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) eintragen:

{
  "mcpServers": {
    "vidflux": {
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

OpenAI Codex CLI

export VIDFLUX_API_KEY=vf_your_api_key
codex mcp add vidflux --url https://vidflux.ai/api/mcp \
  --bearer-token-env-var VIDFLUX_API_KEY

VS Code (GitHub Copilot agent mode)

In .vscode/mcp.json eintragen:

{
  "servers": {
    "vidflux": {
      "type": "http",
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Windsurf

In ~/.codeium/windsurf/mcp_config.json eintragen:

{
  "mcpServers": {
    "vidflux": {
      "serverUrl": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Cline, Roo Code und weitere Clients

Jeder Client, der Streamable-HTTP-Server mit eigenen Headern unterstützt, funktioniert mit derselben URL und demselben Header. Clients, die nur stdio unterstützen, nutzen den mcp-remote-Befehl aus der Claude-Desktop-Konfiguration.

MCP-Tools

Die Videoerstellung läuft asynchron. Ein typischer Ablauf sieht so aus:

list_models            → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
                duration: 5, dry_run: true}
                       → {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
                       → {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."}   (every 15 s)
                       → {"status": "completed", "video_url": "https://...mp4"}

Preise: Abrechnung nach Verbrauch

• Die Verbindung zum Server sowie list_models, get_task und get_credits sind kostenlos.
• Jedes Video kostet dieselben Credits wie auf vidflux.ai (siehe Tabellen oben). Credit-Pakete beginnen bei 500 Credits für 4,98 $, größere Pakete sind pro Credit günstiger, und gekaufte Credits verfallen nicht.
• Mit dry_run: true werden nur die Argumente geprüft; Sie erhalten den exakten Preis und ob Ihr Guthaben reicht, ohne dass etwas generiert wird.
• Fehlgeschlagene oder abgelehnte Aufträge werden automatisch erstattet.

Credit-Pakete und Tarife ansehen

Wofür Sie es einsetzen können

VidFlux MCP vs. Anbieter-APIs vs. selbst gehostete MCP-Server

Fehlerbehebung

Server ist verbunden, aber keine Video-Tools sichtbar

Starten Sie den Client neu oder laden Sie die MCP-Server neu und prüfen Sie, ob der Agent-Modus aktiv ist (Cursor, VS Code). In Claude Code zeigt /mcp die Tool-Liste.

401 Unauthorized oder „Missing or invalid API key“

Der Header muss genau Authorization: Bearer vf_… lauten. Prüfen Sie, ob der Schlüssel widerrufen wurde und ob beim Kopieren Anführungszeichen oder Leerzeichen hinzugekommen sind.

402 INSUFFICIENT_CREDITS

Ihr Guthaben ist niedriger als der von dry_run gemeldete Preis. Laden Sie Credits auf oder wählen Sie ein kürzeres, niedriger aufgelöstes oder günstigeres Modell.

Ein Video bleibt lange auf processing

Die meisten Videos sind in 1 bis 5 Minuten fertig; lange Seedance-2.5- oder 4K-Gemini-Omni-Jobs dauern länger. Fragen Sie weiter mit get_task ab. Schlägt ein Auftrag fehl, wird der Fehler gemeldet und die Credits werden erstattet.

spawn npx ENOENT in Claude Desktop

mcp-remote benötigt Node.js 18 oder neuer. Installieren Sie Node.js oder tragen Sie den vollständigen Pfad zu npx im Feld command ein.

Referenzbilder werden abgelehnt

image_urls müssen öffentliche HTTPS-Links zu JPG-, PNG- oder WebP-Dateien sein. Lokale Dateipfade und Links hinter einem Login können nicht geladen werden.

Häufige Fragen