KwaFlux mit DeepSeek nutzen: DeepSeek Harness (DSH) per MCP verbinden

Das Wichtigste in Kürze

• DeepSeek Harness (DSH) verbindet sich mit KwaFlux über eine einzige insert-Zeile in einer Datei cordis.patch.yml. KwaFlux erzeugt die Zeile für Sie.
• Tragen Sie sie dort ein, wo Ihr DSH sie auch liest: Der Home-Patch ~/.dsh/cordis.patch.yml gilt für alle Profile, die eigene Datei eines Profils nur für dieses Profil.
• DSH lädt Patch-Dateien im laufenden Betrieb neu, die Tools erscheinen also meist ohne Neustart.
• Erhöhen Sie das Tool-Timeout pro Aufruf, damit ein langer Videoauftrag nicht abgeschnitten wird, während DeepSeek darauf wartet.

Der Agent von DeepSeek kann KwaFlux über den lokalen MCP-Server steuern, der mit der App installiert wird. DeepSeek Harness (DSH) lädt MCP-Server als Plugin-Zeilen aus einer geschichteten Konfigurationsdatei namens cordis.patch.yml. Wählen Sie in KwaFlux unter MCP-Host den Eintrag DeepSeek, kopieren Sie die Zeile und hängen Sie sie an die Patch-Datei an, die Ihr DSH-Profil liest.

In diesem Leitfaden erfahren Sie, wohin die Zeile gehört, warum das Profil eine Rolle spielt, welches Timeout Sie erhöhen sollten und worum Sie DeepSeek zuerst bitten.

Inhalt

1. Wie DSH MCP-Server lädt
2. Bevor Sie beginnen
3. Schritt 1: Die Zeile aus KwaFlux kopieren
4. Schritt 2: Die richtige Patch-Datei wählen
5. Schritt 3: Die Zeile anhängen
6. Schritt 4: Prüfen, ob der Server geladen wurde
7. Ihre ersten Anfragen
8. Fehlerbehebung
9. Häufige Fragen

Wie DSH MCP-Server lädt

DeepSeek Harness setzt seine Konfiguration aus mehreren Ebenen von Patch-Dateien zusammen. Jedes Profil hat seine eigene cordis.patch.yml; eine $DSH_HOME/cordis.patch.yml auf Home-Ebene enthält laut CLI-Referenz „maschinenlokale Einstellungen, die alle Profile teilen, weshalb sie Vorrang vor der Ebene pro Profil hat“.

MCP-Server sind Zeilen, die das MCP-Client-Plugin von DSH nutzen, @deepseek-ai/dsh-mcp-client. Ab Werk schaltet DSH keinen davon ein; die Referenz begründet das damit, dass „jeder Server-Befehl als vertrauenswürdig eingestufter ausführbarer Code außerhalb der Agent-Sandbox ist“. Wer KwaFlux hinzufügt, entscheidet sich also ausdrücklich dafür, dem Server von KwaFlux zu vertrauen.

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. 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.
• DeepSeek Harness installiert. DSH ist in seiner Dokumentation als Preview gekennzeichnet, Pfade und Befehle können sich also von Version zu Version ändern.

Schritt 1: Die Zeile aus KwaFlux kopieren

Öffnen Sie in KwaFlux Einstellungen › Agent (MCP), wählen Sie unter MCP-Host den Eintrag DeepSeek und klicken Sie auf Konfig kopieren. Bei einer Windows-Standardinstallation lautet die Zeile:

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']

Randnotiz: Der Pfad steht in einfachen Anführungszeichen. In YAML bleiben Backslashes in solchen Strings, wie sie sind, ein Windows-Pfad muss also nicht maskiert werden.

Schritt 2: Die richtige Patch-Datei wählen

Der Hinweis in KwaFlux nennt eine bestimmte Datei: „Diese Plugin-Zeile in ~/.dsh/profiles/web/cordis.patch.yml einfügen und die DSH-Sitzung neu starten.“ Das stimmt, wenn Sie das Web-Profil von DSH nutzen, also dsh web. Nutzen Sie etwas anderes, wählen Sie entsprechend:

Unter Windows steht ~ für C:\Users\<you>. Haben Sie DSH_HOME gesetzt, verwenden Sie diesen Ordner statt ~/.dsh.

Der häufigste Grund, warum KwaFlux in DSH „nicht auftaucht“: Die Zeile steht in einem Profil, das Sie gar nicht nutzen.

Schritt 3: Die Zeile anhängen

1. Sichern Sie die Datei zuerst.
2. Die Patch-Datei ist eine YAML-Liste. Fügen Sie die KwaFlux-Zeile am Ende ein, mit derselben Einrückung wie die anderen - insert:- oder - replace:-Einträge der obersten Ebene.
3. Gibt es die Datei noch nicht, legen Sie sie nur mit der KwaFlux-Zeile an.
4. Wenn Sie möchten, erhöhen Sie das Tool-Timeout innerhalb von config::

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
        toolCallTimeoutMs: 330000

Laut einer Einrichtungsanleitung eines Drittanbieters liegt das Standard-Timeout pro Aufruf in DSH bei 60 Sekunden. Das Warte-Tool von KwaFlux kann in einem Aufruf bis zu 300 Sekunden warten, mit 330.000 Millisekunden bleibt also Puffer. Lehnt Ihre DSH-Version das Feld ab, entfernen Sie es; DeepSeek kann nach einem Abbruch trotzdem erneut warten.

Schritt 4: Prüfen, ob der Server geladen wurde

DSH überwacht die Patch-Dateien und übernimmt gültige Änderungen per Hot Reload, der Server startet also meist wenige Sekunden nach dem Speichern. Tut sich nichts, starten Sie die DSH-Sitzung neu, wie der Hinweis in KwaFlux vorschlägt.

Fragen Sie dann:

Prüf mit den KwaFlux-Tools, ob KwaFlux läuft.

In DSH heißen die Tools von KwaFlux mcp__kwaflux__<tool>, zum Beispiel mcp__kwaflux__kwaflux_get_app_status. Ist KwaFlux geschlossen, liefert das Tool einen Fehler, der mit app_not_running beginnt.

Ihre ersten Anfragen

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

Kopieren Sie die Zeile aus KwaFlux, tragen Sie sie in die Patch-Datei ein, die Ihr tatsächlich genutztes DSH liest, und ergänzen Sie für Videoaufträge ein längeres Tool-Timeout. DSH lädt die Datei beim Speichern neu. Lassen Sie dann KwaFlux geöffnet und bitten Sie DeepSeek vor dem ersten echten Auftrag, den Status der App zu prüfen.

KwaFlux aus DeepSeek steuern

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