Doku

KwaFlux per MCP aus einem KI-Assistenten steuern

Der Installer von KwaFlux 1.0.8 bringt einen lokalen MCP-Server (Model Context Protocol) mit. Ein KI-Assistent auf demselben Computer kann den App-Status abfragen, Aufgaben einreihen und ihren Fortschritt verfolgen; die Medien verarbeitet KwaFlux weiterhin auf Ihrer eigenen GPU.

Aktualisiert am · KwaFlux 1.0.8

Voraussetzungen

  • KwaFlux 1.0.8 oder neuer ist auf demselben Computer installiert und geöffnet.
  • Node.js 18 oder neuer ist installiert und im PATH. Der Installer liefert das MCP-Skript, aber keine Node.js-Laufzeit.
  • Eine Assistenten-App mit MCP-Unterstützung: Codex, Claude Code oder Claude Desktop, OpenClaw, DeepSeek (DSH), Hermes oder Cursor.

Assistenten verbinden

  1. Öffnen Sie in KwaFlux Einstellungen → Agent (MCP).
  2. Kopieren Sie das Snippet für Ihren Assistenten in dessen MCP-Konfiguration. Ergänzen Sie nur den kwaflux-Eintrag, statt die ganze Datei zu ersetzen.
  3. Laden Sie MCP im Assistenten neu und lassen Sie KwaFlux während der Nutzung geöffnet.

Was der Assistent kann

  • App-Status und Aufgabenliste lesen, den Fortschritt einer Aufgabe verfolgen und auf ihr Ende warten.
  • Verbesserungs-Exporte für ein Video mit 16 Modulen einreihen: Qualitätsreparatur, KI-Farbkorrektur, Videostabilisierung, KI-Zeitlupe, Deinterlacing, Intelligenter Zuschnitt, Cartoonisierung, Skizzengenerierung, Fester Stiltransfer, Gesichtsrelighting und die sechs KI-Beauty-Module.
  • Dateiformate konvertieren, Mediendateien auf Schäden prüfen und reparieren.
  • Einen Link prüfen und herunterladen. Agenten-Downloads bleiben aus, bis Sie sie in den Einstellungen erlauben, und jeder Download braucht Ihre eigene Bestätigung im Chat.
  • Aufgaben pausieren, fortsetzen, abbrechen oder wiederholen.

Anmeldung und Plan

  • Status lesen, Dateien auf Schäden prüfen sowie Aufgaben pausieren oder abbrechen geht ohne Anmeldung.
  • Wie in der App brauchen Exporte (inklusive Verbesserungs-Aufgaben), Konvertierungen, Dateireparaturen und Downloads aus einem Link Anmeldung und einen bezahlten Plan. Das gilt auch, wenn eine dieser Aufgaben fortgesetzt oder wiederholt wird.
  • Die kostenlosen 1s/3s/5s-Vorschauen bleiben in der Desktop-App; der Assistent rendert sie nicht.

Dateien und Verbindung

  • Exporte, Konvertierungen und Reparaturen landen neben der Quelldatei. Downloads gehen in einen vorhandenen Ordner Ihrer Wahl.
  • Es werden nur Pfade auf diesem Computer angenommen. Netzwerkpfade werden abgelehnt, bevor auf eine Datei zugegriffen wird.
  • Die Verbindung ist lokales stdio: keine entfernte URL, kein OAuth und kein Authenticate-Knopf. Unter Windows läuft sie über eine Named Pipe Ihres Benutzerkontos, am Mac über einen Socket, den nur Ihr Konto öffnen kann.
  • Neue Aufgaben sind auf etwa 10 pro Minute begrenzt.

Fehlerbehebung

  • app_not_runningÖffnen Sie KwaFlux und laden Sie MCP im Assistenten neu.
  • Tools hängen beim Laden: Prüfen Sie, ob Node.js 18 oder neuer installiert und im PATH ist, und laden Sie MCP neu.
  • not_signed_in / entitlement_deniedMelden Sie sich in KwaFlux mit einem Konto mit bezahltem Plan an.
  • agent_download_disabledErlauben Sie zuerst Agenten-Downloads in den Einstellungen.

Einrichtung je Assistent: KwaFlux aus Codex, Claude, OpenClaw, DeepSeek, Hermes und Cursor steuern.