Windows MCP — Instalar & Demo ao vivo

Name: Windows MCP MCP Server
Author: CursorTouch

Por que usar

Principais recursos

Acesso à árvore UI Automation — estruturado, não apenas por pixels
Screenshot + clique + digitação + combos de teclas
Enumeração e foco de janelas
Lançamento e encerramento de processos
Leitura/escrita de clipboard
Funciona no Windows 10/11; sem necessidade de direitos de administrador na maioria dos apps

Demo ao vivo

Como fica na prática

windows-mcp-cursortouch.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "windows-mcp-cursortouch",
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "windows-mcp-cursortouch": {
      "command": {
        "path": "uvx",
        "args": [
          "windows-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add windows-mcp-cursortouch -- uvx windows-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Windows MCP

Automatize um app LOB exclusivo do Windows que não tem API

👤 Engenheiros RPA cansados de licenças UiPath ⏱ ~60 min advanced

Quando usar: O fornecedor do app interno não vai expor uma API; você precisa que o Claude insira dados diariamente.

Pré-requisitos

Windows 10/11 com o app-alvo instalado — Instalação padrão
Python 3.10+ para uvx — winget install Python.Python.3.12

Fluxo

Inspecione a árvore UI

Inicie o app BookingSystem.exe, depois exporte a árvore UI da janela principal. Quero ver os automation IDs.✓ Copiado

→ A árvore mostra controles com AutomationId — não apenas botões sem nome
Execute um caminho feliz uma vez

Agora: abra o diálogo New Booking, preencha cliente 'Acme Inc', data 2026-05-12, salve. Tire um screenshot ao final.✓ Copiado

→ Reserva salva; screenshot confirma
Generalize e repita em loop

Leia /work/bookings.csv. Para cada linha, repita o fluxo de reserva. Salve screenshots em /work/runs/.✓ Copiado

→ Cada linha processada; screenshots por reserva

Resultado: Automação headless de um app de fornecedor, reproduzível a partir de um CSV.

Armadilhas

App usa controles customizados (ex: WinForms ListView sem AutomationId) — Use cliques por coordenadas em uma posição fixa da janela; documente a fragilidade
Diálogo modal rouba o foco durante o loop — Sempre verifique a janela ativa antes de send_keys; aborte se inesperado

Combine com: filesystem

Extraia dados do Excel sem uma API do Excel

👤 Analistas onde o TI não habilita COM/Office API ⏱ ~15 min intermediate

Quando usar: Você pode abrir o Excel mas não pode programaticamente.

Fluxo

Abra o arquivo

Inicie o Excel, abra C:\reports\Q2.xlsx, foque na planilha 'Sales'.✓ Copiado

→ Título da janela mostra o nome do arquivo
Copie o intervalo

Selecione A1:D200, copie para o clipboard, depois leia o texto do clipboard.✓ Copiado

→ Tabela separada por tabulações retornada
Salve como CSV via filesystem

Analise as linhas e salve em /tmp/Q2-sales.csv.✓ Copiado

→ CSV criado

Resultado: Dados do Excel em formato CSV sem precisar da COM API ou instalar pacotes de terceiros.

Armadilhas

Formatos de clipboard variam entre versões do Excel — Tente CSV primeiro; use como fallback TSV via variantes de clipboard

Combine com: filesystem

Capture um bug de desktop para um colega enquanto você está focado

👤 Devs que acumulam suporte ⏱ ~5 min beginner

Quando usar: Um flake se reproduz no seu Windows e você quer um screenshot limpo + instruções de reprodução.

Fluxo

Reproduza e capture

Tire um screenshot da janela ativa do app. Salve como bug.png.✓ Copiado

→ PNG gravado
Anote os passos

Liste os últimos 5 elementos UI visíveis ao usuário com os quais você interagiu — títulos de janelas, labels de diálogos — para eu colar no ticket.✓ Copiado

→ Passos de reprodução concretos a nível de elemento

Resultado: Ticket de bug bem delimitado sem precisar usar Alt+Tab.

Armadilhas

Screenshot inclui informações privadas — Capture apenas a janela ativa, não a área de trabalho inteira

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

windows-mcp-cursortouch + filesystem

Controle um app de desktop a partir de um CSV de entrada

Leia /work/orders.csv. Para cada linha, clique no app de reservas.✓ Copiado

windows-mcp-cursortouch + github

Capture um bug de desktop e abra um issue

Screenshot da janela ativa, depois crie um issue no GitHub com a PNG e passos de reprodução.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_windows	(none)	Encontre o app-alvo	free
get_ui_tree	window_id?	Descoberta antes de clicar	free
click	automation_id \| x,y	Clicar em um controle conhecido	free
type_text	text: str	Inserir texto no campo com foco	free
send_keys	keys: str (e.g. 'ctrl+s')	Atalhos de teclado / modificadores	free
screenshot	window_id?, region?	Confirmação visual	free
launch_process	exe: str	Iniciar o app-alvo	free
read_clipboard	(none)	Após copiar	free

Custo e limites

O que custa rodar

Cota de API: Nenhuma — automação local
Tokens por chamada: 50–500 (dumps da árvore UI podem ser maiores)
Monetário: OSS gratuito
Dica: Evite exportar a árvore UI inteira em cada etapa — filtre por window_id

Segurança

Permissões, segredos, alcance

Escopos mínimos: control of the local desktop session

Armazenamento de credenciais: Nenhum — mas o Claude pode ver tudo que está na tela

Saída de dados: Local; nada sai da máquina a menos que você também conceda um MCP de rede

Nunca conceda: administrator account auto-launch remote access pairing

Não execute em uma máquina dev com credenciais sensíveis abertas em abas do browser — screenshots podem capturá-las
Sempre pré-visualize a árvore UI antes de emitir cliques; valide a janela alvo antes de send_keys

Solução de problemas

Erros comuns e correções

Control not found by automation_id

App usa IDs dinâmicos ou sem IDs. Use get_ui_tree e combine por hierarquia de nome/role

Verificar: Inspecione com Microsoft inspect.exe

Clicks land on wrong window

Sempre chame set_focus na janela alvo antes de clicar; verifique a janela ativa depois

uvx install fails with 'wheel' error

Instale Visual C++ Build Tools; algumas dependências do pywin32 precisam deles

Alternativas

Windows MCP vs. outros

Alternativa	Quando usar	Troca
Anthropic Computer Use (pixel)	Você precisa de controle por pixel multiplataforma	Menos confiável no Windows do que baseado em UIA; mais frágil a mudanças de layout
AutoIt / PowerShell	Você está criando scripts fora de um LLM	Sem camada de agente; apenas scripts manuais
Peekaboo (macOS)	Você está no macOS, não no Windows	Sistema operacional diferente; não intercambiável

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills