Claude MCP Linux: conectar um servidor e configurar o SSH
Mesmo entregando ao Claude o trabalho no servidor Linux, seu arquivo de chave SSH nunca sai do PC. Claude MCP Linux conecta o Claude ao terminal e aos arquivos do seu servidor Linux via SSH. Este guia mostra o que transita e o que não transita e, depois, as etapas de configuração.
Claude MCP(Model Context Protocol) é o padrão que o Claude usa para se conectar a ferramentas e dados externos, e um servidor MCP é um programa que oferece funções segundo esse padrão. Os conceitos e a configuração de conectores no Claude Desktop estão no artigo Claude MCP: conceitos básicos dedicado ao assunto.
Ⅰ. O que é um servidor Claude MCP Linux?
Ao conectar o MCP ao Claude Desktop, o Claude lê arquivos do seu PC e executa tarefas. A conexão Claude MCP Linux leva esse alvo, via SSH, para um servidor Linux remoto: os comandos rodam no servidor e só os resultados voltam ao Claude.
Não é preciso abrir nada de novo no servidor. Você usa o mesmo SSH e a mesma chave de sempre; a única mudança é que quem digita os comandos passa a ser o Claude, não uma pessoa. O que ele pode executar e ver é definido pelas permissões da conta de acesso.
Ⅱ. Configurar o Claude MCP Linux
A configuração tem quatro etapas, do teste de conexão SSH à verificação de erros de conexão. Você precisa de ⓐ o app Claude Desktop, ⓑ os dados de acesso ao servidor (endereço do host, conta, porta) e um arquivo de chave (.pem) e ⓒ o Node.js para rodar o pacote do servidor MCP no seu PC.
Você pode ver as etapas 1️⃣–4️⃣ de uma vez no simulador ou conferi-las pelo sumário.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-do-seu-servidor",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\caminho-da-chave\\minhachave.pem"
]
}
1️⃣ Teste da conexão SSH
Para registrar o servidor no Claude, teste a conexão SSH a partir do seu PC e prepare o que for preciso.
~]# 2️⃣ Registrar o SSH MCP Server
O SSH MCP Server só pode ser registrado no app, não na web. Abra o app Claude e vá em [Settings › Developer].
Clique em [Edit Config].
Abre-se a pasta que contém o claude_desktop_config.json.
Abra o arquivo num editor de texto como o Bloco de Notas ou o EditPlus e confira o conteúdo.
Na linha 47 da imagem, digite uma vírgula depois de [}] (,) e cole o item.
O item para colar está abaixo. Troque [--host] pelo endereço do servidor, [--port] pela porta SSH (padrão 22), [--username] pela conta de acesso e [--privateKey] pelo caminho completo do arquivo de chave (.pem).
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-do-seu-servidor",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\caminho-da-chave\\minhachave.pem"
]
}No Windows, defina command como cmd em vez de npx e coloque /c como primeiro item de args. No macOS ou no Linux, basta colocar npx direto em command e deixar /c de fora.
Se o arquivo não tiver o item mcpServers, não há onde colar. Nesse caso, deixe o arquivo inteiro assim.
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-do-seu-servidor",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\caminho-da-chave\\minhachave.pem"
]
}
}
}Ao terminar, pressione Ctrl + S para salvar.
3️⃣ Permissões de ferramentas e primeira execução
Reinicie o app Claude.Se nada mudar na tela, force o encerramento no Gerenciador de Tarefas e abra de novo; se aparecer um erro, veja a etapa 4️⃣.
Como teste simples, pedimos ao Claude que executasse o comando hostname.
4️⃣ Erro de conexão: Node.js não instalado
Pelo [View logs], viu-se que o erro aconteceu porque a pasta do Node.js (C:\Program Files\nodejs) não estava instalada.
Para instalar o Node.js, abra https://nodejs.org/ko/download no navegador.
Baixe o arquivo .msi para Windows e faça a instalação.
Deixe a caixa desmarcada e clique em Next. Ela pergunta se você quer instalar também ferramentas de compilação C/C++; o pacote SSH MCP não precisa delas, e se marcar, o Chocolatey e as ferramentas de build do Visual Studio também são instalados.
Feche o Claude por completo, inclusive em segundo plano, e abra de novo.
Ao conferir o log de novo, a mensagem tinha mudado para 'não conectado'.
Digite comandos de solução de problemas numa janela do CMD para achar a causa.
Daqui em diante, o próprio Claude pode ajudar a resolver, então o recomendado é verificar o erro você mesmo e corrigi-lo com a ajuda do Claude.
Ⅲ. FAQ
ℹ️ Aviso de afiliados
O conteúdo deste site contém links de afiliados. Quando um visitante compra um produto ou serviço por meio de um desses links, o site recebe uma comissão do vendedor. O valor que o comprador paga (em promoções, ele diminui ↓) não aumenta por causa disso. Preços, descontos e informações de estoque valem para o momento em que o texto foi escrito e podem ter mudado, por isso confirme com o vendedor antes de comprar. Os produtos são escolhidos e avaliados por critérios próprios, e o recebimento de comissão não influencia a ordem de apresentação nem o conteúdo das avaliações.