KwaFlux aus Codex, Claude, OpenClaw, DeepSeek, Hermes und Cursor steuern
KwaFlux bringt einen lokalen MCP-Server mit. App offen lassen und Codex, Claude, OpenClaw, DeepSeek, Hermes oder Cursor verbinden. Konvertieren, Reparieren, Verbessern und Download brauchen Anmeldung und einen bezahlten Plan.
Was das ist
Ja, ein KI-Agent kann KwaFlux steuern: Die Desktop-App bringt einen lokalen MCP-Server mit, mit dem sich Codex, Claude, OpenClaw, DeepSeek (DSH), Hermes und Cursor verbinden können. Öffnen Sie Einstellungen › Erweitert › Agent (MCP), kopieren Sie die Konfiguration in Ihre Chat-App und lassen Sie KwaFlux laufen. Die Verbindung ist lokales stdio auf diesem Computer, ohne OAuth-Schritt.

Wo jeder Host die Konfiguration ablegt
| Host | Wohin |
|---|---|
| Codex | An ~/.codex/config.toml anhängen. Der Schlüssel heißt mcp_servers. Codex neu starten oder /mcp ausführen. |
| Claude Code | Die .mcp.json im Projekt oder der Installationsbefehl. Danach eine neue Sitzung öffnen. |
| Claude Desktop | In claude_desktop_config.json zusammenführen, dann die App ganz beenden, nicht nur das Fenster. Unter Windows liegt die Datei in %APPDATA%\Claude\. |
| OpenClaw | Unter mcp.servers in ~/.openclaw/openclaw.json zusammenführen oder openclaw mcp set ausführen. |
| DeepSeek | Eine DSH-Profil-YAML. Die DSH-Sitzung neu starten. |
| Hermes | hermes mcp add ausführen oder mcp_servers in die config.yaml schreiben (%LOCALAPPDATA%\hermes unter nativem Windows, sonst ~/.hermes). |
| Cursor | Die Installation in der App nutzen, dann in Cursor Reload MCP ausführen. |
Was der Agent tun kann
Er liest, ob die App läuft und angemeldet ist, listet Aufgaben und wartet, bis eine fertig ist. Eine Aufgabe, die er selbst gestartet hat, kann er pausieren, fortsetzen, abbrechen oder wiederholen. Eine beschädigte Datei lässt sich vor der Reparatur diagnostizieren.
- Konvertieren: exportiert in 64 Formate mit Qualitätsstufe, mit Vorlagen für YouTube, TikTok und andere Plattformen, und macht aus einem Zeitbereich ein GIF. Die Datei wird neben der Eingabedatei gespeichert.
- Reparieren: Die Diagnose kann zuerst laufen.
- Verbessern: Qualitätsreparatur, Farbe, Stabilisierung, Deinterlacing, intelligente Effekte und Beauty. Die Datei wird neben der Eingabedatei gespeichert.
- Download: einen Link nachschlagen und dann speichern. Downloads bleiben aus, bis Sie unter Agent-Freigabe die Einstellung Jedes Mal fragen wählen. Danach fragt KwaFlux vor jedem Download in einem Popup nach.
- Frame-Interpolation bleibt in der Desktop-App.
- Freistellen und Hintergrundtausch für Personen, Objekte und Himmel bleiben in der Desktop-App.
- Das Anklicken eines Motivs in einem pausierten Bild bleibt in der Desktop-App.
- Eine Aufgabe, die Sie selbst im Fenster gestartet haben, kann der Agent nicht steuern.
Downloads bleiben aus, bis Sie sie einschalten
Öffnen Sie Einstellungen › Allgemein und suchen Sie Agent-Freigabe. Downloads durch Agenten zulassen hat drei Modi: aus, Jedes Mal fragen und einen Modus, der Downloads ohne Nachfrage durchlässt. Mit Jedes Mal fragen zeigt KwaFlux ein Desktop-Popup mit Link, Ordner und Format, und nur Ihr Klick gibt den Download frei. Ein unbeantwortetes Popup verfällt nach 120 Sekunden. Der Assistent bittet Sie zusätzlich im Chat zu bestätigen, dass Sie die Datei speichern dürfen, doch seine eigene Behauptung zählt nicht. KwaFlux meldet sich nicht auf einer Website an und umgeht keine Bezahlschranke.
Grenzen
Pfade müssen absolut sein und auf diesem Computer liegen. Konvertieren und Verbessern lassen den Agenten den Ausgabeordner nicht wählen. Die App steht unter Download.
Für den Weg über einen Agenten brauchen Sie keine zusätzliche Lizenz: Eine Lizenz deckt die App und ihren MCP-Server auf bis zu 2 Computern ab, Windows und Mac beliebig gemischt. Aufträge, die ein Agent startet, laufen auf diesem Computer, und die Mediendateien werden dafür nicht hochgeladen.
Was im Fenster bleibt
Der Agent kann die oben genannten Aufgaben erledigen, aber nichts darüber hinaus. Er kann prüfen, ob die App läuft und ob Sie angemeldet sind. Er kann Aufgaben auflisten und warten, bis eine fertig ist. Er kann eine Aufgabe, die er selbst gestartet hat, pausieren, fortsetzen, abbrechen oder wiederholen. Er kann eine beschädigte Datei vor einer Reparatur diagnostizieren. Aufgaben, die Sie selbst per Klick im KwaFlux-Fenster gestartet haben, kann er nicht steuern.
Konvertieren exportiert in 64 Formate mit Qualitätsstufe und kann aus einem Zeitbereich ein GIF machen. Verbessern umfasst Qualitätsreparatur, Farbe, Stabilisierung, Deinterlacing, intelligente Effekte und Beauty. Die Datei wird neben der Eingabedatei gespeichert, einen anderen Ordner kann der Agent nicht wählen. Pfade, die Sie angeben, müssen absolute Pfade auf diesem Computer sein.
Frame-Interpolation, Freistellen und Hintergrundtausch, das Anklicken eines Motivs in einem pausierten Bild sowie die kostenlosen Vorschauen von 1, 3 und 5 Sekunden bleiben in der Desktop-App. Der Agent führt sie nicht aus.
Downloads bleiben aus, bis Sie sie unter Agent-Freigabe auf Jedes Mal fragen stellen. Danach fragt KwaFlux vor jedem Download in einem Popup nach. Ein Satz des Assistenten zählt nicht als Freigabe. KwaFlux meldet sich nicht für Sie auf einer Website an und umgeht keine Bezahlschranke. Die Host-Tabelle oben zeigt, wo jede App die aus den Einstellungen kopierte Konfiguration ablegt. Erfinden Sie keinen Pfad. Lassen Sie KwaFlux offen, während die Chat-App über lokales stdio verbunden ist.
Wenn die Verbindung nicht klappt oder ein Auftrag scheitert
Prüfen Sie zuerst die KwaFlux-Seite. Öffnen Sie Einstellungen › Allgemein. Unter Agent-Freigabe nennt die Zeile unter KI-Agenten die Steuerung von KwaFlux erlauben jeden Host, der gerade verbunden ist. Steht dort Keine Agenten verbunden, hat die Chat-App KwaFlux gar nicht erreicht. Dann liegt das Problem auf der Seite der Chat-App.
- Führen Sie
node --versionim Terminal aus. Der Server braucht Node.js 18 oder neuer. Eine ältere Version stoppt ihn schon beim Start, und das Log des Hosts sagt das klar. - Codex: Tippen Sie in der Terminal-Oberfläche
/mcp, um die aktiven Server zu sehen, oder führen Siecodex mcp listaus. - Claude Code:
claude mcp listzeigt neben jedem Server einen Status, etwa Connected oder Failed to connect. Ein Server aus einer Projekt-.mcp.json wartet beim ersten Start vonclaudeauf Ihre Freigabe. - Claude Desktop: Die Logs liegen unter Windows in %APPDATA%\Claude\logs, auf dem Mac in ~/Library/Logs/Claude. mcp.log protokolliert die Verbindungen, mcp-server-kwaflux.log enthält die Meldungen des Servers selbst.
- Cursor: Öffnen Sie mit Strg+Umschalt+U (auf dem Mac Cmd+Shift+U) das Output-Panel und wählen Sie im Dropdown MCP Logs.
Steht die Verbindung, meldet ein gescheiterter Auftrag einen kurzen Code zurück, den Assistenten gern umschreiben. Letzte Agent-Aktionen im selben Bereich listet jeden Aufruf mit Host und Ergebnis auf. So lesen Sie den Code selbst.
| Code | Bedeutung | Was tun |
|---|---|---|
app_not_running | KwaFlux ist auf diesem Rechner nicht geöffnet. | KwaFlux öffnen, dann MCP neu laden oder die Chat-App neu starten. |
agent_control_disabled | KI-Agenten die Steuerung von KwaFlux erlauben ist ausgeschaltet. | Unter Einstellungen › Allgemein › Agent-Freigabe wieder einschalten. |
not_signed_in, entitlement_denied | Der Auftrag braucht eine Anmeldung und einen bezahlten Tarif. | In KwaFlux anmelden und den Tarif prüfen. |
app_busy | In kurzer Zeit wurden zu viele Aufträge gestartet. | Eine Minute warten, dann erneut fragen. |
input_not_local | Der Pfad beginnt mit zwei Schrägstrichen wie \\server\share oder ist eine Webadresse. | Datei in einen lokalen Ordner kopieren und den vollständigen Pfad angeben. |
model_not_installed | Das KI-Modell für diese Funktion fehlt noch auf dem Rechner. | Die Funktion in KwaFlux öffnen und das Modell laden, oder Einstellungen › Modelle & Speicher öffnen. |
agent_download_disabled | Downloads durch Agenten sind noch aus. | Bei Bedarf unter Agent-Freigabe Jedes Mal fragen wählen. |
user_declined, approval_expired | Sie haben den Download abgelehnt, oder das Popup blieb 120 Sekunden unbeantwortet. | Fragen Sie erneut, wenn Sie am Rechner sitzen. |
Für jeden Auftrag, den ein Agent einreiht, erscheint außerdem ein kurzer Hinweis mit dem Namen des Hosts, etwa „Codex hat eine Aufgabe eingereiht“. Der Auftrag steht dann neben Ihren eigenen in der Aufgabenzentrale. Wenn Sie glauben, dass der Zugangstoken nach außen gelangt ist, klicken Sie am Ende der Verbindungszeile auf Agent-Zugangstoken zurücksetzen. Bestehende Verbindungen brechen ab, und eingerichtete Hosts verbinden sich beim nächsten Aufruf mit dem neuen Token.
Auf eigenem Material testen
Laden Sie KwaFlux und testen Sie Effekte vor dem Kauf kostenlos an Ihrem eigenen Material. Ein Konto brauchen Sie dafür nicht. Ihre Medien werden auf Ihrer GPU verarbeitet und für die Verarbeitung nicht hochgeladen. Videovorschauen laufen 1, 3 oder 5 Sekunden, Vorschauen der Stabilisierung 5, 15 oder 30 Sekunden.
Häufige Fragen
Kann ich KwaFlux aus Claude, Cursor oder einem anderen KI-Assistenten steuern?
Ja. KwaFlux bringt einen lokalen MCP-Server mit, der über stdio läuft. Clients wie Codex, Claude und Cursor können KwaFlux darüber steuern. Lassen Sie KwaFlux laufen, kopieren Sie die Konfiguration aus Einstellungen → Erweitert → Agent (MCP) in die KI-App und installieren Sie Node.js 18 oder neuer. Damit startet die KI-App den Server.
Warum gibt es für KwaFlux keinen Authenticate-Knopf?
Weil der MCP-Server von KwaFlux lokal über stdio läuft und keine entfernte URL hat. Deshalb gibt es keinen OAuth-Schritt.
Kann der Agent in KwaFlux kostenlos exportieren oder konvertieren?
Nein, für Konvertieren, Reparieren, Verbessern und Download über MCP braucht KwaFlux eine Anmeldung und einen bezahlten Plan. Die kostenlosen Vorschauen von 1, 3 und 5 Sekunden bleiben in der Desktop-App.
Kann der Agent in KwaFlux Downloads starten?
Ja, sobald Sie Downloads durch Agenten zulassen auf Jedes Mal fragen stellen. KwaFlux fragt dann vor jedem Download in einem Popup nach, und der Assistent kann ihn nicht für Sie freigeben.
Warum lehnt KwaFlux meinen Dateipfad ab?
Pfade müssen vollständige Pfade auf diesem Rechner sein, etwa C:\Videos\clip.mp4 oder /Users/you/Movies/clip.mp4. Ein relativer Pfad scheitert. Das gilt auch für einen Pfad mit zwei Schrägstrichen am Anfang wie \\server\share\clip.mp4. Solche Pfade lehnt KwaFlux ab, bevor irgendetwas geöffnet wird, denn unter Windows kann schon die Prüfung der Datei eine Anmeldung bei dem Server anstoßen. Kopieren Sie die Datei zuerst in einen lokalen Ordner.
Wo sehe ich, was der Agent in KwaFlux getan hat?
Öffnen Sie in KwaFlux Einstellungen › Allgemein › Agent-Freigabe und sehen Sie unter Letzte Agent-Aktionen nach. Jede Zeile zeigt Uhrzeit, Host, Aufruf und Ergebnis. Aufträge des Agenten stehen zusätzlich in der Aufgabenzentrale, und zu jedem gab es einen Hinweis mit dem Namen des Hosts.
Können Cursor Cloud Agents einen lokalen MCP-Server nutzen?
Nein. Ein lokaler stdio-Server ist ein Programm auf Ihrem Computer. Cloud Agents laufen dagegen auf der Infrastruktur von Cursor und können ihn daher nicht starten. Nutzen Sie den Agenten in der Desktop-App von Cursor auf demselben Computer.
Warum brauchen Windows-Pfade in der mcp.json doppelte Backslashes?
Weil JSON einen Backslash als Beginn einer Escape-Sequenz behandelt. C:\\Program Files ist gültiges JSON für C:\Program Files. Mit einem einzelnen Backslash lässt sich die Datei nicht einlesen. Normale Schrägstriche funktionieren ebenfalls.
Warum erkennt Claude Desktop einen neuen MCP-Server nicht?
Meist, weil die App im Hintergrund noch läuft. Schließen Sie das Fenster, beenden Sie die App über den Infobereich bzw. die Menüleiste und öffnen Sie sie wieder. Danach sollten Sie auf ungültiges JSON prüfen, etwa einen einzelnen Backslash in einem Windows-Pfad.
Sieht Claude Code im Web mein lokales KwaFlux?
Nein. Der KwaFlux-Server ist ein lokales Programm, das der Host auf Ihrem Rechner startet. Cloud-Sitzungen laden Remote-Server aus einer Projekt-.mcp.json, nicht den Node-Prozess neben KwaFlux. Nutzen Sie Claude Code oder Claude Desktop auf dem Rechner, auf dem die App offen ist.
Was bedeutet tool_timeout_sec in Codex?
Die Zeit, die Codex auf einen einzelnen MCP-Tool-Aufruf wartet, bevor es aufgibt. Standardmäßig sind das 60 Sekunden. Erhöhen Sie den Wert für Server, deren Tools länger brauchen können, etwa ein Tool, das auf einen Videoexport wartet. Siehe wie lang laufende Aufträge behandelt werden.
Warum stehen Windows-Pfade in der config.toml in einfachen Anführungszeichen?
Weil TOML-Strings in einfachen Anführungszeichen wörtlich sind: Backslashes bleiben, wie sie sind. In doppelten Anführungszeichen leitet ein Backslash eine Escape-Sequenz ein. Aus C:\Program Files müsste dann C:\\Program Files werden.
Muss ich MCP in der ChatGPT-Desktop-App nochmal einrichten?
Nein. Die MCP-Seite von OpenAI sagt, ChatGPT-Desktop-App, CLI und IDE-Erweiterung teilen die Codex-Host-Konfiguration. Tragen Sie KwaFlux einmal in ~/.codex/config.toml ein, dann geht Codex in all diesen Clients. ChatGPT im Web liest die Datei nicht.
Wo füge ich in DeepSeek Harness MCP-Server hinzu?
In einer cordis.patch.yml, als insert-Zeile für das Plugin @deepseek-ai/dsh-mcp-client. Nehmen Sie die eigene Datei eines Profils für dieses Profil oder die Home-Datei ~/.dsh/cordis.patch.yml für alle Profile.
Die Patchdatei ist `[]`. Hänge ich KwaFlux darunter an?
Nein, ersetzen Sie [] durch den Block - insert: von KwaFlux. Eine Datei mit [] und einem weiteren Listeneintrag ist kein gültiges YAML, und DSH bricht mit einem Parsefehler ab. Ein neuer Profilpatch beginnt oft als diese leere Liste.
Kann ein Agent auf einem VPS einen lokalen MCP-Server auf meinem PC nutzen?
Nein, nicht bei einem stdio-Server. Ein stdio-Server läuft als Kindprozess des Agenten auf demselben Rechner. Um einen Server auf Ihrem PC zu nutzen, muss auch der Agent dort laufen. Wie die Teile zusammenhängen, lesen Sie unter was ein KI-Agent ist.
Warum scheitert ein MCP-Server mit „node is not recognized“?
Weil Node.js nicht installiert ist oder nicht in dem PATH steht, den der Host sieht. Installieren Sie es, beenden Sie den Host und starten Sie ihn neu. Hilft das nicht, tragen Sie den vollen Pfad zu node.exe in das Feld command des Servers ein.
Warum laufen lange MCP-Tool-Aufrufe ins Timeout?
Weil manche Hosts, etwa Codex und DeepSeek Harness, einen einzelnen Tool-Aufruf standardmäßig auf 60 Sekunden begrenzen. Manche KwaFlux-Tools sind aber darauf ausgelegt, länger zu warten. Erhöhen Sie das Tool-Timeout des Hosts für diesen Server. Der Auftrag selbst läuft in der Regel weiter.
Der Host sagt auf dem Mac `env: node: No such file or directory`. Was tun?
Der Host wurde wahrscheinlich aus dem Dock oder über Spotlight geöffnet. Dann fehlt ihm der PATH aus dem Terminal, und er sieht kein Node.js von Homebrew oder nvm. Auf dem Mac startet KwaFlux' Launcher das node, das in diesem PATH liegt. Führen Sie im Terminal which node aus. Setzen Sie dann PATH unter env des Servers auf diesen Ordner plus /usr/bin:/bin, etwa /opt/homebrew/bin:/usr/bin:/bin. Oder starten Sie den Host aus dem Terminal. Mehr zum Mac: KwaFlux auf dem Mac.
Quellen
- Model Context Protocol: What is the Model Context Protocol (MCP)? (abgerufen am 2026-10-11)
- Model Context Protocol specification: Transports (stdio) (abgerufen am 2026-10-11)
- Node.js: Node.js releases (abgerufen am 2026-10-11)
- Model Context Protocol: Connect to local MCP servers (troubleshooting and Claude Desktop logs) (abgerufen am 2026-11-08)
- Claude Code docs: Connect Claude Code to tools via MCP (claude mcp list and server status) (abgerufen am 2026-11-08)
- OpenAI Codex docs: Model Context Protocol (codex mcp list and /mcp) (abgerufen am 2026-11-08)
Verwandte Artikel
Formatkonverter
H.264, H.265 und AV1, lokal verarbeitet
ÖffnenVideoformate lokal konvertieren (H.264, H.265, MP4, MOV) ohne Upload
Fertige Master nach der Verbesserung lokal umwandeln: welcher Codec und Container passt und warum ein eingebauter Konverter einen Upload spart.
ÖffnenDateireparatur
Video, Bild und Audio
ÖffnenDatei-Download
Ein eingefügter Link
Öffnen

