Como permitir que o Claude Code controle uma área de trabalho Windows remota

O Claude Code é excelente para trabalhar com código, arquivos e comandos, mas muitas tarefas reais ainda precisam de uma área de trabalho Windows: abrir o Excel, usar software legado, lidar com diálogos de arquivos ou operar aplicativos sem API.

A solução prática é conectar o Claude Code a uma ferramenta de área de trabalho remota por meio do MCP. O MCP fornece a interface das ferramentas, o RDP fornece a conexão com o Windows e o Claude Code decide o próximo passo.

Arquitetura básica

Claude Code
  ↓
Servidor MCP de área de trabalho remota
  ↓
rdp-cli ou outro controlador de desktop
  ↓
Área de trabalho Windows remota

Exponha ferramentas pequenas e claras: connect, screenshot, click, type, key, upload_file, download_file, status e disconnect. Não habilite um shell remoto irrestrito sem necessidade real.

Observe antes de agir

Clicar com base em uma captura antiga é uma causa comum de falhas. O ciclo confiável é:

Captura → Decisão → Uma ação → Nova captura → Verificação

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

A primeira imagem ajuda a encontrar a janela correta. A observation atual evita enviar a ação para uma tela antiga. A segunda imagem confirma o resultado. Um comando bem-sucedido apenas confirma que a entrada foi enviada; o aplicativo ainda pode mostrar um erro, uma permissão ou outra janela.

Exemplo prático

Para abrir um aplicativo de relatórios, importar sales.csv, gerar report.pdf e baixar o resultado, use transferências estruturadas:

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

Dê ao Claude Code critérios claros de verificação:

Conecte-se à área de trabalho Windows remota.
Abra o aplicativo de relatórios, importe input/sales.csv, crie o relatório mensal e exporte output/report.pdf.
Depois de cada ação gráfica, faça uma nova captura e confirme que a janela esperada está visível.
Se a tela for diferente, pare e informe o problema. Não repita uma ação incerta sem verificar o estado da sessão.

Se uma API ou comando resolver uma etapa, use-o primeiro. Reserve o RDP para as partes que realmente precisam de uma interface gráfica.