FlashDesk

Controle a área de trabalho de outro PC a partir do Claude Code via MCP — captura de tela, mouse, teclado, SSH, transferência de arquivos. Para trabalho com GUI que o SSH não alcança em uma máquina remota; o PC remoto aprova cada conexão. Não é Controle Remoto da sua própria sessão do Claude.

Ver em flashdesk.io

Documentação

MCP: Controle o FlashDesk a partir das suas ferramentas de IA

O FlashDesk implementa o MCP (Model Context Protocol), um padrão aberto para conectar ferramentas de IA a aplicativos externos. Ferramentas de IA como Claude, ChatGPT, Cursor e Windsurf podem visualizar a tela, controlar o mouse e o teclado, gerenciar arquivos, executar comandos SSH e verificar o desempenho em um dispositivo remoto por meio de linguagem natural.

Visão geral

O MCP (Model Context Protocol) é um padrão aberto que permite que ferramentas de IA chamem aplicativos externos diretamente, sem scripts personalizados ou uma integração dedicada. Qualquer ferramenta de IA compatível com MCP executada no mesmo PC que o FlashDesk pode registrar o FlashDesk como um servidor MCP local e usá-lo imediatamente, e as configurações do FlashDesk mostram a configuração exata para colar.

Importante: o suporte a MCP está desativado por padrão e deve ser habilitado nas configurações do FlashDesk no dispositivo em que a ferramenta de IA é executada. A janela de tela remota é exibida normalmente durante uma sessão orientada por MCP, não fica oculta.

O FlashDesk MCP na prática

Estes exemplos reais combinam visualização e controle de tela, investigação via SSH e verificação de logs e bancos de dados. As ferramentas de IA recuperam informações e executam ações por meio do FlashDesk MCP.

Investigar uma divergência entre a tela e o estado real
As exibições na tela e o status de processamento foram comparados com logs, configurações e registros de banco de dados para investigar discrepâncias e processamento travado.
Configurar um novo PC Linux
As tarefas incluíram configurar acesso remoto, Docker e aplicativos necessários, restaurar um banco de dados a partir de um backup e configurar rede e sincronização de horário.
Descobrir por que os PCs não conseguem se conectar
As configurações na tela e o status da conexão foram verificados para investigar a configuração de rede e múltiplas interfaces de rede. Um PC que não consegue se conectar diretamente ao FlashDesk também pode ser investigado se estiver acessível por SSH a partir de um PC autorizado e conectado na mesma rede.
Restaurar aplicativos que não iniciam
Foram investigados problemas de inicialização após atualizações e falta de espaço em disco causada por logs crescentes. O trabalho incluiu limpar logs, revisar configurações e reparar a inicialização do VS Code em um Mac.
Testar aplicativos Windows e macOS em dispositivos reais
Capturas de tela foram usadas para inspecionar a exibição e verificar se cliques e teclas chegaram ao aplicativo, incluindo as mudanças resultantes na tela.
Tornar etapas de investigação recorrentes reutilizáveis
Verificações de logs e consultas de banco de dados usadas com frequência foram organizadas em scripts para que as mesmas etapas pudessem ser usadas em investigações posteriores.

Assista à demonstração do FlashDesk MCP no YouTube

Uso básico

Habilitar o MCP nas configurações do FlashDesk

No dispositivo em que sua ferramenta de IA é executada, ative o acesso a ferramentas de IA externas nas configurações do FlashDesk. Ele está desativado por padrão.

Registrar o FlashDesk como um servidor MCP

A mesma tela de configurações mostra a configuração exata para registrar, com um botão de copiar. Cole-a nas configurações de MCP da sua ferramenta de IA. Cada ferramenta de IA tem seu próprio local para registrar servidores MCP locais — consulte a documentação de MCP da própria ferramenta para saber onde fica.

{
  "mcpServers": {
    "flashdesk": {
      "command": "C:\\Program Files\\FlashDesk\\FlashDesk.exe",
      "args": ["--mcp-server"]
    }
  }
}

Peça à sua ferramenta de IA para conectar

Diga à ferramenta de IA a qual dispositivo salvo conectar. A conexão passa pelo fluxo normal de aprovação no dispositivo remoto.

Trabalhe por meio de linguagem natural

Depois de conectado, descreva o que deseja fazer. A ferramenta de IA escolhe as ações certas — tirar uma captura de tela, clicar, digitar, mover ou organizar arquivos, ou executar um comando.

O que você pode fazer

Listar conexões e pastas salvas, ver quais dispositivos estão online e abrir, verificar e fechar sessões.
Obter uma captura de tela ao vivo da tela remota, seja a tela inteira ou uma única região, e ler o título e a posição da janela em primeiro plano no Windows.
Mover o mouse, clicar, clicar duas vezes, rolar, pressionar teclas e digitar texto no dispositivo remoto.
Ler e definir a área de transferência, sincronizada com o dispositivo remoto.
Listar, enviar, baixar, renomear e excluir arquivos e pastas — tanto no dispositivo remoto quanto no dispositivo em que a ferramenta de IA é executada.
Abrir uma sessão somente SSH sem janela de tela e executar comandos de shell no dispositivo remoto.
Iniciar, parar e verificar o status da gravação de tela.
Enviar e ler mensagens de chat da sessão, que a pessoa no dispositivo remoto vê.
Ler estatísticas de vídeo ao vivo — taxa de quadros, tempo de ida e volta, perda de pacotes, nível de congestionamento e CPU e memória do host — e ajustar a taxa de quadros alvo, a profundidade do pipeline e a qualidade JPEG.
Verificar e aplicar atualizações do FlashDesk no dispositivo remoto e sair ou reiniciar o FlashDesk em qualquer uma das extremidades.
Organizar a lista de conexões: renomear conexões, criar, renomear e excluir pastas e mover conexões entre elas.

Ferramentas de IA compatíveis

O FlashDesk funciona com qualquer ferramenta de IA compatível com MCP, incluindo:

Claude Desktop e Claude Code
Aplicativo de desktop do ChatGPT e Codex CLI
Cursor
Windsurf
VS Code com GitHub Copilot Chat

Cada ferramenta tem seu próprio local para registrar um servidor MCP local — normalmente um arquivo de configurações ou um comando de CLI. Interfaces de chat de IA somente web geralmente suportam apenas servidores MCP remotos, não um local como o do FlashDesk; use o aplicativo de desktop ou CLI correspondente.

Como funciona

Item	Descrição
`--mcp-server`	O sinalizador que inicia o FlashDesk como um servidor MCP local. Esse processo apenas faz a ponte de solicitações para o FlashDesk; ele nunca se torna um Host ou um Viewer por conta própria.
Somente local	O servidor MCP se comunica por entrada/saída padrão local. Ele nunca é exposto à rede.
O FlashDesk deve estar em execução	O processo de ponte passa cada solicitação para o FlashDesk já em execução no mesmo PC. Se o FlashDesk não estiver em execução, as solicitações retornam um erro em vez de iniciar qualquer coisa por conta própria.
Mesmo fluxo de aprovação	Uma conexão aberta por meio do MCP passa pelo mesmo fluxo de aprovação ou senha compartilhada no dispositivo remoto que uma conexão iniciada por uma pessoa.

Notas operacionais

Prática operacional recomendada

As ferramentas de IA investigam usando as telas e os logs que recuperam. Comece com verificações somente leitura, revise as alterações propostas e faça os backups necessários antes de fazer alterações.

O suporte a MCP está desativado por padrão e deve ser habilitado no dispositivo em que a ferramenta de IA é executada.
A janela de tela remota é exibida normalmente durante uma sessão orientada por MCP, da mesma forma que uma conexão normal.
Transferência de arquivos, exclusão e renomeação de arquivos e execução de comandos SSH realizados por meio do MCP não são confirmados individualmente. A exclusão não passa pela lixeira e não pode ser desfeita. Considere o que você deseja permitir que uma ferramenta de IA faça antes de habilitar o MCP.
Os comandos SSH executados por meio do MCP exigem que a chave SSH do dispositivo de destino já esteja salva no dispositivo em que a ferramenta de IA é executada.
As ferramentas de arquivo alcançam ambas as extremidades: o dispositivo remoto e o dispositivo em que a ferramenta de IA é executada. Excluir uma pasta junto com seu conteúdo requer uma opção explícita, para que uma única instrução equivocada não possa limpar uma árvore inteira.
As ferramentas de atualização, saída e reinicialização podem parar ou reiniciar o FlashDesk em qualquer uma das extremidades. Reiniciar o FlashDesk no dispositivo em que a ferramenta de IA é executada também encerra a conexão MCP, e a ferramenta de IA precisa se reconectar.