Piloter KwaFlux depuis Codex, Claude, OpenClaw, DeepSeek, Hermes et Cursor

KwaFlux intègre un serveur MCP local. Laissez l’app ouverte et branchez Codex, Claude, OpenClaw, DeepSeek, Hermes ou Cursor. Convertir, réparer, améliorer et télécharger exigent une connexion et un forfait payant.

De quoi il s’agit

Oui, un agent IA peut piloter KwaFlux : l’app de bureau embarque un serveur MCP local auquel Codex, Claude, OpenClaw, DeepSeek (DSH), Hermes et Cursor peuvent se connecter. Ouvrez Paramètres › Avancé › Agent (MCP), copiez la configuration dans votre app de chat et laissez KwaFlux ouvert. La liaison passe par un stdio local sur cet ordinateur, sans étape OAuth.

Schéma : Codex, Claude, OpenClaw, DeepSeek, Hermes et Cursor se branchent en stdio local sur KwaFlux ouvert, sur le même ordinateur, sans envoi vers le cloud.

Où chaque hôte range la config

HôteOù
CodexAjoutez à ~/.codex/config.toml. La clé est mcp_servers. Redémarrez Codex, ou lancez /mcp.
Claude CodeLe .mcp.json du projet, ou la commande d’installation. Ouvrez une nouvelle session après la modification.
Claude DesktopFusionnez dans claude_desktop_config.json, puis quittez l’app et son processus, pas seulement la fenêtre. Sous Windows le fichier est dans %APPDATA%\Claude\.
OpenClawFusionnez sous mcp.servers dans ~/.openclaw/openclaw.json, ou lancez openclaw mcp set.
DeepSeekUn YAML de profil DSH. Redémarrez la session DSH.
HermesLancez hermes mcp add, ou écrivez mcp_servers dans config.yaml (%LOCALAPPDATA%\hermes sous Windows natif, ~/.hermes ailleurs).
CursorUtilisez l’installation intégrée à l’app, puis lancez Reload MCP dans Cursor.
Copiez l’extrait depuis Paramètres. Ne saisissez pas un chemin de dépôt à la main.

Ce que l’agent peut faire

Il vérifie si l’app tourne et si vous êtes connecté, liste les tâches et attend qu’une tâche se termine. Il peut aussi mettre en pause, reprendre, annuler ou relancer une tâche qu’il a lancée. Diagnostiquez un fichier abîmé avant de le réparer.

  • Convertir : exporte vers 64 formats selon un niveau de qualité, avec des préréglages pour YouTube, TikTok et d’autres plateformes, et transforme un intervalle de temps en GIF. Le fichier est enregistré à côté du fichier d’entrée.
  • Réparer : le diagnostic peut passer d’abord.
  • Améliorer : réparation de qualité, couleur, stabilisation, désentrelacement, effets intelligents et beauté. Le fichier est enregistré à côté du fichier d’entrée.
  • Télécharger : consulter un lien, puis l’enregistrer. Les téléchargements restent désactivés tant que vous n’avez pas choisi Demander à chaque fois sous Autorisation des agents. KwaFlux vous demande ensuite votre accord dans une fenêtre avant chaque téléchargement.
  • L’interpolation d’images reste dans l’app de bureau.
  • Le détourage et le remplacement de fond pour les personnes, les objets et le ciel restent dans l’app de bureau.
  • Cliquer sur un sujet dans une image en pause reste dans l’app de bureau.
  • L’agent ne peut pas piloter une tâche que vous avez lancée vous-même dans la fenêtre.

Les téléchargements restent coupés tant que vous ne les activez pas

Ouvrez Paramètres › Général et repérez Autorisation des agents. Autoriser les agents à lancer des téléchargements propose trois modes : désactivé, Demander à chaque fois, et un mode qui laisse passer les téléchargements sans demander. Avec Demander à chaque fois, KwaFlux affiche une fenêtre sur le bureau avec le lien, le dossier et le format, et seul votre clic l’approuve. Une fenêtre sans réponse expire au bout de 120 secondes. L’assistant vous demande aussi de confirmer dans le chat que vous avez le droit d’enregistrer le fichier, mais sa propre affirmation ne compte pas. KwaFlux ne se connecte pas à un site et ne contourne pas de paywall.

Limites

Les chemins doivent être absolus et pointer vers cet ordinateur. Convertir et améliorer n’autorisent pas l’agent à choisir le dossier de sortie. L’app est sur téléchargement.

Passer par un agent ne demande pas de licence en plus : une seule licence couvre l’app et son serveur MCP sur 2 ordinateurs au plus, Windows et Mac dans n’importe quelle combinaison. Les tâches lancées par un agent tournent sur cet ordinateur, et les fichiers multimédias ne sont pas envoyés pour être traités.

