Utiliser KwaFlux depuis Cursor : configuration MCP, premières demandes et dépannage

L’essentiel

• L’agent de Cursor peut piloter KwaFlux via le serveur MCP local fourni avec l’application. La mise en place tient en un bouton dans KwaFlux, ou en une entrée dans mcp.json.
• Gardez KwaFlux ouvert et Node.js installé. Le serveur est un programme local sur votre ordinateur : les agents cloud de Cursor ne peuvent pas l’atteindre.
• Par défaut, Cursor demande votre accord avant d’exécuter des outils MCP. Validez d’abord les outils en lecture seule pour vérifier la connexion.
• La plupart des échecs de configuration ont trois causes : un chemin Windows non échappé dans le JSON, une modification du mauvais mcp.json, et l’oubli du rechargement.

L’agent de Cursor peut piloter KwaFlux sur votre ordinateur grâce au serveur MCP local installé avec l’application. Dans KwaFlux, ouvrez Paramètres › Agent (MCP), choisissez Cursor et cliquez sur Installer dans Cursor, ou collez une entrée dans le mcp.json de Cursor. Demandez ensuite à l’agent de diagnostiquer, réparer, convertir ou améliorer une vidéo.

La mise en place prend environ cinq minutes. Cursor fait tourner le serveur, KwaFlux se charge du traitement.

Dans ce guide, vous verrez les deux façons d’ajouter KwaFlux à Cursor, comment vérifier la connexion, quoi demander en premier et comment régler les problèmes habituels.

Sommaire

1. Que fait Cursor d’un serveur MCP ?
2. Avant de commencer
3. Méthode 1 : installer depuis KwaFlux avec un bouton
4. Méthode 2 : modifier mcp.json vous-même
5. Vérifier la connexion
6. Vos premières demandes
7. Validations et exécution automatique
8. Dépannage
9. Questions fréquentes

Que fait Cursor d’un serveur MCP ?

Un serveur MCP donne des outils supplémentaires à l’agent de Cursor. Pour un serveur local (stdio), Cursor lance le programme sur votre ordinateur au chargement, et l’agent appelle ses outils quand une demande en a besoin.

Le serveur de KwaFlux est un script Node.js fourni avec l’application. Ses outils vérifient l’état de l’application, mettent en file d’attente des traitements comme la conversion, la réparation et l’amélioration, et attendent qu’ils se terminent. Pour savoir ce qu’est un agent et comment fonctionne cette boucle, voyez qu’est-ce qu’un agent IA.

Avant de commencer

À noter : sur Mac, l’extrait de KwaFlux pointe vers un utilitaire intégré à l’application (<KwaFlux.app>/Contents/Helpers/kwaflux-mcp-run) au lieu d’un chemin de script. Copiez-le depuis l’application, pour que l’emplacement réel soit renseigné.

Méthode 1 : installer depuis KwaFlux avec un bouton

1. Dans KwaFlux, ouvrez Paramètres et allez dans Agent (MCP).
2. Sous Hôte MCP, choisissez Cursor.
3. Cliquez sur Installer dans Cursor. KwaFlux copie la configuration et ouvre Cursor avec un lien d’installation.
4. Validez l’installation dans Cursor.
5. Comme l’indique KwaFlux : « Après l’installation, rechargez MCP dans Cursor. »

Quand vous cliquez, KwaFlux copie la configuration et affiche « Configuration copiée, ouverture de Cursor — collez manuellement si rien ne s'ouvre ». Si Cursor ne s’ouvre pas, passez à la méthode 2 : la configuration est déjà dans votre presse-papiers.

Le bouton ouvre un lien de cette forme, avec la configuration encodée à la fin :

cursor://anysphere.cursor-deeplink/mcp/install?name=kwaflux&config=eyJjb21tYW5kIjoiQzpcXFByb2dyYW0gRmlsZXNcXG5vZGVqc1xcbm9kZS5leGUiLCJhcmdzIjpbIkM6XFxQcm9ncmFtIEZpbGVzXFxLd2FGbHV4XFxUb29sc1xca3dhZmx1eC1tY3BcXGt3YWZsdXhfbWNwLm1qcyJdfQ

C’est le lien d’une installation Windows par défaut. Le vôtre peut différer si vous avez installé KwaFlux ailleurs.

Méthode 2 : modifier mcp.json vous-même

Cursor lit les serveurs MCP dans deux fichiers :

KwaFlux est une application de bureau, pas un élément d’un projet : utilisez le fichier global.

1. Dans KwaFlux, choisissez Cursor sous Hôte MCP et cliquez sur Copier la config.
2. Ouvrez ~/.cursor/mcp.json, ou créez-le.
3. Si le fichier est nouveau, collez tout l’extrait. S’il contient déjà des serveurs, ajoutez seulement l’entrée kwaflux dans le mcpServers existant.

Pour une installation Windows par défaut, l’extrait est le suivant :

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

4. Enregistrez, puis redémarrez Cursor, ou désactivez et réactivez le serveur sous Customize (personnaliser).

Astuce : gardez les doubles barres obliques inverses. En JSON, une \ seule ouvre une séquence d’échappement : C:\Program Files rend tout le fichier invalide, et Cursor ignore alors tous les serveurs qu’il contient, pas seulement KwaFlux.

Vérifier la connexion

1. Ouvrez Customize dans la barre latérale de Cursor et cherchez kwaflux. Il doit être activé, avec ses outils listés.
2. Dans le chat de l’agent, demandez :

KwaFlux est-il lancé ? Vérifie avec les outils KwaFlux.

L’agent appelle kwaflux_get_app_status. Si KwaFlux est ouvert, la réponse indique notamment si vous êtes connecté. S’il est fermé, l’outil renvoie une erreur qui commence par app_not_running. Ouvrez KwaFlux et reposez la question.

3. Demandez votre liste de tâches. Une liste vide n’est pas un problème : elle montre que toute la chaîne fonctionne.

Vos premières demandes

Donnez des chemins locaux complets, et précisez à quoi doit servir le résultat :

Chaque tâche apparaît dans la liste des tâches de KwaFlux : vous pouvez l’y suivre, la mettre en pause ou l’annuler. Pour le détail des conversions, voyez Convertisseur.

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.

Validations et exécution automatique

La documentation de Cursor indique qu’il « demande une approbation avant d’utiliser les outils MCP par défaut », et que les outils MCP suivent les mêmes Run Modes (modes d’exécution) que les commandes du terminal. C’est un réglage par défaut raisonnable pour KwaFlux :

• Les outils en lecture seule, comme l’état de l’application, la liste des tâches, le détail d’une tâche et la liste des formats d’export, peuvent être ajoutés sans risque à la liste d’autorisation.
• Les outils qui mettent des traitements en file d’attente écrivent de nouveaux fichiers à côté de votre source. Continuez à les valider vous-même jusqu’à ce que vous ayez confiance dans vos demandes.

Dépannage

Pour les problèmes qui ne sont pas propres à Cursor, voyez le guide de dépannage MCP de KwaFlux.

Conclusion

Cliquez sur Installer dans Cursor, ou collez une entrée dans ~/.cursor/mcp.json. Rechargez ensuite, gardez KwaFlux ouvert et demandez à l’agent de vérifier l’état de l’application avant votre premier vrai traitement. Après cela, conversions, réparations et améliorations peuvent partir du chat de Cursor et apparaître dans la liste des tâches de KwaFlux.

Pilotez KwaFlux depuis Cursor

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