Le MCP de KwaFlux ne fonctionne pas ? Outils absents, app_not_running et délais dépassés

L’essentiel

• Procédez de l’extérieur vers l’intérieur : l’hôte lance-t-il le serveur, le serveur atteint-il l’application, l’application accepte-t-elle la tâche ?
• Si aucun outil KwaFlux n’apparaît, la cause est presque à chaque fois la configuration de l’hôte : JSON ou YAML invalide, mauvais fichier, Node.js introuvable ou absence de rechargement.
• app_not_running signifie que le serveur fonctionne, mais que KwaFlux n’est pas ouvert (ou pas sur le même ordinateur).
• Les longues attentes qui échouent au bout d’environ une minute viennent d’un délai d’expiration de l’hôte, pas d’une tâche ratée. La tâche continue dans KwaFlux.

Quand la connexion MCP de KwaFlux ne fonctionne pas, le symptôme vous dit quelle couche examiner. Soit l’hôte n’a pas lancé le serveur, soit le serveur n’a pas pu joindre l’application, soit l’application a refusé la demande. Chaque cas a une courte liste de causes, et chaque cause a une solution précise.

Dans ce guide, vous verrez comment distinguer les trois couches, les solutions pour chacune, les messages d’erreur que renvoie KwaFlux et une vérification de deux minutes que vous pouvez faire sans aucun hôte IA.

Sommaire

1. Ce qui peut coincer, couche par couche
2. Couche 1 : aucun outil KwaFlux dans l’hôte
3. Couche 2 : les outils apparaissent, mais les appels échouent avec app_not_running
4. Couche 3 : l’application refuse la tâche
5. Les attentes qui expirent
6. Les tâches qui échouent ou ne produisent rien
7. Une vérification sans hôte IA
8. Aide-mémoire
9. Questions fréquentes

Ce qui peut coincer, couche par couche

Une demande traverse trois éléments :

1. L’hôte (Cursor, Claude, Codex, DeepSeek Harness, Hermes, OpenClaw) lit sa configuration et lance le serveur MCP de KwaFlux.
2. Le serveur MCP, un script Node.js sous Windows ou un utilitaire intégré à l’application sur Mac, se connecte à l’application KwaFlux en cours d’exécution.
3. KwaFlux vérifie la demande et met la tâche en file d’attente.

Couche 1 : aucun outil KwaFlux dans l’hôte

1. Le fichier de configuration est invalide. Une seule erreur peut amener l’hôte à ignorer tous les serveurs du fichier.

• JSON (Cursor, Claude, OpenClaw) : les chemins Windows exigent des doubles barres obliques inverses, C:\\Program Files\\.... Pas de commentaires, pas de virgule finale.
• TOML (Codex) : mettez les chemins Windows entre guillemets simples, comme le fait l’extrait de KwaFlux, ou doublez chaque barre oblique inverse.
• YAML (DeepSeek Harness, Hermes) : conservez l’indentation de l’extrait ; les guillemets simples gardent les barres obliques inverses telles quelles.

2. L’entrée est dans le mauvais fichier ou la mauvaise portée.

3. Node.js est introuvable. Sous Windows, l’hôte lance le serveur avec Node.js 18 ou plus récent. La carte des Paramètres de KwaFlux le cherche et écrit son chemin complet dans la configuration. Si la carte affiche « Node.js introuvable. Les hôtes lancent ce serveur avec Node.js 18 ou plus récent ; installez-le d’abord. » ou signale que votre Node.js « est trop ancien », installez la version LTS actuelle, cliquez sur Rechercher Node.js à nouveau et copiez de nouveau la configuration. Si vous avez écrit la configuration à la main avec un simple "node", remplacez-le par le chemin complet, par exemple C:\Program Files\nodejs\node.exe, ou redémarrez l’hôte pour qu’il prenne en compte le nouveau PATH.

4. Le chemin du serveur est faux. Le script est kwaflux_mcp.mjs, dans Tools\kwaflux-mcp à l’intérieur du dossier d’installation de KwaFlux. Si vous avez installé KwaFlux ailleurs que dans C:\Program Files\KwaFlux, copiez l’extrait depuis la carte Paramètres › Agent (MCP) de KwaFlux, qui renseigne le vrai chemin. Si la carte avertit « Aucun serveur MCP livré n’a été trouvé : le chemin ci-dessous n’est qu’un espace réservé », réinstallez KwaFlux.

