IA by DNACX

#13 no GitHub · Design e computador

Como instalar e usar o Windows MCP

Um servidor MCP que deixa a IA controlar o Windows: navegar por arquivos, abrir e controlar aplicativos, clicar, digitar e ler o estado das janelas.

Para quem
Quem usa Windows 10 ou 11 e quer que o Claude Code opere programas e janelas do computador, e aceita dar à IA acesso amplo ao sistema.
Estrelas (07/11/2026)
11.253, #13 no ranking
Licença
MIT
Repositório
CursorTouch/Windows-MCP

Passo a passo

Antes de começar: Windows 10 ou Windows 11 (o README lista só esses dois sistemas e diz que versões anteriores não são suportadas); Python 3.14 ou mais novo; UV (gerenciador de pacotes). O README manda instalar com pip install uv; Claude Code instalado. O README mostra npm install -g @anthropic-ai/claude-code.

  1. Confirme que o seu computador é Windows 10 ou 11

    Este servidor só serve ao Windows. O README lista Windows 10 e Windows 11 como sistemas suportados.

  2. Instale o UV

    O UV é o programa que baixa e roda o Windows-MCP (o comando uvx vem com ele). O README indica instalar com o comando abaixo, que exige o Python.

    Comando
    pip install uv

  3. Registre o servidor no Claude Code

    Num terminal comum do Windows, cole o comando e aperte Enter. Para o servidor valer em todos os projetos, o README manda acrescentar --scope user ao comando.

    Comando
    claude mcp add --transport stdio windows-mcp -- uvx windows-mcp serve

  4. Espere a primeira instalação e reabra o Claude Code

    Na primeira vez o servidor baixa dependências e pode levar um ou dois minutos. O README diz que ele pode dar timeout nessa primeira execução e que basta ignorar e reiniciar. Depois, abra o Claude Code de novo.

  5. Confira se o servidor foi registrado

    Rode o comando abaixo no terminal. Dentro do Claude Code, o README manda usar /mcp para ver o estado do servidor.

    Comando
    claude mcp list

  6. Se aparecer Connection closed, use o caminho completo

    O README diz que, no Windows, o erro de conexão encerrada se resolve usando o caminho completo do uvx.exe no comando. Troque user pelo seu nome de usuário do Windows.

    Comando
    claude mcp add --transport stdio windows-mcp -- C:\Users\<user>\.local\bin\uvx.exe windows-mcp serve

Primeiro teste

O README não traz um pedido de teste. Peça uma tarefa simples e confira se o servidor entra em ação.

Cuidados

  • O README diz que o Windows-MCP opera com acesso total ao sistema e pode executar operações irreversíveis, e manda ler a política de segurança antes de usar.
  • Entre as ferramentas há PowerShell, para executar comandos do PowerShell. O README mostra que dá para desativar ferramentas específicas, como PowerShell e Registry, com a opção --exclude-tools.
  • O controle da área de trabalho vem ligado por padrão, na política relaxada. Antes de a IA começar um novo período de controle, as bordas da tela ficam âmbar e aparece uma janela com contagem regressiva, em que dá para permitir ou negar.
  • O README diz que uma contagem sem resposta inicia o controle, e que há um atalho para retomar a área de trabalho: Ctrl+Alt+Shift+Backspace, citado como a forma de assumir em dispositivos de entrada sem identificação.
  • Há telemetria anônima de uso. O README diz que não rastreia informação pessoal, argumentos de ferramentas nem saídas, e que dá para desligar definindo ANONYMIZED_TELEMETRY como false na configuração do cliente.
  • O README avisa que, se você usa o Claude Code pelo WSL, o servidor ainda precisa rodar no lado do Windows, e traz um comando próprio para esse caso.
  • Limitações declaradas: selecionar trechos de um parágrafo, digitar código em IDE de forma confiável e jogar videogames.

Como desfazer

O README não traz um passo para remover o registro feito com claude mcp add. Ele só descreve que, se você instalou o servidor como tarefa agendada que inicia no login, o comando abaixo remove essa tarefa.

Desfazer
windows-mcp uninstall

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README não traz um pedido de teste pronto para colar no Claude Code.
  • O README não informa custo ou plano necessário.
  • A versão exata do Python exigida (3.14 ou mais nova) deve ser conferida no seu computador antes de instalar.
  • Não está confirmado como o servidor se comporta com sua versão do Windows e com seus programas instalados.

Dúvidas

Funciona em Mac ou Linux?

Segundo o README, não. Os sistemas listados são Windows 10 e Windows 11, e o servidor precisa das APIs do Windows para automatizar a interface.

Preciso de um modelo com visão?

O README diz que o servidor não depende de técnicas tradicionais de visão computacional nem de modelos específicos, e que a visão é opcional.

Dá para usar o servidor só para navegar na web?

O README descreve um modo DOM para automação de navegador que foca no conteúdo da página e filtra os elementos da interface do navegador. Ele cita Chrome, Edge e Firefox.

O computador fica livre enquanto a IA trabalha?

O README diz que, quando o controle está ligado, a IA assume a área de trabalho por períodos e você pode retomá-la. Se o controle for desligado, as ações da IA podem interferir na sua própria entrada.

A DNACX usa o Windows MCP?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #12 Apify · #14 Mobile MCP →

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de CursorTouch/Windows-MCP, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.