KwaFlux mit Codex nutzen: MCP-Einrichtung, Timeouts und Freigaben

Das Wichtigste in Kürze

• Codex verbindet sich mit KwaFlux über einen einzigen codex mcp add-Befehl oder über eine Tabelle [mcp_servers.kwaflux] in der ~/.codex/config.toml. KwaFlux erzeugt beides für Sie.
• Codex gibt einem MCP-Tool-Aufruf standardmäßig 60 Sekunden, das Warte-Tool von KwaFlux kann aber bis zu 300 Sekunden warten. Setzen Sie tool_timeout_sec höher, damit lange Videoaufträge nicht abgeschnitten werden.
• Der Befehl trägt das Start-Timeout von 20 Sekunden nicht ein, das im TOML von KwaFlux steht. Ergänzen Sie es, wenn der Server langsam startet.
• Mit den Freigabemodi von Codex laufen die reinen Lese-Tools von KwaFlux ohne Rückfrage, während Codex vor Aufträgen, die Dateien schreiben, weiterhin nachfragt.

Codex von OpenAI kann KwaFlux über den lokalen MCP-Server steuern, der mit der App installiert wird. Wählen Sie in den Einstellungen von KwaFlux Codex aus, kopieren Sie den Installationsbefehl oder die TOML-Tabelle, tragen Sie sie in Codex ein und lassen Sie KwaFlux geöffnet. Für die Videoarbeit lohnt es sich, zwei Einstellungen anzupassen: das Tool-Timeout und den Freigabemodus.

In diesem Leitfaden erfahren Sie, auf welchen zwei Wegen Sie KwaFlux zu Codex hinzufügen, welche Timeouts bei langen Aufträgen zählen, wie Sie die Freigaben steuern und womit Sie anfangen.

Inhalt

1. Wie Codex einen MCP-Server ausführt
2. Bevor Sie beginnen
3. Methode 1: codex mcp add
4. Methode 2: config.toml bearbeiten
5. Timeouts für lange Videoaufträge
6. Freigaben und Tool-Listen
7. Ihre ersten Anfragen
8. Fehlerbehebung
9. Häufige Fragen

Wie Codex einen MCP-Server ausführt

Zu Beginn jeder Sitzung startet Codex alle lokalen MCP-Server aus seiner Konfiguration und spricht mit ihnen über Standardeingabe und Standardausgabe. Die Tools des Servers stehen dem Modell danach neben den eigenen Tools von Codex zur Verfügung. Die Codex CLI und die Codex-Desktop-App nutzen dieselbe Konfiguration.

Der Server von KwaFlux ist ein Node.js-Skript, das mit der App installiert wird. Er verarbeitet selbst nichts, sondern reicht die Anfragen an die laufende KwaFlux-App weiter, die sie prüft und die Aufträge ausführt.

Bevor Sie beginnen

• KwaFlux 1.0.14 oder neuer, geöffnet.
• Node.js 18 oder neuer, im PATH. Prüfen Sie das mit node --version und installieren Sie bei Bedarf die aktuelle LTS-Version von nodejs.org. Die Karte in den KwaFlux-Einstellungen sucht ebenfalls nach Node.js und schreibt den vollen Pfad in die Konfiguration, wie in den Beispielen unten; findet sie Node.js nicht, sagt sie das und schreibt stattdessen node.
• In KwaFlux: Öffnen Sie Einstellungen › Agent (MCP) und wählen Sie unter MCP-Host den Eintrag Codex.

Methode 1: codex mcp add

Klicken Sie auf Installationsbefehl kopieren und führen Sie den Befehl in einem Terminal aus. Bei einer Windows-Standardinstallation lautet er:

codex mcp add kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Wir haben ihn mit Codex CLI 0.118.0 ausgeführt, und er meldete Added global MCP server 'kwaflux'. Prüfen Sie danach:

codex mcp list

KwaFlux sollte dort als aktiviert erscheinen. Der Befehl schreibt eine Tabelle in die ~/.codex/config.toml, die nur command und args enthält. Welche zwei Zeilen Sie von Hand ergänzen sollten, lesen Sie weiter unten.

