KwaFlux MCP funktioniert nicht? Lösungen für fehlende Tools, app_not_running und Timeouts

Das Wichtigste in Kürze

• Arbeiten Sie sich von außen nach innen vor: Startet der Host den Server, erreicht der Server die App, nimmt die App den Auftrag an?
• Erscheinen keine KwaFlux-Tools, liegt es fast jedes Mal an der Host-Konfiguration: ungültiges JSON oder YAML, die falsche Datei, Node.js nicht gefunden oder kein Neuladen.
• app_not_running heißt: Der Server funktioniert, aber KwaFlux ist nicht geöffnet (oder läuft nicht auf demselben Computer).
• Lange Wartevorgänge, die nach etwa einer Minute scheitern, sind ein Timeout des Hosts, kein fehlgeschlagener Auftrag. Der Auftrag läuft in KwaFlux weiter.

Wenn die MCP-Verbindung von KwaFlux nicht funktioniert, verrät das Symptom, auf welche Ebene Sie schauen müssen. Entweder hat der Host den Server nicht gestartet, oder der Server hat die App nicht erreicht, oder die App hat die Anfrage abgelehnt. Für jede Ebene gibt es eine kurze Liste von Ursachen und für jede Ursache eine konkrete Lösung.

In diesem Leitfaden erfahren Sie, wie Sie die drei Ebenen auseinanderhalten, was auf jeder Ebene hilft, welche Fehlermeldungen KwaFlux zurückgibt und wie Sie in zwei Minuten ganz ohne KI-Host prüfen, ob der Server startet.

Inhalt

1. Was schiefgehen kann, Ebene für Ebene
2. Ebene 1: keine KwaFlux-Tools im Host
3. Ebene 2: Die Tools sind da, aber Aufrufe scheitern mit app_not_running
4. Ebene 3: Die App lehnt den Auftrag ab
5. Wartevorgänge, die ins Timeout laufen
6. Aufträge, die scheitern oder nichts erzeugen
7. Eine Prüfung ganz ohne KI-Host
8. Kurzübersicht
9. Häufige Fragen

Was schiefgehen kann, Ebene für Ebene

Eine Anfrage durchläuft drei Teile:

1. Der Host (Cursor, Claude, Codex, DeepSeek Harness, Hermes, OpenClaw) liest seine Konfiguration und startet den MCP-Server von KwaFlux.
2. Der MCP-Server, unter Windows ein Node.js-Skript, auf dem Mac ein Hilfsprogramm innerhalb der App, verbindet sich mit der laufenden KwaFlux-App.
3. KwaFlux prüft die Anfrage und stellt den Auftrag in die Warteschlange.

Ebene 1: keine KwaFlux-Tools im Host

1. Die Konfigurationsdatei ist ungültig. Ein einziger Fehler kann dazu führen, dass der Host jeden Server in der Datei verwirft.

• JSON (Cursor, Claude, OpenClaw): Windows-Pfade brauchen doppelte Backslashes, C:\\Program Files\\.... Keine Kommentare, keine Kommas am Ende.
• TOML (Codex): Setzen Sie Windows-Pfade in einfache Anführungszeichen, wie im Schnipsel von KwaFlux, oder verdoppeln Sie jeden Backslash.
• YAML (DeepSeek Harness, Hermes): Behalten Sie die Einrückung des Schnipsels bei; in einfachen Anführungszeichen bleiben Backslashes, wie sie sind.

2. Der Eintrag steht in der falschen Datei oder im falschen Scope.

3. Node.js wird nicht gefunden. Unter Windows startet der Host den Server mit Node.js 18 oder neuer. Die Karte in den KwaFlux-Einstellungen sucht danach und schreibt den vollen Pfad in die Konfiguration. Meldet die Karte „Node.js nicht gefunden. Hosts starten diesen Server mit Node.js 18 oder neuer – bitte zuerst installieren.“ oder dass Ihre Version „zu alt“ ist, installieren Sie die aktuelle LTS-Version, klicken Sie auf Erneut nach Node.js suchen und kopieren Sie die Konfiguration noch einmal. Haben Sie die Konfiguration von Hand mit einem schlichten "node" geschrieben, ersetzen Sie es durch den vollen Pfad, etwa C:\Program Files\nodejs\node.exe, oder starten Sie den Host neu, damit er den neuen PATH übernimmt.

4. Der Pfad zum Server stimmt nicht. Das Skript heißt kwaflux_mcp.mjs und liegt in Tools\kwaflux-mcp im Installationsordner von KwaFlux. Haben Sie KwaFlux nicht unter C:\Program Files\KwaFlux installiert, kopieren Sie den Schnipsel von der Karte Einstellungen › Agent (MCP) in KwaFlux, die den echten Pfad einsetzt. Warnt die Karte „Kein mitgelieferter MCP-Server gefunden; der Pfad unten ist nur ein Platzhalter“, installieren Sie KwaFlux neu.

