rdp-cli

So lässt du Claude Code einen entfernten Windows-Desktop steuern

Claude Code arbeitet sehr gut mit Code, Dateien und Kommandozeilen-Tools. Viele praktische Aufgaben benötigen jedoch einen echten Windows-Desktop: Excel öffnen, alte Software bedienen, Dateidialoge ausfüllen oder Anwendungen ohne API verwenden.

Die praktische Lösung ist eine Verbindung von Claude Code mit einem Remote-Desktop-Tool über MCP. MCP stellt die Werkzeugschnittstelle bereit, RDP verbindet den Windows-Rechner, und Claude Code entscheidet über den nächsten Schritt.

Die Grundarchitektur

Claude Code
  ↓
MCP-Server für den Remote-Desktop
  ↓
rdp-cli oder ein anderer Desktop-Controller
  ↓
Entfernter Windows-Desktop

Der MCP-Server sollte kleine, klar begrenzte Werkzeuge anbieten: connect, screenshot, click, type, key, upload_file, download_file, status und disconnect. Eine uneingeschränkte Remote-Shell sollte nur bei echtem Bedarf freigeschaltet werden.

Erst beobachten, dann handeln

Ein veralteter Screenshot ist eine häufige Fehlerquelle. Der zuverlässige Ablauf lautet:

Screenshot → Entscheidung → eine Aktion → neuer Screenshot → Prüfung
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

Das erste Bild zeigt Claude das richtige Fenster. Die aktuelle Observation verhindert Eingaben gegen einen veralteten Bildschirm. Das zweite Bild bestätigt das Ergebnis. Ein erfolgreich gesendeter Klick bedeutet nicht, dass die Anwendung fertig ist; es können Fehler, Berechtigungsdialoge oder ein anderes Fenster erscheinen.

Praktisches Beispiel

Für eine Windows-Reporting-App, die sales.csv importiert und report.pdf exportiert, sollten Dateien strukturiert übertragen werden:

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

Gib Claude Code klare Prüfbedingungen:

Verbinde dich mit dem entfernten Windows-Desktop.
Öffne die Reporting-App, importiere input/sales.csv, erstelle den Monatsbericht und exportiere output/report.pdf.
Erstelle nach jeder grafischen Aktion einen neuen Screenshot und bestätige das erwartete Fenster.
Wenn der Bildschirm abweicht, stoppe und melde das Problem. Wiederhole keine unklare Aktion ohne Statusprüfung.

Wenn eine API oder ein CLI-Befehl genügt, sollte dieser zuerst verwendet werden. RDP ist für die Schritte gedacht, die tatsächlich eine grafische Oberfläche benötigen.