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.
Conteúdo
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.
FlashDesk MCP na prática
Estes exemplos reais combinam visualização e controle da tela, investigação por SSH e consulta a logs e bancos de dados. As ferramentas de IA obtêm informações e executam ações por meio do FlashDesk MCP.
-
Investigar diferenças entre o que aparece na tela e o estado real
As informações exibidas na tela e o status do processamento foram comparados com logs, configurações e registros do banco de dados para investigar divergências e processos parados. -
Preparar um novo PC Linux
As tarefas incluíram configurar o acesso remoto, o Docker e os aplicativos necessários, restaurar um banco de dados a partir de um backup e configurar a rede e a sincronização de horário. -
Descobrir por que os PCs não conseguem se conectar
As configurações exibidas na tela e o status da conexão foram verificados para investigar a configuração de rede e os problemas com várias interfaces de rede. Também é possível investigar um PC que não consegue se conectar diretamente ao FlashDesk, desde que ele seja acessível por SSH a partir de um PC autorizado e conectado à mesma rede. -
Recuperar aplicativos que não iniciam
Foram investigados problemas de inicialização após atualizações e falta de espaço em disco causada pelo crescimento dos logs. O trabalho incluiu limpar logs, revisar configurações e corrigir a inicialização do VS Code em um Mac. -
Testar aplicativos Windows e macOS em dispositivos reais
Foram usadas capturas de tela para inspecionar a exibição e verificar se os cliques e as teclas pressionadas chegavam ao aplicativo, incluindo as mudanças resultantes na tela. -
Tornar reutilizáveis os procedimentos de investigação recorrentes
As verificações de logs e as consultas a bancos de dados mais frequentes foram organizadas em scripts para permitir o uso dos mesmos procedimentos em investigações futuras.
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:\\Users\\YourName\\AppData\\Local\\FlashDesk\\app\\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. |