rdp-cli

Comment laisser Claude Code contrôler un bureau Windows distant

Claude Code est très efficace pour le code, les fichiers et les commandes, mais de nombreuses tâches nécessitent encore un vrai bureau Windows : ouvrir Excel, utiliser un ancien logiciel, gérer des boîtes de dialogue ou travailler avec une application sans API.

La solution pratique consiste à connecter Claude Code à un outil de bureau distant via MCP. MCP fournit l’interface des outils, RDP fournit la connexion Windows, et Claude Code choisit l’étape suivante.

Architecture de base

Claude Code
  ↓
Serveur MCP de bureau distant
  ↓
rdp-cli ou un autre contrôleur de bureau
  ↓
Bureau Windows distant

Le serveur MCP doit exposer des outils simples : connect, screenshot, click, type, key, upload_file, download_file, status et disconnect. N’ouvrez pas un shell distant sans restriction si ce n’est pas indispensable.

Observer avant d’agir

Cliquer à partir d’une ancienne capture est l’une des principales causes d’échec. La boucle fiable est :

Capture → Décision → Une action → Nouvelle capture → Vérification
rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x 420 --y 260 --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

La première image permet de trouver la bonne fenêtre. L’observation récente évite d’envoyer une action sur un écran obsolète. La seconde image confirme le résultat. Une commande réussie signifie seulement que l’entrée a été envoyée : une erreur, une demande d’autorisation ou une autre fenêtre peut apparaître.

Exemple pratique

Pour ouvrir une application de rapports, importer sales.csv, produire report.pdf et récupérer le fichier, utilisez des transferts structurés :

rdp-cli files upload --session SESSION --local ./sales.csv --path input/sales.csv
rdp-cli files download --session SESSION --path output/report.pdf --local ./report.pdf

Donnez à Claude Code des critères de vérification précis :

Connecte-toi au bureau Windows distant.
Ouvre l’application de rapports, importe input/sales.csv, crée le rapport mensuel et exporte output/report.pdf.
Après chaque action graphique, prends une nouvelle capture et confirme que la fenêtre attendue est visible.
Si l’écran est différent, arrête-toi et signale le problème. Ne répète pas une action incertaine sans vérifier l’état de la session.

Si une API ou une commande suffit, utilisez-la en priorité. Réservez RDP aux étapes qui ont réellement besoin d’une interface graphique.