Ihr KI-Assistent bedient die Videosoftware: Schnellstart mit KwaFlux MCP

Kurz gesagt

KwaFlux bringt einen lokalen MCP-Server mit. Ein KI-Assistent wie Cursor, Claude oder Codex kann damit echte KwaFlux-Aufträge auf Ihrem Computer ausführen: einen defekten Clip reparieren, ihn verbessern, den Ton säubern, ihn komprimieren oder umwandeln. Sie formulieren die Bitte. KwaFlux übernimmt die Verarbeitung und zeigt jede Aufgabe im eigenen Fenster an.

• KwaFlux bringt einen lokalen MCP-Server mit. Ein KI-Assistent wie Cursor, Claude oder Codex kann damit echte KwaFlux-Aufträge auf Ihrem Computer ausführen, statt Ihnen ffmpeg-Befehle zum Einfügen zu schreiben.
• Die Einrichtung hat drei Schritte: Node.js installieren, einen Konfigurationsschnipsel aus den KwaFlux-Einstellungen kopieren und MCP im Assistenten neu laden.
• 31 der heute 40 Funktionen von KwaFlux lassen sich aus einem Chat starten, darunter 16 Werkzeuge zur KI-Verbesserung, die Dateireparatur, die Komprimierung und die Konvertierung in 64 Formate.
• Die Kontrolle bleibt bei Ihnen: Downloads durch Agenten sind ab Werk aus, ein einziger Schalter sperrt jede KI-Steuerung, und jede Aufgabe, die der Assistent startet, erscheint in KwaFlux.

Die Einrichtung dauert drei Schritte und kommt ohne Kommandozeile aus. Ergebnisse landen neben der Originaldatei, und aus dem Netz wird nur dann etwas heruntergeladen, wenn Sie es erlauben.

In diesem Leitfaden erfahren Sie, was KwaFlux MCP ist, wie Sie Ihren Assistenten verbinden, worum Sie ihn bitten können und was in der Desktop-App bleibt.

Inhalt

1. Was ist KwaFlux MCP?
2. Worum Sie den Assistenten bitten können
3. Schritt 1: Node.js installieren
4. Schritt 2: Die Konfiguration aus KwaFlux kopieren
5. Schritt 3: Den Assistenten fragen
6. Wann der Assistent Ihre Erlaubnis braucht
7. Tipps für Anfragen, die auf Anhieb klappen
8. Fehlerbehebung
9. Was in der Desktop-App bleibt
10. Häufige Fragen

Was ist KwaFlux MCP?

KwaFlux MCP ist ein kleiner Server, der mit KwaFlux installiert wird. Über ihn kann ein KI-Assistent auf demselben Computer die Funktionen von KwaFlux per Model Context Protocol als Tools aufrufen.

MCP ist ein offenes Protokoll, über das KI-Apps externe Tools anbinden. Der Assistent (der „Host“) startet den KwaFlux-Server als lokalen Prozess und spricht über Standardein- und -ausgabe mit ihm. Der Server reicht jede Anfrage an die laufende KwaFlux-App weiter. Die prüft sie und stellt sie in dieselbe Aufgabenwarteschlange wie die Aufträge, die Sie per Klick starten.

Gerade der letzte Punkt ist wichtig. Der Assistent rät keine Kommandozeilenparameter. Er füllt ein paar typisierte Felder aus, etwa Datei, Modul und Ausgabegröße, und KwaFlux baut daraus den kompletten Auftrag nach denselben Regeln, die auch beim Klick auf Exportieren gelten. Wie das funktioniert, lesen Sie unter was ein KI-Assistent in KwaFlux tun kann.

Worum Sie den Assistenten bitten können

Der Assistent kann außerdem Aufgaben auflisten, mit Live-Fortschrittsbalken auf eine Aufgabe warten und die Aufgaben, die er selbst gestartet hat, pausieren, fortsetzen, abbrechen oder erneut versuchen.