Ce qui reste dans la fenêtre

L’agent peut faire les tâches listées ci-dessus, et rien au-delà. Il peut vérifier si l’app est lancée et si vous êtes connecté. Il peut lister les tâches et attendre la fin de l’une d’elles. Il peut mettre en pause, reprendre, annuler ou relancer une tâche qu’il a démarrée. Il peut diagnostiquer un fichier endommagé avant une réparation. Il ne peut pas piloter une tâche que vous avez lancée vous-même en cliquant dans la fenêtre KwaFlux.

Convertir exporte vers 64 formats selon un niveau de qualité et peut transformer un intervalle de temps en GIF. Améliorer couvre la réparation de qualité, la couleur, la stabilisation, le désentrelacement, les effets intelligents et la beauté. Le fichier est enregistré à côté du fichier d’entrée, et l’agent ne peut pas choisir un autre dossier. Les chemins que vous lui donnez doivent être des chemins absolus sur cet ordinateur.

L’interpolation d’images, le détourage et le remplacement de fond, le clic sur un sujet dans une image en pause et les aperçus gratuits de 1, 3 et 5 secondes restent tous dans l’app de bureau. L’agent ne les lance pas.

Les téléchargements restent désactivés jusqu’à ce que vous les régliez sur Demander à chaque fois sous Autorisation des agents. KwaFlux vous demande ensuite votre accord dans une fenêtre avant chaque téléchargement. Une phrase de l’assistant ne vaut pas approbation. KwaFlux ne se connecte pas à un site à votre place et ne contourne pas de paywall. Le tableau des hôtes plus haut indique où chaque app range la config copiée depuis Paramètres. N’inventez pas un chemin. Laissez KwaFlux ouvert pendant que l’app de chat est reliée en stdio local.

Si la connexion échoue ou si une tâche plante

Regardez d’abord du côté de KwaFlux. Ouvrez Paramètres › Général. Dans Autorisation des agents, la ligne sous Autoriser les agents IA à piloter KwaFlux indique chaque hôte connecté en ce moment. Si elle affiche Aucun agent connecté, l’app de chat n’a jamais atteint KwaFlux : c’est donc de son côté qu’il faut chercher.

  • Lancez node --version dans un terminal. Le serveur demande Node.js 18 ou plus récent. Une version plus ancienne l’arrête dès le lancement, et le journal de l’hôte le dit en clair.
  • Codex : tapez /mcp dans l’interface du terminal pour voir les serveurs actifs, ou lancez codex mcp list.
  • Claude Code : claude mcp list affiche un état à côté de chaque serveur, par exemple Connected ou Failed to connect. Un serveur déclaré dans le .mcp.json d’un projet attend votre accord la première fois que vous lancez claude.
  • Claude Desktop : les journaux se trouvent dans %APPDATA%\Claude\logs sous Windows et dans ~/Library/Logs/Claude sur Mac. mcp.log couvre les connexions, et mcp-server-kwaflux.log contient les messages du serveur lui-même.
  • Cursor : ouvrez le panneau Output avec Ctrl+Maj+U (Cmd+Shift+U sur Mac) et choisissez MCP Logs dans la liste.

Une fois la connexion établie, une tâche ratée renvoie un code court, que les assistants ont tendance à reformuler. Actions récentes des agents, dans le même panneau, liste chaque appel avec son hôte et son résultat : vous lisez le code vous-même.

CodeCe que ça veut direQue faire
app_not_runningKwaFlux n’est pas ouvert sur cet ordinateur.Ouvrez KwaFlux, puis rechargez MCP ou relancez l’app de chat.
agent_control_disabledAutoriser les agents IA à piloter KwaFlux est désactivé.Réactivez-le dans Paramètres › Général › Autorisation des agents.
not_signed_in, entitlement_deniedLa tâche demande une connexion et une offre payante.Connectez-vous à KwaFlux et vérifiez votre offre.
app_busyTrop de tâches lancées en peu de temps.Attendez une minute, puis redemandez.
input_not_localLe chemin commence par deux barres obliques, comme \\server\share, ou c’est une adresse web.Copiez le fichier dans un dossier local et donnez son chemin complet.
model_not_installedLe modèle d’IA de cette fonction n’est pas encore sur l’ordinateur.Ouvrez la fonction dans KwaFlux et téléchargez son modèle, ou passez par Paramètres › Modèles et stockage.
agent_download_disabledLes téléchargements par agent sont encore désactivés.Si vous en avez besoin, choisissez Demander à chaque fois dans Autorisation des agents.
user_declined, approval_expiredVous avez refusé le téléchargement, ou la fenêtre est restée 120 secondes sans réponse.Redemandez quand vous êtes devant l’ordinateur.
Les codes que renvoie le plus souvent le serveur MCP de KwaFlux