5. Der Host wurde nicht neu geladen. Jeder Host macht das auf seine Weise:

Anleitungen für die einzelnen Hosts: Cursor, Claude Code und Claude Desktop, Codex, DeepSeek Harness, Hermes und OpenClaw.

Ebene 2: Die Tools sind da, aber Aufrufe scheitern mit app_not_running

Das ist der einfachste Fall. Unter Windows sieht die komplette Meldung so aus:

app_not_running: Error: app_not_running: no control file of a running KwaFlux in C:\Users\<you>\AppData\Local\KwaFlux\agent

Der Server ist also sauber gestartet, hat aber kein laufendes KwaFlux gefunden, mit dem er sprechen kann. Das hilft:

• Öffnen Sie KwaFlux, warten Sie, bis das Fenster da ist, und fragen Sie erneut. Den Host müssen Sie nicht neu laden.
• Derselbe Computer, derselbe Benutzer. Der Server erreicht nur ein KwaFlux, das auf demselben Computer unter demselben Windows- oder macOS-Konto läuft. Ein Agent auf einem VPS, ein Cursor Cloud Agent oder eine Sitzung unter einem anderen Benutzerkonto kommt nicht heran.

Ebene 3: Die App lehnt den Auftrag ab

Lehnt KwaFlux eine Anfrage ab, nennt das Tool-Ergebnis den Grund. Die häufigsten:

Netzwerkpfade wie \\server\share\clip.mp4 werden mit Absicht abgelehnt, noch bevor eine Datei geöffnet wird. Kopieren Sie die Datei zuerst auf ein lokales Laufwerk. Die Hintergründe stehen in den Regeln zu Pfaden und Privatsphäre.

Wartevorgänge, die ins Timeout laufen

Das Warte-Tool von KwaFlux wartet pro Aufruf bis zu 300 Sekunden, standardmäßig 60. Manche Hosts geben einem MCP-Aufruf weniger Zeit:

Ein abgelaufener Wartevorgang stoppt den Auftrag nicht. Er läuft in der Aufgabenliste von KwaFlux weiter, und der Assistent kann erneut warten oder den Status abfragen.

Aufträge, die scheitern oder nichts erzeugen

• Lesen Sie den Fehlergrund der Aufgabe. Bitten Sie den Assistenten: „Ruf die KwaFlux-Aufgabe ab und nenn mir den Fehler.“ Die Details der Aufgabe enthalten den Grund.
• Prüfen Sie, wo das Ergebnis gelandet ist. Ergebnisse werden neben die Eingabedatei geschrieben, nicht in einen Ordner, den der Assistent nennt, und eine vorhandene Datei gleichen Namens bleibt erhalten: Die neue wird in name(1).ext umbenannt. Konvertierte Dateien enden auf _kwaflux_<format>-<tier>, reparierte auf _repair.
• Die Reparatur braucht eine Referenz. Sagt die Diagnose, dass eine Referenzdatei nötig ist, geben Sie einen intakten Clip derselben Kamera an. Siehe Videodatei-Reparatur.
• Im Chat nicht verfügbar. Die Bildinterpolation sowie die Tools zum Freistellen und Ersetzen werden über MCP nicht angeboten. Erledigen Sie das in der App.
• Scheitert es weiterhin? Versuchen Sie es einmal direkt im KwaFlux-Fenster. Scheitert es auch dort, ist es kein MCP-Problem; schicken Sie den Fehlergrund der Aufgabe an den Support.

Eine Prüfung ganz ohne KI-Host

Wenn Sie nicht sicher sind, ob der Server überhaupt starten kann, führen Sie ihn von Hand in einem Terminal aus:

node "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Ein gesunder Server gibt nichts aus und wartet auf Eingaben, denn er wartet darauf, dass ein Host mit ihm spricht. Mit Strg+C beenden Sie ihn. Sehen Sie stattdessen einen Fehler, etwa „not recognized“ (Node.js ist nicht im PATH; auf deutschem Windows lautet die Meldung „… wurde nicht als Name eines Cmdlet … erkannt“ bzw. „… ist entweder falsch geschrieben oder konnte nicht gefunden werden“) oder „Cannot find module“ (falscher Pfad), beheben Sie das zuerst; kein Host wird es besser machen.

Kurzübersicht

Fazit

Finden Sie zuerst die Ebene. Keine Tools heißt Host-Konfiguration; app_not_running heißt, die App ist auf diesem Computer nicht geöffnet; eine Ablehnung nennt ihren eigenen Grund; ein Abbruch nach einer Minute ist ein Timeout des Hosts. Im Zweifel führen Sie den Server von Hand aus: Wartet er still, liegt das Problem beim Host oder bei der App, nicht beim Server.

KwaFlux mit Ihrem Assistenten zum Laufen bringen

KwaFlux bringt einen lokalen MCP-Server für Cursor, Claude, Codex, DeepSeek Harness, Hermes, OpenClaw 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