Utiliser KwaFlux avec DeepSeek : connecter DeepSeek Harness (DSH) via MCP

L’essentiel

• DeepSeek Harness (DSH) se connecte à KwaFlux grâce à une seule ligne insert dans un fichier cordis.patch.yml. KwaFlux génère cette ligne pour vous.
• Placez-la là où le DSH que vous utilisez la lira : le patch global (home patch) ~/.dsh/cordis.patch.yml s’applique à tous les profils ; le fichier propre à un profil ne vaut que pour ce profil.
• DSH recharge à chaud les fichiers de patch : les outils apparaissent en général sans redémarrage.
• Augmentez le délai d’expiration par appel d’outil, pour qu’un long traitement vidéo ne soit pas coupé pendant que DeepSeek l’attend.

L’agent de DeepSeek peut piloter KwaFlux grâce au serveur MCP local installé avec l’application. DeepSeek Harness (DSH) charge les serveurs MCP sous forme de lignes de plugin dans un fichier de configuration en couches, cordis.patch.yml. Dans KwaFlux, choisissez DeepSeek sous Hôte MCP, copiez la ligne et ajoutez-la à la fin du fichier de patch que lit votre profil DSH.

Dans ce guide, vous verrez où placer la ligne, pourquoi le profil compte, quel délai augmenter et quoi demander en premier à DeepSeek.

Sommaire

1. Comment DSH charge les serveurs MCP
2. Avant de commencer
3. Étape 1 : copier la ligne depuis KwaFlux
4. Étape 2 : choisir le bon fichier de patch
5. Étape 3 : ajouter la ligne
6. Étape 4 : vérifier le chargement
7. Vos premières demandes
8. Dépannage
9. Questions fréquentes

Comment DSH charge les serveurs MCP

DeepSeek Harness construit sa configuration à partir de couches de fichiers de patch. Chaque profil a son propre cordis.patch.yml ; un fichier $DSH_HOME/cordis.patch.yml au niveau du dossier personnel contient, selon la référence de la CLI, « des préférences propres à la machine, partagées par tous les profils, si bien qu’il prime sur la couche de chaque profil ».

Les serveurs MCP sont des lignes qui utilisent le plugin client MCP de DSH, @deepseek-ai/dsh-mcp-client. DSH n’en active aucun par défaut : la référence explique que « chaque commande de serveur est du code exécutable de confiance, hors du bac à sable de l’agent ». Ajouter KwaFlux, c’est donc choisir explicitement de faire confiance au serveur de KwaFlux.

Avant de commencer

• KwaFlux 1.0.14 ou plus récent, ouvert.
• Node.js 18 ou plus récent, dans le PATH. Vérifiez avec node --version. La carte des Paramètres de KwaFlux cherche aussi Node.js et écrit son chemin complet dans la configuration, comme dans les exemples ci-dessous ; si elle ne le trouve pas, elle le signale et écrit node à la place.
• DeepSeek Harness installé. Sa documentation présente DSH comme une version Preview : chemins et commandes peuvent changer d’une version à l’autre.

Étape 1 : copier la ligne depuis KwaFlux

Dans KwaFlux, ouvrez Paramètres › Agent (MCP), choisissez DeepSeek sous Hôte MCP et cliquez sur Copier la config. Pour une installation Windows par défaut, la ligne est la suivante :

- 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']

À noter : le chemin est entre guillemets simples. En YAML, une chaîne entre guillemets simples garde les barres obliques inverses telles quelles : un chemin Windows n’a pas besoin d’être échappé.

Étape 2 : choisir le bon fichier de patch

L’indication de KwaFlux cite un seul fichier : « Insérez cette ligne de plugin dans ~/.dsh/profiles/web/cordis.patch.yml, puis redémarrez la session DSH. » C’est juste si vous utilisez le profil web de DSH, dsh web. Sinon, choisissez en conséquence :

Sous Windows, ~ correspond à C:\Users\<you>. Si vous avez défini DSH_HOME, utilisez ce dossier à la place de ~/.dsh.

Quand KwaFlux « n’apparaît pas » dans DSH, c’est le plus souvent parce que la ligne a été ajoutée à un profil que vous n’utilisez pas.

Étape 3 : ajouter la ligne

1. Faites d’abord une copie de sauvegarde du fichier.
2. Le fichier de patch est une liste YAML. Ajoutez la ligne KwaFlux à la fin, au même niveau d’indentation que les autres éléments de premier niveau - insert: ou - replace:.
3. Si le fichier n’existe pas encore, créez-le avec la seule ligne KwaFlux.
4. Si vous le souhaitez, augmentez le délai d’expiration des outils dans 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

Selon un guide de configuration tiers, le délai d’expiration par défaut de DSH pour chaque appel est de 60 secondes. L’outil d’attente de KwaFlux peut patienter jusqu’à 300 secondes en un seul appel : 330 000 millisecondes laissent donc de la marge. Si votre version de DSH refuse ce champ, retirez-le ; DeepSeek peut de toute façon relancer l’attente après une coupure.

Étape 4 : vérifier le chargement

DSH surveille les fichiers de patch et applique les modifications valides par rechargement à chaud : le serveur démarre en général quelques secondes après l’enregistrement. Si rien ne change, redémarrez la session DSH, comme le suggère l’indication de KwaFlux.

Demandez ensuite :

Vérifie avec les outils KwaFlux si KwaFlux est lancé.

Dans DSH, les outils de KwaFlux s’appellent mcp__kwaflux__<tool>, par exemple mcp__kwaflux__kwaflux_get_app_status. Si KwaFlux est fermé, l’outil renvoie une erreur qui commence par app_not_running.

Vos premières demandes

L’interpolation d’images ainsi que les outils de détourage et de remplacement restent dans l’application ; l’assistant a pour consigne de vous y renvoyer. Les téléchargements par les agents restent désactivés tant que vous n’avez pas réglé Autoriser les agents à lancer des téléchargements, sous Autorisation des agents, sur Demander à chaque fois. KwaFlux affiche alors une fenêtre pour chaque téléchargement, et l’assistant vous demande aussi de confirmer dans le chat que vous avez le droit de télécharger ce contenu.

Dépannage

Pour les problèmes communs à tous les hôtes, voyez le guide de dépannage MCP de KwaFlux.

Conclusion

Copiez la ligne depuis KwaFlux, placez-la dans le fichier de patch que lit réellement votre DSH, et allongez le délai d’expiration des outils pour les traitements vidéo. DSH la recharge dès l’enregistrement. Gardez ensuite KwaFlux ouvert et demandez à DeepSeek de vérifier l’état de l’application avant votre premier vrai traitement.

Pilotez KwaFlux depuis DeepSeek

KwaFlux intègre un serveur MCP local pour DeepSeek Harness et d’autres applications MCP. Le traitement IA tourne sur votre propre GPU et vos fichiers média ne sont pas envoyés pour être traités. KwaFlux fonctionne sous Windows 10 (64 bits, version 1809 ou plus récente), Windows 11 et macOS 12 ou plus récent sur Apple Silicon. Importer des fichiers et explorer l’app ne demandent pas de compte. Une connexion avec un forfait payant n’est requise que pour exporter, convertir, réparer un fichier ou télécharger un fichier depuis un lien.

Télécharger KwaFlux · Voir les offres