Chaque tâche ajoutée par un agent déclenche aussi une courte notification qui nomme l’hôte, par exemple « Codex a ajouté une tâche ». La tâche apparaît dans le centre des tâches à côté des vôtres. Si vous pensez que le jeton d’accès a fuité, cliquez sur Réinitialiser le jeton d’accès des agents au bout de la ligne de connexion. Les connexions en cours tombent, et les hôtes configurés se reconnectent avec le nouveau jeton à leur prochain appel.

Testez sur vos propres images

Téléchargez KwaFlux et prévisualisez gratuitement les effets sur vos propres images avant de payer. Aucun compte n’est nécessaire. Vos médias sont traités sur votre GPU, sans être envoyés pour le traitement. Les aperçus vidéo durent 1, 3 ou 5 secondes, ceux de la stabilisation 5, 15 ou 30 secondes.

Questions fréquentes

Puis-je piloter KwaFlux depuis Claude, Cursor ou un autre assistant IA ?

Oui. KwaFlux inclut un serveur MCP local qui fonctionne via stdio, pour que des clients comme Codex, Claude et Cursor puissent le piloter. Laissez KwaFlux ouvert, copiez la configuration de Paramètres → Avancé → Agent (MCP) dans l’app d’IA et installez Node.js 18 ou plus récent. L’app d’IA s’en sert pour lancer le serveur.

Pourquoi n’y a-t-il pas de bouton Authenticate pour KwaFlux ?

Parce que le serveur MCP de KwaFlux tourne en local via stdio, et non à une URL distante. Il n’y a donc pas d’étape OAuth.

L’agent peut-il exporter ou convertir gratuitement dans KwaFlux ?

Non, KwaFlux exige une connexion et un forfait payant pour convertir, réparer, améliorer et télécharger via MCP. Les aperçus gratuits de 1 s, 3 s et 5 s restent dans l’app de bureau.

L’agent peut-il lancer des téléchargements dans KwaFlux ?

Oui, une fois Autoriser les agents à lancer des téléchargements réglé sur Demander à chaque fois. KwaFlux vous demande alors votre accord dans une fenêtre avant chaque téléchargement, et l’assistant ne peut pas l’approuver à votre place.

Pourquoi KwaFlux refuse-t-il mon chemin de fichier ?

Les chemins doivent être des chemins complets sur cet ordinateur, comme C:\Videos\clip.mp4 ou /Users/you/Movies/clip.mp4. Un chemin relatif échoue. Un chemin qui commence par deux barres obliques, comme \\server\share\clip.mp4, aussi. KwaFlux refuse ce type de chemin avant d’ouvrir quoi que ce soit, car sous Windows, le simple fait de vérifier ce fichier peut lancer une authentification auprès du serveur. Copiez d’abord le fichier dans un dossier local.

Comment voir ce que l’agent a fait dans KwaFlux ?

Dans KwaFlux, ouvrez Paramètres › Général › Autorisation des agents et regardez Actions récentes des agents. Chaque ligne indique l’heure, l’hôte, l’appel et le résultat. Les tâches ajoutées par l’agent figurent aussi dans le centre des tâches, chacune annoncée par une notification qui nomme l’hôte.

Les Cloud Agents de Cursor peuvent-ils utiliser un serveur MCP local ?

Non. Un serveur stdio local est un programme installé sur votre ordinateur. Les Cloud Agents tournent sur l’infrastructure de Cursor : ils ne peuvent pas le lancer. Utilisez l’agent de l’application de bureau Cursor, sur le même ordinateur.

Pourquoi faut-il doubler les barres obliques inverses dans mcp.json ?

Parce que JSON traite une barre oblique inverse comme le début d’une séquence d’échappement. C:\\Program Files est la forme JSON valide de C:\Program Files. Avec une barre seule, le fichier ne peut pas être analysé. Les barres obliques classiques (/) fonctionnent aussi.

Pourquoi Claude Desktop ne voit-il pas un nouveau serveur MCP ?

En général parce qu’il tourne encore en arrière-plan. Fermez la fenêtre et quittez l’application depuis la zone de notification ou la barre des menus, puis rouvrez-la. Un JSON invalide, par exemple une barre oblique inverse seule dans un chemin Windows, est la deuxième chose à vérifier.

Claude Code sur le web voit-il mon KwaFlux local ?

Non. Le serveur KwaFlux est un programme local que l’hôte lance sur votre ordinateur. Les sessions cloud chargent les serveurs distants d’un .mcp.json de projet, pas un processus Node à côté de KwaFlux. Utilisez Claude Code ou Claude Desktop sur la machine où l’appli est ouverte.