5. L’hôte n’a pas été rechargé. Chaque hôte a sa méthode :

Guides pas à pas par hôte : Cursor, Claude Code et Claude Desktop, Codex, DeepSeek Harness, Hermes et OpenClaw.

Couche 2 : les outils apparaissent, mais les appels échouent avec app_not_running

C’est le cas le plus simple. Sous Windows, le message complet ressemble à ceci :

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

Il signifie que le serveur a bien démarré, mais qu’il n’a trouvé aucune instance de KwaFlux en cours d’exécution avec qui dialoguer. Solutions :

• Ouvrez KwaFlux et attendez que sa fenêtre soit affichée, puis reposez la question. Inutile de recharger l’hôte.
• Même ordinateur, même utilisateur. Le serveur ne joint qu’un KwaFlux qui tourne sur le même ordinateur, sous le même compte Windows ou macOS. Un agent sur un VPS, un Cloud Agent de Cursor ou une session ouverte sous un autre compte utilisateur ne peut pas l’atteindre.

Couche 3 : l’application refuse la tâche

Quand KwaFlux refuse une demande, le résultat de l’outil en donne la raison. Les plus fréquentes :

Les chemins réseau comme \\server\share\clip.mp4 sont refusés volontairement, avant l’ouverture de tout fichier. Copiez d’abord le fichier sur un disque local. Pour comprendre pourquoi, voyez les règles sur les chemins et la confidentialité.

Les attentes qui expirent

L’outil d’attente de KwaFlux patiente jusqu’à 300 secondes en un seul appel, 60 par défaut. Certains hôtes accordent moins que cela à un appel MCP :

Une attente expirée n’arrête pas la tâche. Celle-ci continue dans la liste des tâches de KwaFlux, et l’assistant peut attendre de nouveau ou vérifier son état.

Les tâches qui échouent ou ne produisent rien

• Lisez la cause d’erreur de la tâche. Demandez à l’assistant : « Récupère la tâche KwaFlux et dis-moi son erreur. » Le détail de la tâche contient la cause.
• Vérifiez où est allé le résultat. Les résultats sont enregistrés à côté du fichier d’entrée, pas dans un dossier choisi par l’assistant, et un fichier existant du même nom est conservé : le nouveau est renommé name(1).ext. Les fichiers convertis se terminent par _kwaflux_<format>-<tier>, les fichiers réparés par _repair.
• La réparation demande une référence. Si le diagnostic indique qu’un fichier de référence est nécessaire, fournissez un clip sain filmé avec la même caméra. Voyez Réparation de fichier vidéo.
• Non disponible depuis le chat. L’interpolation d’images ainsi que les outils de détourage et de remplacement ne sont pas proposés via MCP. Utilisez-les dans l’application.
• Ça échoue encore ? Réessayez une fois directement dans la fenêtre de KwaFlux. Si l’échec se reproduit, ce n’est pas un problème MCP : envoyez la cause d’erreur de la tâche au support.

Une vérification sans hôte IA

Si vous doutez que le serveur puisse même démarrer, lancez-le à la main dans un terminal :

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

Un serveur en bon état n’affiche rien et attend une entrée, parce qu’il attend qu’un hôte lui parle. Appuyez sur Ctrl+C pour l’arrêter. Si une erreur s’affiche à la place, par exemple « not recognized » (dans l’Invite de commandes en français : « n’est pas reconnu en tant que commande interne ou externe » ; Node.js n’est pas dans le PATH) ou « Cannot find module » (mauvais chemin), corrigez-la d’abord : aucun hôte ne fera mieux.

Aide-mémoire

Conclusion

Trouvez d’abord la couche. Pas d’outils : c’est la configuration de l’hôte ; app_not_running : l’application n’est pas ouverte sur cet ordinateur ; un refus donne lui-même sa raison ; un échec au bout d’une minute : c’est le délai d’expiration de l’hôte. En cas de doute, lancez le serveur à la main : s’il attend sans rien dire, le problème vient de l’hôte ou de l’application, pas du serveur.

Faites fonctionner KwaFlux avec votre assistant

KwaFlux intègre un serveur MCP local pour Cursor, Claude, Codex, DeepSeek Harness, Hermes, OpenClaw 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