rdp-cli
Cómo permitir que Claude Code controle un escritorio Windows remoto
Claude Code es muy útil para trabajar con código, archivos y comandos, pero muchas tareas reales necesitan un escritorio Windows: abrir Excel, usar software antiguo, manejar diálogos de archivos o trabajar con aplicaciones sin API.
La solución práctica es conectar Claude Code a una herramienta de escritorio remoto mediante MCP. MCP proporciona la interfaz de herramientas y RDP proporciona la conexión a Windows; Claude Code decide el siguiente paso y la herramienta ejecuta y verifica la acción.
Arquitectura básica
Claude Code
↓
Servidor MCP de escritorio remoto
↓
rdp-cli u otro controlador de escritorio
↓
Escritorio Windows remoto
Expón herramientas pequeñas y claras: connect, screenshot, click, type, key, upload_file, download_file, status y disconnect. No habilites un shell remoto sin restricciones si no es realmente necesario.
Observa antes de actuar
El error más común es hacer clic usando una captura antigua. El ciclo correcto es:
Captura → Decide → Ejecuta una acción → Nueva captura → Verifica
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 primera imagen permite encontrar la ventana correcta. La observación actual evita enviar la acción contra una pantalla obsoleta. La segunda imagen confirma el resultado. Que el comando haya terminado correctamente solo significa que se envió la entrada; la aplicación puede mostrar un error, un permiso o una ventana distinta.
Ejemplo práctico
Para abrir una aplicación de informes, importar sales.csv, generar un informe y descargar report.pdf, usa transferencias estructuradas:
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
Indica a Claude Code qué debe verificar:
Conéctate al escritorio Windows remoto.
Abre la aplicación de informes, importa input/sales.csv, crea el informe mensual y expórtalo como output/report.pdf.
Después de cada acción gráfica, toma una captura nueva y confirma que la ventana esperada está visible.
Si la pantalla es diferente, detente y explica el problema. No repitas una acción incierta sin comprobar el estado de la sesión.
Si una API o un comando puede completar una etapa, úsalo primero. Reserva RDP para las partes que realmente necesitan una interfaz gráfica.