Methode 2: config.toml bearbeiten

Klicken Sie stattdessen auf Konfig kopieren und hängen Sie die Tabelle an die ~/.codex/config.toml an oder an die .codex/config.toml eines vertrauenswürdigen Projekts:

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20

Wie der Hinweis in KwaFlux sagt: „Der Schlüssel ist mcp_servers (Unterstrich).“ Starten Sie Codex danach neu oder führen Sie in einer Sitzung /mcp aus, um den Server zu sehen.

Randnotiz: Der Pfad steht mit Absicht in einfachen Anführungszeichen. In TOML sind Strings in einfachen Anführungszeichen wörtlich, Backslashes in Windows-Pfaden müssen also nicht maskiert werden. In doppelten Anführungszeichen müssten Sie jeden einzelnen als \\ schreiben.

Timeouts für lange Videoaufträge

Die MCP-Dokumentation von Codex nennt zwei Timeouts pro Server:

Der zweite Wert ist der wichtigere. Bittet Codex KwaFlux, auf einen Export zu warten, blockiert das Warte-Tool, bis die Aufgabe fertig ist oder sein eigenes Limit erreicht ist, höchstens 300 Sekunden. Mit dem Standard von 60 Sekunden bricht Codex ein längeres Warten von seiner Seite ab, und das Modell wertet das unter Umständen als Fehler. Setzen Sie:

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20
tool_timeout_sec = 330

Die Aufgabe läuft in KwaFlux so oder so weiter. Ein Timeout beendet nur dieses eine Warten, und Codex kann den Stand der Aufgabe erneut abfragen.

Freigaben und Tool-Listen

In Codex legen Sie pro Server fest, wann vor einem Tool nachgefragt wird. Die Dokumentation nennt für default_tools_approval_mode die Werte auto, prompt, writes und approve, wobei writes „bei Tools nachfragt, die nicht als nur lesend markiert sind“. Das passt zu KwaFlux: Statusabfragen und Aufgabenlisten laufen durch, Aufträge, die Dateien schreiben, fragen weiterhin nach.

Außerdem können Sie eingrenzen, was Codex lädt: mit enabled_tools als Positivliste oder mit disabled_tools als Sperrliste. Nutzen Sie Codex etwa nur zum Konvertieren und Reparieren, listen Sie nur die Tools für Aufgaben, Konvertierung und Reparatur auf. Weniger Tools lassen außerdem mehr Platz im Kontext des Modells, wie unser Beitrag zum Tool-Design erklärt.

Ihre ersten Anfragen

Prüf, ob KwaFlux läuft, und liste meine letzten KwaFlux-Aufgaben auf.

Danach:

Die Bildinterpolation sowie die Tools zum Freistellen und Ersetzen bleiben in der App; der Assistent ist angewiesen, Sie dafür dorthin zu schicken. Downloads durch Agenten bleiben aus, solange Sie unter Agent-Freigabe die Option Downloads durch Agenten zulassen nicht auf Jedes Mal fragen stellen. KwaFlux zeigt dann für jeden Download ein Popup, und der Assistent bittet Sie zusätzlich im Chat zu bestätigen, dass Sie diesen Inhalt herunterladen dürfen.

Fehlerbehebung

Bei Problemen, die bei jedem Host auftreten können, hilft die Anleitung zur Fehlerbehebung bei KwaFlux MCP.

Fazit

Fügen Sie KwaFlux mit dem Befehl oder dem TOML hinzu, das KwaFlux für Sie kopiert, und ergänzen Sie dann zwei Zeilen: ein Start-Timeout von 20 Sekunden und ein Tool-Timeout von 330 Sekunden. Wählen Sie den Freigabemodus writes, wenn Codex nur vor Aufträgen nachfragen soll, die Dateien erzeugen. Lassen Sie KwaFlux geöffnet und beginnen Sie mit einer Statusabfrage.

KwaFlux aus Codex steuern

KwaFlux bringt einen lokalen MCP-Server für Codex 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