Schritt 1: Node.js installieren

Ihr Assistent startet den KwaFlux-MCP-Server mit Node.js, so wie die meisten lokalen MCP-Server. KwaFlux liefert das Serverskript mit, Node.js selbst aber nicht.

1. Öffnen Sie in KwaFlux die Einstellungen und gehen Sie zu Agent (MCP).
2. Meldet die Seite, dass Node.js fehlt oder zu alt ist, laden Sie über den Link dort die aktuelle LTS-Version von nodejs.org herunter und installieren sie.
3. Kehren Sie zur Seite zurück. Sie prüft erneut und zeigt die gefundene Version an.

Randnotiz: KwaFlux schreibt den vollen Pfad zu Node.js in die Konfiguration, die Sie erhalten. Das verhindert das bekannte Problem „Server startet nicht“, bei dem ein aus dem Dock oder dem Startmenü gestarteter Assistent Node im eigenen PATH nicht findet.

Schritt 2: Die Konfiguration aus KwaFlux kopieren

Wählen Sie auf derselben Seite Agent (MCP) unter MCP-Host Ihren Assistenten aus. KwaFlux erzeugt die Konfiguration für sechs Hosts: Codex, Claude, OpenClaw, DeepSeek (DSH), Hermes und Cursor.

1. Wählen Sie Ihren Host.
2. Kopieren Sie den Schnipsel oder nutzen Sie die Installationsoption, wo Ihr Host eine anbietet.
3. Tragen Sie ihn in die MCP-Konfiguration Ihres Hosts ein. Ergänzen Sie den Eintrag kwaflux; ersetzen Sie nicht die ganze Datei.
4. Laden Sie MCP im Assistenten neu oder starten Sie eine neue Sitzung.

Jeder Host speichert seine Konfiguration an einem anderen Ort. Unsere Einrichtungsanleitung für jeden Host zeigt, wohin sie jeweils gehört. Jede andere App, die lokale stdio-MCP-Server unterstützt, lässt sich ebenfalls verbinden; folgen Sie dazu der MCP-Einrichtungsseite.

Lassen Sie KwaFlux geöffnet, solange Sie den Assistenten nutzen. Der MCP-Server ist nur der Bote; die Arbeit passiert in der App.

Schritt 3: Den Assistenten fragen

Beginnen Sie mit etwas, das nur liest. So sehen Sie, dass die Verbindung steht:

Läuft KwaFlux? Liste meine letzten Aufgaben auf.

Probieren Sie dann einen echten Auftrag, mit dem vollen Pfad der Datei:

Konvertiere D:\Videos\trip.mp4 ins TikTok-Format und sag mir Bescheid, wenn es fertig ist.

Der Assistent ruft das Konvertierungstool auf und wartet dann auf die Aufgabe. In KwaFlux erscheint sie in der Aufgabenliste mit einer Markierung, welcher Assistent sie eingereicht hat, sodass Sie seine Aufträge von Ihren eigenen unterscheiden können. Ist sie fertig, liegt die neue Datei neben trip.mp4, und der Assistent bekommt ihren Dateinamen zurück.

Ihr Host zeigt die vier eingebauten Workflows von KwaFlux womöglich auch als Prompts oder Slash-Befehle an: beschädigtes Video reparieren, für eine Plattform exportieren, herunterladen und dann konvertieren sowie KI-Qualitätsreparatur. Sie führen den Assistenten der Reihe nach durch die passenden Tools.

Wann der Assistent Ihre Erlaubnis braucht

Manches sollten Sie entscheiden, nicht der Assistent. KwaFlux regelt das in der App, wo nur Sie klicken können:

• Downloads sind ab Werk aus. Unter Agent-Freigabe kann Downloads durch Agenten zulassen auf Aus bleiben oder auf Jedes Mal fragen gestellt werden; dann zeigt ein Desktop-Popup Link, Zielordner und Format an. Die dritte Option lässt Downloads ohne Nachfrage durch. Ein unbeantwortetes Popup verfällt nach 120 Sekunden. Einzelheiten stehen in warum eine KI Downloads nicht für Sie freigeben kann.
• Ein Schalter schaltet jede KI-Steuerung ab: KI-Agenten die Steuerung von KwaFlux erlauben. Dieselbe Seite zeigt, welche Assistenten verbunden sind, und listet unter Letzte Agent-Aktionen ihre letzten 200 Aufrufe auf, ohne deren Parameter.
• Der Assistent verwaltet nur seine eigenen Aufgaben. Aufträge, die Sie im Fenster gestartet haben, sieht er zwar, kann sie aber nicht pausieren, abbrechen oder erneut versuchen.

Tipps für Anfragen, die auf Anhieb klappen

• Nennen Sie den vollen Pfad. KwaFlux akzeptiert nur lokale Pfade wie D:\Videos\clip.mp4 oder /Users/you/Movies/clip.mov, keine Netzlaufwerke.
• Nennen Sie das Ziel, nicht die Einstellung. „Klein genug für eine E-Mail“ oder „für Instagram“ lässt den Assistenten die passende Vorlage wählen.
• Erst diagnostizieren, dann reparieren. Die Prüfung einer beschädigten Datei geht schnell, und die Reparatur nutzt danach den Modus, den die Diagnose empfiehlt.
• Bitten Sie ihn zu warten. „Sag mir Bescheid, wenn es fertig ist“ sorgt dafür, dass der Assistent die Aufgabe verfolgt, statt schon Erfolg zu melden, sobald der Auftrag in der Warteschlange steht.

Tipp: Wenn Ihr Host festlegen lässt, welche Tools ein Server lädt, können Sie die Umgebungsvariable KWAFLUX_MCP_TOOLSETS auf die Gruppen beschränken, die Sie tatsächlich nutzen, etwa convert,repair. Weniger Tools lassen mehr Platz im Kontext des Modells.

Fehlerbehebung

Was in der Desktop-App bleibt

Neun Funktionen verlangen, dass Sie beim Arbeiten aufs Bild schauen: einen Rahmen ziehen, ein Motiv anklicken oder eine Vorschau beurteilen. Sie bleiben bewusst in der App. Dazu gehören Porträthintergrund entfernen, das Ersetzen des Himmels, das Entfernen von Objekten, die Bildinterpolation und die Untertitelbearbeitung. Bitten Sie um eine davon, wird der Assistent angewiesen, Sie an KwaFlux zu verweisen, statt zu raten, wohin Sie klicken wollten.

Auch die kostenlosen Vorschauen von 1, 3 und 5 Sekunden bleiben in der App.

Fazit

Node.js installieren, Konfiguration kopieren, App geöffnet lassen. Danach lassen sich die Aufträge, die Sie sonst durchklicken würden, also Reparieren, Verbessern, Komprimieren und Konvertieren, mit einem Satz starten, und Sie sehen weiterhin jeden davon und können ihn stoppen. Ein komplettes Beispiel von der defekten Datei bis zur upload-fertigen Kopie finden Sie im kompletten Reparatur-Workflow mit einem KI-Agenten.

KwaFlux bringt einen lokalen MCP-Server für Codex, Claude, Cursor und andere MCP-Apps mit. Die KI-Verarbeitung läuft auf Ihrer eigenen GPU, und Ihre Mediendateien werden für die Verarbeitung nicht hochgeladen. KwaFlux läuft unter Windows 10 (64-Bit, Version 1809 oder neuer), Windows 11 und macOS 12 oder neuer auf Apple Silicon. Dateien importieren und die App erkunden geht ohne Konto. Anmeldung und ein bezahlter Plan sind nur für Export, Konvertierung, Dateireparatur und Datei-Download aus einem Link nötig.

KwaFlux laden · Pläne ansehen