Utiliser KwaFlux depuis Claude Code et Claude Desktop (configuration MCP)

L’essentiel

• Claude Code se connecte à KwaFlux avec une seule commande claude mcp add, que KwaFlux génère pour vous ; Claude Desktop, avec une seule entrée dans claude_desktop_config.json.
• Dans Claude Code, utilisez la portée utilisateur (user), pour que KwaFlux soit disponible dans tous vos projets et pas dans un seul dossier.
• Après avoir modifié sa configuration, quittez Claude Desktop pour de bon, y compris depuis la zone de notification, sinon il ne chargera pas le serveur.
• Les deux clients demandent votre accord avant d’exécuter des outils MCP, et /mcp dans Claude Code indique si KwaFlux est connecté et combien d’outils il propose.

Claude peut piloter KwaFlux sur votre ordinateur grâce au serveur MCP local installé avec l’application. Pour Claude Code, KwaFlux vous fournit une commande claude mcp add prête à l’emploi. Pour Claude Desktop, il vous fournit une entrée JSON à fusionner dans claude_desktop_config.json. Dans les deux cas, gardez KwaFlux ouvert pendant que Claude travaille.

Dans ce guide, vous verrez comment connecter chaque client Claude, où se trouve sa configuration, comment vérifier la connexion, quoi demander en premier et comment régler les problèmes habituels.

Sommaire

1. Claude Code ou Claude Desktop ?
2. Avant de commencer
3. Claude Code : une seule commande
4. Claude Code : le partager avec un projet
5. Claude Desktop : modifier la configuration
6. Vos premières demandes
7. Longs traitements et délais d’expiration
8. Dépannage
9. Questions fréquentes

Claude Code ou Claude Desktop ?

Claude Code est l’agent de programmation d’Anthropic pour le terminal et les IDE ; Claude Desktop est l’application de chat Claude pour Windows et macOS. Les deux savent faire tourner des serveurs MCP locaux, et les deux peuvent utiliser KwaFlux.

Si vous voulez surtout parler de vos vidéos avec Claude, Claude Desktop est le point de départ le plus simple. Si vous travaillez déjà dans un terminal ou un IDE, Claude Code s’y intègre naturellement. Pour les autres assistants, voyez notre comparatif.

Avant de commencer

• KwaFlux 1.0.14 ou plus récent, ouvert. Le serveur MCP dialogue avec l’application en cours d’exécution.
• Node.js 18 ou plus récent, dans le PATH. La carte des Paramètres de KwaFlux l’indique : « L’hôte lance le serveur via Node.js 18 ou plus récent : Node doit être installé et présent dans le PATH. » Si node --version échoue, 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 : ouvrez Paramètres › Agent (MCP), choisissez Claude sous Hôte MCP, puis sélectionnez Claude Code ou Claude Desktop.

Claude Code : une seule commande

1. Avec Claude Code sélectionné, cliquez sur Copier la commande d’install.
2. Collez-la dans un terminal et exécutez-la. Pour une installation Windows par défaut, elle donne :

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

3. Ouvrez une nouvelle session Claude Code et lancez /mcp. Vous devez voir kwaflux connecté, avec son nombre d’outils.

Deux éléments de cette commande comptent :

• **--scope user** enregistre le serveur dans ~/.claude.json pour tous vos projets. La portée par défaut de Claude Code, local, ferait apparaître KwaFlux uniquement dans le dossier où vous avez lancé la commande.
• **--** sépare les options propres à Claude de la commande qui démarre le serveur. La documentation de Claude Code précise que « tout ce qui suit -- est transmis au serveur sans modification ».

Claude Code : le partager avec un projet

L’indication de KwaFlux propose aussi un fichier de projet : « Ajoutez au .mcp.json à la racine du projet, ou lancez la CLI. » Le .mcp.json d’un projet sert à partager des serveurs avec toutes les personnes qui travaillent dans ce dossier, via le contrôle de version. Utilisez-le si une équipe garde un projet vidéo dans un dépôt et que chacun a installé KwaFlux au même endroit.

Avec Claude Code sélectionné, cliquez sur Copier la config et enregistrez le résultat sous le nom .mcp.json à la racine du projet :

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

Claude Code demande une approbation avant d’utiliser, en session interactive, les serveurs du .mcp.json d’un projet. Tant que vous n’avez pas approuvé, /mcp affiche le serveur comme en attente.

Claude Desktop : modifier la configuration

1. Dans KwaFlux, choisissez Claude › Claude Desktop et cliquez sur Copier la config.
2. Dans Claude Desktop, ouvrez Settings (réglages) depuis le menu Claude, allez dans Developer (développeur) et cliquez sur Edit Config (modifier la configuration). Cela ouvre, ou crée : - Windows : %APPDATA%\Claude\claude_desktop_config.json - macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
3. Fusionnez l’entrée kwaflux dans mcpServers. Ne supprimez pas les serveurs déjà présents.
4. Quittez Claude Desktop pour de bon, y compris l’icône de la zone de notification ou de la barre des menus, puis rouvrez-le. L’indication de KwaFlux insiste sur ce point : après la modification, il faut quitter Claude Desktop pour de bon.
5. Dans une conversation, ouvrez le menu en bas à gauche de la zone de saisie, allez dans Connectors (connecteurs) et vérifiez que kwaflux y figure, avec ses outils.

Claude Desktop demande votre accord avant chaque exécution d’outil, sauf si vous autorisez un outil pour toute la conversation.

Vos premières demandes

Commencez par une vérification en lecture seule :

Utilise les outils KwaFlux pour vérifier que KwaFlux est lancé et que je suis connecté.

Passez ensuite à de vrais traitements, avec des chemins locaux complets :

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.

Astuce : dans Claude Code, les outils de KwaFlux apparaissent sous la forme mcp__kwaflux__<tool>, par exemple mcp__kwaflux__kwaflux_get_app_status. Utilisez ces noms pour autoriser les outils en lecture seule dans vos règles de permission : Claude ne vous demandera plus votre accord à chaque fois qu’il consulte la liste des tâches.

Longs traitements et délais d’expiration

Un traitement vidéo peut prendre plusieurs minutes. L’outil d’attente de KwaFlux attend jusqu’à 300 secondes par appel, 60 par défaut, puis indique si la tâche est terminée. Si ce n’est pas le cas, Claude peut simplement relancer l’attente.

Si le serveur lui-même démarre lentement sur une machine peu puissante, la documentation de Claude Code décrit la variable d’environnement MCP_TIMEOUT pour le démarrage, par exemple MCP_TIMEOUT=10000 claude. Pour les appels d’outil, une entrée de .mcp.json dans un projet accepte un champ timeout en millisecondes. Réglez-le au-dessus de 300 000 si vous demandez de longues attentes.

Dépannage

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

Conclusion

Dans Claude Code, lancez la commande que KwaFlux copie pour vous, avec la portée user, et vérifiez /mcp. Dans Claude Desktop, fusionnez l’entrée dans claude_desktop_config.json et quittez l’application pour de bon avant de la rouvrir. Gardez ensuite KwaFlux ouvert et commencez par une vérification de l’état.

Pilotez KwaFlux depuis Claude

KwaFlux intègre un serveur MCP local pour Claude Code, Claude Desktop 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