Utiliser KwaFlux depuis Codex : configuration MCP, délais d’expiration et validations

L’essentiel

• Codex se connecte à KwaFlux avec une seule commande codex mcp add, ou avec une table [mcp_servers.kwaflux] dans ~/.codex/config.toml. KwaFlux génère les deux.
• Par défaut, Codex accorde 60 secondes à un appel d’outil MCP, alors que l’outil d’attente de KwaFlux peut patienter jusqu’à 300. Augmentez tool_timeout_sec pour que les longs traitements vidéo ne soient pas interrompus.
• La ligne de commande n’ajoute pas le délai d’expiration de 20 secondes au démarrage que contient le TOML de KwaFlux. Ajoutez-le si le serveur met du temps à démarrer.
• Les modes de validation de Codex vous permettent de laisser passer les outils KwaFlux en lecture seule tout en gardant une demande d’accord avant les traitements qui écrivent des fichiers.

Le Codex d’OpenAI peut piloter KwaFlux grâce au serveur MCP local installé avec l’application. Dans les Paramètres de KwaFlux, choisissez Codex, copiez la commande d’installation ou la table TOML, ajoutez-la à Codex et laissez KwaFlux ouvert. Pour le travail vidéo, deux réglages méritent d’être modifiés : le délai d’expiration des outils et le mode de validation.

Dans ce guide, vous verrez les deux façons d’ajouter KwaFlux à Codex, les délais d’expiration qui comptent pour les longs traitements, comment contrôler les validations et quoi demander en premier.

Sommaire

1. Comment Codex lance un serveur MCP
2. Avant de commencer
3. Méthode 1 : codex mcp add
4. Méthode 2 : modifier config.toml
5. Délais d’expiration pour les longs traitements vidéo
6. Validations et listes d’outils
7. Vos premières demandes
8. Dépannage
9. Questions fréquentes

Comment Codex lance un serveur MCP

Au début de chaque session, Codex démarre les serveurs MCP locaux déclarés dans sa configuration et communique avec eux par l’entrée et la sortie standard. Les outils du serveur apparaissent alors au modèle à côté de ceux de Codex. La CLI Codex et l’application de bureau Codex utilisent la même configuration.

Le serveur de KwaFlux est un script Node.js installé avec l’application. Il ne traite rien lui-même : il transmet les demandes à l’application KwaFlux en cours d’exécution, qui les vérifie et lance les traitements.

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 ; au besoin, installez la version LTS actuelle depuis nodejs.org. 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.
• Dans KwaFlux : Paramètres › Agent (MCP), puis choisissez Codex sous Hôte MCP.

Méthode 1 : codex mcp add

Cliquez sur Copier la commande d’install et lancez-la dans un terminal. Pour une installation Windows par défaut, elle donne :

codex mcp add kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Nous l’avons lancée avec la CLI Codex 0.118.0, qui a affiché Added global MCP server 'kwaflux'. Vérifiez ensuite :

codex mcp list

KwaFlux doit apparaître comme activé. La commande écrit dans ~/.codex/config.toml une table qui ne contient que command et args. La suite explique les deux lignes qu’il vaut la peine d’ajouter à la main.

Méthode 2 : modifier config.toml

Cliquez plutôt sur Copier la config, puis ajoutez la table à la fin de ~/.codex/config.toml, ou de .codex/config.toml dans un projet de confiance :

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20

Comme le rappelle l’indication de KwaFlux : « La clé est mcp_servers (underscore). » Redémarrez ensuite Codex, ou lancez /mcp dans une session pour voir le serveur.

À noter : les guillemets simples autour du chemin sont voulus. En TOML, une chaîne entre guillemets simples est littérale : les barres obliques inverses de Windows n’ont pas besoin d’être échappées. Entre guillemets doubles, il faudrait écrire \\ pour chacune.

Délais d’expiration pour les longs traitements vidéo

La documentation MCP de Codex prévoit deux délais d’expiration par serveur :

C’est le second qui compte le plus. Quand Codex demande à KwaFlux d’attendre un export, l’outil d’attente bloque jusqu’à la fin de la tâche ou jusqu’à sa propre limite, 300 secondes au plus. Avec les 60 secondes par défaut de Codex, une attente plus longue est coupée côté Codex, et le modèle risque de la prendre pour un échec. Indiquez :

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20
tool_timeout_sec = 330

Dans les deux cas, la tâche continue dans KwaFlux. Un dépassement de délai met seulement fin à cette attente-là, et Codex peut revérifier la tâche.

Validations et listes d’outils

Codex vous laisse choisir, serveur par serveur, à quel moment il demande votre accord avant d’exécuter un outil. Sa documentation liste auto, prompt, writes et approve pour default_tools_approval_mode, où writes « demande une validation pour les outils qui ne sont pas marqués en lecture seule ». Ce mode convient bien à KwaFlux : les appels d’état et de liste des tâches passent directement, et les traitements qui écrivent des fichiers demandent quand même votre accord.

Vous pouvez aussi restreindre ce que Codex charge avec enabled_tools, une liste d’autorisation, ou disabled_tools, une liste de blocage. Par exemple, si vous n’utilisez Codex que pour convertir et réparer, ne listez que les outils de tâches, de conversion et de réparation. Moins d’outils, c’est aussi plus de place dans le contexte du modèle, comme l’explique notre article sur la conception des outils.

Vos premières demandes

Vérifie si KwaFlux est lancé et liste mes tâches KwaFlux récentes.

Ensuite :

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

Ajoutez KwaFlux avec la commande ou le TOML que KwaFlux copie pour vous, puis ajoutez deux lignes : un délai d’expiration de 20 secondes au démarrage et de 330 secondes pour les appels d’outil. Choisissez le mode de validation writes si vous voulez que Codex ne demande votre accord qu’avant les traitements qui créent des fichiers. Gardez KwaFlux ouvert et commencez par une vérification d’état.

Pilotez KwaFlux depuis Codex

KwaFlux intègre un serveur MCP local pour Codex 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