Pitch: um MCP de SSH para operar VPS com IA
Eu precisava configurar serviços em uma VPS, por exemplo, preparar o ambiente e subir uma nova aplicação em um container Docker, tudo usando IA.
Encontrei alguns MCPs de SSH, mas não me senti confortável em dar a um agente uma conexão SSH genérica com usuário, senha ou chave. SSH é extremamente útil, mas também entrega poder suficiente para derrubar um serviço ou alterar uma máquina de forma difícil de rastrear.
Então criei o SSH MCP Server: um MCP para agentes usarem SSH dentro de um limite definido pelo operador.
A ideia não é criar outro terminal remoto. É permitir automação assistida com uma fronteira de confiança explícita.
O problema que eu queria evitar
Eu não queria que a IA pudesse:
- informar livremente host, usuário, porta, senha ou chave;
- abrir uma sessão SSH persistente;
- navegar livremente pelos arquivos do servidor;
- executar
sudosem que eu visse e aprovasse a ação; - executar algo sem um registro local e rastreável.
A pergunta central do projeto passou a ser:
Como deixar um agente ajudar a operar uma VPS sem transformá-lo em um usuário SSH irrestrito?
Perfis aprovados, não conexões livres
O agente trabalha apenas com identificadores de perfis previamente configurados pelo operador, como staging-api.
Ele não recebe os dados de conexão nem pode inventar um destino. A configuração que associa esse perfil ao host, usuário, método de autenticação e identidade esperada fica fora do contexto do agente.
Isso também permite usar o mesmo MCP em vários servidores, cada um com seu próprio perfil e política.
Credenciais não devem atravessar o agente
Um ponto importante: a fingerprint não é uma credencial. Ela valida a identidade do servidor remoto, ajudando a impedir que o agente se conecte a um host inesperado ou a um intermediário.
A decisão foi separar responsabilidades:
- o agente escolhe apenas entre perfis aprovados;
- o operador mantém o material de autenticação em uma fronteira confiável;
- o MCP verifica a identidade esperada do host antes de seguir;
- nenhuma senha, chave privada, token ou host é enviado pelo agente na chamada da ferramenta.
Execução limitada e aprovação humana
O MCP executa uma ação remota por vez, de forma não interativa e com limites de tempo e saída. Ele não oferece shell persistente, encaminhamento de portas, download ou navegação remota de diretórios.
Para comandos de elevação de privilégio, como sudo, e para avaliadores de comando, a execução exige uma aprovação humana explícita.
Essa aprovação é vinculada ao pedido exato: perfil, comando, argumentos, limites e prazo. Ela expira, só pode ser usada uma vez e deixa de valer se qualquer parte da ação for modificada.
A intenção é simples: a IA pode preparar a ação, mas não deve conseguir ampliar os próprios privilégios.
Upload também precisa ser uma ação consciente
O projeto também suporta envio de um arquivo exato por SFTP, mas não uma sessão SFTP aberta.
O upload é vinculado ao perfil, caminho remoto, tamanho e hash do conteúdo. Antes de renomear o arquivo temporário para o destino, o servidor remoto é lido novamente e validado por SHA-256.
Isso transforma algo aparentemente simples “suba este arquivo de configuração” em uma operação com escopo e integridade verificáveis.
Auditoria e incerteza são parte do contrato
As tentativas de execução são registradas em um journal local com integridade protegida e dados sensíveis redigidos.
Outro detalhe que considero essencial: se uma conexão for interrompida depois de enviar o comando, o resultado é outcome-unknown. O agente não deve repetir automaticamente, porque o comando pode já ter sido executado no servidor.
Prefiro exigir investigação humana a correr o risco de duplicar uma operação remota.
O projeto suporta Linux/macOS e Windows, embora o runtime nativo de Windows ainda esteja em fase alpha. A distribuição atual é por código-fonte; não há pacote npm ou licença publicada neste momento.
O aprendizado principal
Dar SSH para uma IA não deveria significar dar uma conta SSH irrestrita para uma IA.
Acredito que ferramentas de operação para agentes precisam partir de algumas perguntas:
- o agente realmente precisa conhecer o destino?
- a ação tem escopo finito?
- uma pessoa precisa aprovar esta elevação de privilégio?
- conseguimos auditar sem registrar segredos?
- o que deve acontecer quando não sabemos se a ação foi concluída?
Esse projeto é minha resposta atual a essas perguntas.
O repositório está aberto em VissotoFlavio/ssh-mcp-server. Quero principalmente compartilhar a experiência e discutir como outras pessoas estão desenhando limites de segurança para MCPs que operam infraestrutura.