Docs
Piloter KwaFlux depuis un assistant IA avec MCP
L’installateur de KwaFlux 1.0.8 inclut un serveur MCP (Model Context Protocol) local. Un assistant IA sur le même ordinateur peut consulter l’état de l’app, mettre des tâches en file et suivre leur progression ; le traitement des médias reste assuré par KwaFlux sur votre propre GPU.
Mis à jour le · KwaFlux 1.0.8
Avant de commencer
- KwaFlux 1.0.8 ou plus récent est installé et ouvert sur le même ordinateur.
- Node.js 18 ou plus récent est installé et dans le PATH. L’installateur fournit le script MCP, pas l’environnement Node.js.
- Une app d’assistant compatible MCP : Codex, Claude Code ou Claude Desktop, OpenClaw, DeepSeek (DSH), Hermes ou Cursor.
Connecter votre assistant
- Dans KwaFlux, ouvrez Réglages → Agent (MCP).
- Copiez l’extrait correspondant à votre assistant dans sa configuration MCP. Ajoutez l’entrée kwaflux sans remplacer tout le fichier.
- Rechargez MCP dans l’assistant et gardez KwaFlux ouvert pendant l’utilisation.
Ce que l’assistant peut faire
- Lire l’état de l’app et la liste des tâches, suivre la progression d’une tâche et attendre sa fin.
- Mettre en file des exports d’amélioration pour une vidéo avec 16 modules : réparation de qualité, Étalonnage IA, stabilisation vidéo, ralenti IA, désentrelacement, recadrage intelligent, cartoonisation, génération d’esquisse, transfert de style fixe, rééclairage du visage et les six modules Beauté IA.
- Convertir le format d’un fichier, vérifier si un fichier média est endommagé et le réparer.
- Analyser un lien et le télécharger. Les téléchargements par agent restent désactivés tant que vous ne les autorisez pas dans les réglages, et chaque téléchargement demande votre propre confirmation dans le chat.
- Mettre en pause, reprendre, annuler ou relancer des tâches.
Connexion et forfait
- Lire l’état, vérifier si un fichier est endommagé et mettre en pause ou annuler des tâches fonctionnent sans connexion.
- Comme dans l’app, les exports (tâches d’amélioration comprises), les conversions, les réparations de fichiers et les téléchargements depuis un lien exigent une connexion et un forfait payant. C’est aussi le cas pour reprendre ou relancer l’une de ces tâches.
- Les aperçus gratuits de 1 s, 3 s et 5 s restent dans l’app de bureau ; l’assistant ne les calcule pas.
Fichiers et connexion
- Les exports, conversions et réparations sont écrits à côté du fichier source. Les téléchargements vont dans un dossier existant de votre choix.
- Seuls les chemins de cet ordinateur sont acceptés. Les chemins réseau sont refusés avant tout accès à un fichier.
- La connexion est un stdio local : pas d’URL distante, pas d’OAuth et pas de bouton Authenticate. Sous Windows, elle passe par un canal nommé réservé à votre compte ; sur Mac, par un socket que seul votre compte peut ouvrir.
- Les nouvelles tâches sont limitées à environ 10 par minute.
Dépannage
app_not_runningOuvrez KwaFlux, puis rechargez MCP dans l’assistant.- Les outils restent en chargement : vérifiez que Node.js 18 ou plus récent est installé et dans le PATH, puis rechargez MCP.
not_signed_in / entitlement_deniedConnectez-vous à KwaFlux avec un compte qui a un forfait payant.agent_download_disabledAutorisez d’abord les téléchargements par agent dans les réglages.
Configuration assistant par assistant : Piloter KwaFlux depuis Codex, Claude, OpenClaw, DeepSeek, Hermes et Cursor.