1

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 sudo sem 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.

Carregando publicação patrocinada...