À quoi sert tool_timeout_sec dans Codex ?

C’est le temps pendant lequel Codex attend un appel d’outil MCP avant d’abandonner : 60 secondes par défaut. Augmentez-le pour les serveurs dont les outils peuvent mettre plus de temps à répondre, comme un outil qui attend la fin d’un export vidéo. Voyez comment sont gérés les traitements longs.

Pourquoi mettre les chemins Windows entre guillemets simples dans config.toml ?

Parce qu’en TOML, une chaîne entre guillemets simples est littérale : les barres obliques inverses restent telles quelles. Entre guillemets doubles, une barre oblique inverse ouvre une séquence d’échappement, si bien que C:\Program Files devrait s’écrire C:\\Program Files.

Faut-il refaire le MCP dans l’appli bureau ChatGPT ?

Non. La page MCP d’OpenAI indique que l’appli bureau ChatGPT, le CLI et l’extension IDE partagent la config de l’hôte Codex. Ajoutez KwaFlux une fois dans ~/.codex/config.toml, puis ouvrez Codex dans n’importe lequel. ChatGPT sur le web ne lit pas ce fichier.

Où ajouter un serveur MCP dans DeepSeek Harness ?

Dans un fichier cordis.patch.yml, sous forme de ligne insert pour le plugin @deepseek-ai/dsh-mcp-client. Utilisez le fichier propre à un profil pour ce seul profil, ou le fichier global ~/.dsh/cordis.patch.yml pour tous les profils.

Le fichier patch est `[]`. Faut-il coller KwaFlux en dessous ?

Non, remplacez le [] par le bloc - insert: de KwaFlux. Un fichier qui a à la fois [] et un autre élément de liste n’est pas du YAML valide, et DSH s’arrête sur une erreur d’analyse. Un nouveau patch de profil commence souvent par cette liste vide.

Un agent sur un VPS peut-il utiliser un serveur MCP local sur mon PC ?

Non, pas un serveur stdio. Un serveur stdio tourne comme processus enfant de l’agent, sur la même machine. Pour en utiliser un sur votre PC, faites aussi tourner l’agent sur ce PC. Voyez ce qu’est un agent IA pour comprendre comment les éléments s’articulent.

Pourquoi un serveur MCP échoue-t-il avec « node is not recognized » (« node n’est pas reconnu ») ?

Parce que Node.js n’est pas installé, ou n’est pas dans le PATH que voit l’hôte. Installez-le, puis quittez et relancez l’hôte. Si cela ne suffit pas, indiquez le chemin complet de node.exe dans le command du serveur.

Pourquoi les longs appels d’outils MCP expirent-ils ?

Parce que certains hôtes, comme Codex et DeepSeek Harness, limitent par défaut un appel d’outil à 60 secondes. Or certains outils KwaFlux sont conçus pour attendre plus longtemps. Augmentez le délai d’expiration des outils que l’hôte applique à ce serveur. La tâche elle-même continue en général de tourner.

L’hôte dit `env: node: No such file or directory` sur Mac. Que faire ?

L’hôte a sans doute été ouvert depuis le Dock ou Spotlight. Il ne reçoit donc pas le PATH du Terminal et ne voit pas Node.js installé avec Homebrew ou nvm. Sur Mac, le lanceur de KwaFlux exécute le node présent dans ce PATH. Lancez which node dans Terminal. Puis mettez dans l’env du serveur un PATH avec ce dossier et /usr/bin:/bin, par exemple /opt/homebrew/bin:/usr/bin:/bin. Ou lancez l’hôte depuis Terminal. Plus de notes Mac : KwaFlux sur Mac.

Sources

  1. Model Context Protocol: What is the Model Context Protocol (MCP)? (consulté le 2026-10-11)
  2. Model Context Protocol specification: Transports (stdio) (consulté le 2026-10-11)
  3. Node.js: Node.js releases (consulté le 2026-10-11)
  4. Model Context Protocol: Connect to local MCP servers (troubleshooting and Claude Desktop logs) (consulté le 2026-11-08)
  5. Claude Code docs: Connect Claude Code to tools via MCP (claude mcp list and server status) (consulté le 2026-11-08)
  6. OpenAI Codex docs: Model Context Protocol (codex mcp list and /mcp) (consulté le 2026-11-08)
  • tutoriel
  • IA locale
  • logiciel de bureau
  • MCP

Articles liés

Auteur et éditeur chez KwaFlux. Les articles sont relus par la rédaction de KwaFlux et s’appuient sur nos notes de recherche produit et les spécifications publiées.