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 script personalizado ou 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 local MCP e usá-lo imediatamente, e as configurações do FlashDesk mostram a configuração exata para colar.

Importante: o suporte a MCP vem desativado por padrão e deve ser ativado nas configurações do FlashDesk no dispositivo em que a ferramenta de IA é executada. A janela da tela remota é exibida normalmente durante uma sessão conduzida por MCP, sem ficar oculta.

Uso básico

Ative o MCP nas configurações do FlashDesk

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

Registre o FlashDesk como servidor MCP

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

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

Peça à sua ferramenta de IA para se conectar

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

Trabalhe por linguagem natural

Uma vez conectado, descreva o que você deseja fazer. A ferramenta de IA escolhe as ações adequadas — capturando uma imagem de tela, clicando, digitando, movendo ou organizando arquivos, ou executando um comando.

O que você pode fazer

Listar conexões salvas e pastas, 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 região única, e ler o título e a posição da janela em primeiro plano no Windows.
Mover o mouse, clicar, dar duplo clique, rolar, pressionar teclas e digitar texto no dispositivo remoto.
Ler e definir a área de transferência, sincronizada com o dispositivo remoto.
Listar, fazer upload, fazer download, renomear e excluir arquivos e pastas — tanto no dispositivo remoto quanto no dispositivo em que a ferramenta de IA é executada.
Iniciar uma sessão exclusiva SSH sem janela de tela e executar comandos do shell no dispositivo remoto.
Iniciar e interromper a gravação da tela e verificar seu status.
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, profundidade do pipeline e qualidade JPEG.
Verificar e aplicar atualizações do FlashDesk no dispositivo remoto, e sair ou reiniciar o FlashDesk em ambos os extremos.
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
O app de desktop do ChatGPT e o Codex CLI
Cursor
Windsurf
VS Code com GitHub Copilot Chat

Cada ferramenta tem seu próprio local para registrar um servidor MCP local, geralmente um arquivo de configuração 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 app de desktop ou a CLI correspondente.

Como funciona

Item	Descrição
`--mcp-server`	O flag que inicia o FlashDesk como servidor MCP local. Esse processo apenas encaminha solicitações para o FlashDesk; ele nunca se torna um Host ou um Viewer por si só.
Somente local	O servidor MCP se comunica por entrada/saída padrão local. Nunca é exposto à rede.
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 algo por conta própria.
Mesmo fluxo de aprovação	Uma conexão aberta através 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

O suporte a MCP vem desativado por padrão e deve ser ativado no dispositivo em que a ferramenta de IA é executada.
A janela da tela remota é exibida normalmente durante uma sessão conduzida por MCP, assim como em uma conexão normal.
Transferência de arquivos, exclusão e renomeação de arquivos e execução de comandos SSH realizados através 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.
Comandos SSH executados via 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 arquivos alcançam ambos os extremos: 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 um único comando errado não possa limpar toda uma árvore.
As ferramentas de atualização, saída e reinício podem parar ou reiniciar o FlashDesk em ambos os extremos. 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.