O Windows MCP é um servidor de código aberto que dá ao Claude mãos no seu PC com Windows: ele pode abrir apps, clicar, digitar, ler a tela e executar PowerShell. Este artigo explica como funciona, como instalá-lo no Claude Desktop e como mantê-lo seguro.
Você pediu ao Claude para organizar 300 arquivos da sua pasta Downloads, e ele lhe deu um plano bem organizado que você ainda precisava executar à mão. O Windows MCP elimina essa última etapa. É um servidor de código aberto que dá ao Claude um par de mãos no seu PC com Windows: ele pode ler o que está na tela, clicar em botões, digitar em campos, abrir apps, mover arquivos e executar comandos do PowerShell, tudo a partir de um chat normal no Claude Desktop. Este artigo explica o que é o Windows MCP, como as peças se encaixam, como instalar, quais tarefas ele faz bem e quais configurações impedem que ele cause danos. Também esclarece uma confusão de nomes, porque a Microsoft usa a expressão MCP no Windows para um recurso separado, integrado ao próprio sistema operacional.
O Model Context Protocol (MCP) é um padrão aberto que a Anthropic apresentou no fim de 2024. Ele permite que um app de IA se comunique com ferramentas externas por meio de um formato compartilhado. O Claude Desktop faz o papel de cliente. Qualquer coisa que fale o protocolo faz o papel de servidor: um conector de banco de dados, uma agenda, um navegador ou, neste caso, toda a sua área de trabalho. O cliente pergunta ao servidor quais ferramentas ele oferece, o Claude escolhe a que combina com o seu pedido, e o servidor executa a ação e devolve o resultado.
Essa divisão importa. O Claude nunca mexe no seu PC diretamente. Ele só pode pedir ações que o servidor tenha decidido expor, e cada uma delas é uma ferramenta com nome, que você pode inspecionar, limitar ou desligar.
O Windows-MCP é um projeto licenciado sob MIT, criado pela CursorTouch e publicado no GitHub. O README o descreve como uma ponte leve entre modelos de linguagem e o sistema operacional Windows, feita para trabalhar com arquivos, controlar apps e interagir com a interface, sem precisar de um modelo de visão especializado. Ele oferece suporte ao Windows 7, 8, 8.1, 10 e 11, e é apresentado como uma Desktop Extension no Claude Desktop.
💡 Duas coisas compartilham um nome. O Windows-MCP é um servidor da comunidade que você instala por conta própria. MCP no Windows é a estrutura oficial da Microsoft, descrita em uma seção posterior. A maior parte deste artigo trata do primeiro.
O Claude não observa o seu monitor. O servidor descreve a tela para ele. A ferramenta Snapshot devolve o estado completo da interface com um ID para cada elemento, para que o Claude possa agir sobre "elemento 14" em vez de adivinhar posições de pixel. A ferramenta Screenshot é a opção mais leve: uma captura visual rápida que inclui o cursor e as janelas abertas. Com base no que volta, o Claude escolhe a próxima ferramenta, como Click, Type, Scroll ou Shortcut, e repete o ciclo até a tarefa terminar. O projeto indica um atraso típico de 0,2 a 0,5 segundo entre as ações.
| Modo | O que o Claude recebe | Melhor para |
|---|---|---|
| Screenshot (padrão) | Uma imagem rápida da tela com cursor e janelas | Verificações visuais rápidas, menor custo de tokens |
| Snapshot | O estado da interface com IDs de elementos, mais uma captura de tela quando use_vision=True | Cliques precisos em apps com muitos elementos |
Os dois modos aceitam captura de região e seleção de múltiplos monitores, o que mantém o uso de tokens sob controle. Se as capturas ainda estiverem pesadas demais, defina WINDOWS_MCP_SCREENSHOT_SCALE com um valor entre 0,1 e 1,0 para reduzi-las.
O README lista cerca de vinte ferramentas. Agrupadas por função:
| Grupo | Ferramentas | O que fazem |
|---|---|---|
| Mouse e digitação | Click, Type, Scroll, Move, Shortcut, MultiSelect, MultiEdit | Clicam em coordenadas, inserem texto, rolam a tela, arrastam, enviam combinações de atalhos como Ctrl+C, selecionam ou preenchem vários itens de uma vez |
| Ver a tela | Screenshot, Snapshot, DisplayInventory, ControlStatus | Capturam a interface, leem o layout e o DPI dos monitores, verificam quem tem o controle da área de trabalho e há quanto tempo está ociosa |
| Apps e sistema | App, PowerShell, Process, Registry, Notification, Clipboard | Abrem apps e gerenciam janelas, executam comandos, listam ou encerram processos, editam o Registro, enviam notificações e leem e gravam a área de transferência |
| Arquivos e web | FileSystem, Scrape | Leem, gravam, copiam, movem, excluem, listam e pesquisam arquivos; extraem o conteúdo de páginas da web |
| Tempo | Wait, WaitFor | Pausam, ou aguardam que surjam textos, janelas, elementos ou o foco |
pip install uv funciona)claude_desktop_config.json, normalmente dentro de %APPDATA%\Claude.windows-mcp dentro da seção mcpServers existente.{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": ["windows-mcp", "serve"]
}
}
}
💡 Versão do Claude Desktop pela Microsoft Store? Ela guarda a configuração em outra pasta, e o README do projeto manda usar o caminho completo do executável, por exemplo
C:\Users\<user>\.local\bin\uvx.exe. O app empacotado pode não enxergar seu PATH normal, então um simplesuvxfalha.
Prefere uma extensão? O Windows-MCP também é distribuído como Desktop Extension. Os passos do projeto são: instalar a ferramenta mcpb da Anthropic com npm, executar npx @anthropic-ai/mcpb pack no projeto clonado para gerar um arquivo .mcpb e depois instalar esse arquivo pela página Extensions nas configurações do Claude Desktop.
Abra um chat novo e confirme que o servidor aparece como conectado. Depois comece com algo inofensivo:
"Tire uma captura de tela e me diga quais apps estão abertos."
Quando isso funcionar, parta para algo um pouco mais ousado:
"Abra o Bloco de Notas e digite uma lista de compras de três linhas. Não salve."
Acompanhe a tela enquanto ele trabalha. Você vai ver o ponteiro se mover, janelas abrirem e texto aparecer, que é a forma mais rápida de sentir o quão rápido e o quão literal o Claude é quando controla uma área de trabalho real.
💡 Você sempre pode retomar o controle. Mova o mouse por uma distância grande, ou pressione Ctrl+Alt+Shift+Backspace, e a área de trabalho volta para você.
A ferramenta FileSystem consegue listar, pesquisar, copiar, mover e excluir, então uma pasta Downloads bagunçada é a primeira tarefa clássica. Peça o plano antes da ação: "Liste o que há em Downloads, proponha subpastas por tipo de arquivo e aguarde minha aprovação antes de mover qualquer coisa." Essa única frase transforma uma operação em massa arriscada em algo que você pode revisar.
Muitos programas de desktop não têm API. Uma ferramenta de compras de 2012 ou um formulário interno com 40 campos ainda precisa de uma pessoa digitando. A MultiEdit preenche vários campos de uma só vez, a Clipboard move valores entre janelas, e o Snapshot dá ao Claude alvos confiáveis. Trate as primeiras execuções como supervisionadas: acompanhe a tela e confira você mesmo os totais.
O projeto lista os testes de QA entre os seus usos. Clique em um instalador, altere uma configuração do Windows, confirme que um app abre e depois peça ao Claude para descrever o que mudou. Essa tarefa se encaixa melhor em uma máquina virtual, onde um erro custa a restauração de um snapshot em vez de uma tarde perdida.
Aqui estão quatro prompts iniciais e as ferramentas que eles provavelmente acionam:
| Tarefa | Prompt inicial | Ferramentas envolvidas |
|---|---|---|
| Organizar uma pasta | "Proponha uma estrutura de pastas para Downloads e aguarde minha aprovação." | FileSystem, Snapshot |
| Preencher um formulário | "Copie as cinco linhas desta planilha para o formulário." | Snapshot, MultiEdit, Clipboard |
| Verificar um app | "Abra o app, vá em Configurações e me diga a versão." | App, Click, Screenshot |
| Aguardar uma tarefa | "Espere até a janela de exportação dizer que terminou e então me avise." | WaitFor, Notification |
💡 Peça uma pausa antes de qualquer ação destrutiva. Uma linha como "pare e me pergunte antes de excluir, sobrescrever ou fechar qualquer coisa" não custa nada e evita a maioria das surpresas.
A própria política de segurança do projeto é direta. O servidor não roda em sandbox, executa com todas as permissões do usuário do Windows que o iniciou, e muitas ações não podem ser desfeitas. Arquivos removidos pelo PowerShell ou pela interface podem ser perdidos para sempre, e as capturas de tela podem registrar informações sensíveis que depois seguem para o modelo.
O README diz que você pode desativar ferramentas arriscadas com a opção --exclude-tools ou com a variável de ambiente WINDOWS_MCP_EXCLUDE_TOOLS, então confira ali a sintaxe exata. Para a primeira semana, deixar de fora o Registry e o PowerShell elimina as duas formas mais poderosas de quebrar algo. A telemetria é outra configuração que vale conhecer: ela vem ativada por padrão e, segundo o projeto, é anônima, e você pode desligá-la adicionando "env": {"ANONYMIZED_TELEMETRY": "false"} à entrada do servidor.
Se algum dia você expuser o servidor pela rede, em vez de usar apenas a conexão local com o Claude Desktop, o projeto pede mais proteção: um token de autenticação, uma lista de IPs permitidos e TLS.
A política de segurança recomenda alguns hábitos:
Ele também desaconselha usar o Windows MCP em servidores de produção, em ambientes sujeitos a regulamentação, em máquinas com dados insubstituíveis ou em computadores compartilhados por vários usuários.
💡 Regra prática: se você não deixaria um colega sozinho com seu notebook aberto por dez minutos, não dê ao Claude esse mesmo acesso em uma máquina que guarda trabalho não salvo ou insubstituível.
A Microsoft anunciou uma prévia pública de suporte nativo a MCP no Windows em maio de 2025. Conforme descrito na época, um registro no dispositivo lista conectores de agente, que são servidores MCP publicados por desenvolvedores de apps. Conectores integrados para o gerenciador de arquivos e as Configurações do Sistema faziam parte da prévia. O acesso de agentes vem desativado por padrão, o registro só admite servidores que cumprem critérios mínimos, como assinatura de código e definições fixas de ferramentas, um proxy do sistema aplica políticas e mantém um registro de auditoria, e os usuários recebem uma solicitação de aprovação, parecida com a caixa de diálogo do UAC, antes de chamadas de ferramentas sensíveis.
| Recurso | Windows-MCP (comunidade) | MCP no Windows (Microsoft) |
|---|---|---|
| Criado por | CursorTouch, código aberto, licença MIT | Microsoft, parte do Windows |
| Instalação | Arquivo de configuração ou Desktop Extension | Registro no dispositivo gerenciado pelo Windows |
| Alcance | Toda a área de trabalho, por meio de automação de interface, PowerShell, arquivos e Registry | Somente os conectores que os apps registram |
| Modelo de segurança | Permissões do seu usuário, sem sandbox | Desativado por padrão, servidores assinados, proxy e solicitações de aprovação |
As duas opções estão em evolução, então confira o README do projeto e a documentação atual da Microsoft antes de montar um fluxo de trabalho em qualquer uma delas. Por enquanto, o servidor da comunidade é o que permite ao Claude controlar qualquer app na tela, enquanto o caminho da Microsoft é mais restrito e mais rigidamente controlado.
O README é honesto sobre os limites:
Há também um custo estrutural. Cada etapa é uma ida e volta pelo modelo, então uma tarefa longa roda mais devagar, e consome mais tokens, do que um script faria. Quando uma tarefa se repete todo dia, peça ao Claude para escrever um script em PowerShell uma vez e execute esse script daí em diante.
| Sintoma | Causa provável | Solução |
|---|---|---|
| O servidor nunca aparece como conectado | uvx não encontrado, Python anterior à versão 3.13, ou uma versão da Store sem caminhos completos | Instale o uv, atualize o Python, use o caminho completo para uvx.exe |
| Ferramentas somem após reiniciar | Erro de digitação no JSON de configuração, ou o Claude Desktop não foi totalmente fechado | Valide o JSON, feche pela bandeja e reabra |
| A primeira inicialização parece travada | As dependências ainda estão sendo instaladas | Aguarde de um a dois minutos |
| Os cliques caem no lugar errado | Escala de exibição ou vários monitores | Execute DisplayInventory e prefira os IDs de elementos do Snapshot às coordenadas brutas |
| A ferramenta App não consegue abrir um programa | Windows em idioma diferente do inglês | Troque o idioma de exibição, ou abra o programa pelo caminho usando o PowerShell |
O Windows MCP dá ao Claude um par de mãos. O Picasso IA oferece um estúdio. Quando o Claude consegue controlar o seu PC, a parte lenta de muitas tarefas criativas deixa de ser o clique e passa a ser a produção das próprias imagens e clipes.
Veja por onde começar:
O PicassoIA também oferece uma conexão MCP própria, para que o Claude possa solicitar imagens e vídeos de dentro de uma conversa. Com os dois servidores conectados, um único chat pode pedir uma imagem e depois usar o Windows MCP para salvá-la ou colocá-la onde você precisar. Consulte o site do PicassoIA para saber como conectar sua conta e o que o seu plano inclui.
💡 Seu próximo passo: abra o Picasso IA, escolha um modelo, escreva um prompt sobre uma cena da sua própria mesa e gere sua primeira imagem hoje. Depois explore todos os modelos em picassoia.com/en/all-models e experimente um vídeo curto a partir da mesma imagem.
Escolha seu idioma
