Claude MCP Linux: collegare un server e configurare SSH
Anche se affidi a Claude il lavoro sul server Linux, il tuo file della chiave SSH non lascia mai il PC. Claude MCP Linux collega Claude al terminale e ai file del tuo server Linux via SSH. Qui trovi cosa passa e cosa no, poi i passaggi di configurazione.
Claude MCP(Model Context Protocol) è lo standard che Claude usa per collegarsi a strumenti e dati esterni, e un server MCP è un programma che fornisce funzioni secondo quello standard. I concetti e la configurazione dei connettori in Claude Desktop sono nell'articolo Claude MCP: concetti di base dedicato all'argomento.
Ⅰ. Cos'è un server Claude MCP Linux?
Collegando MCP a Claude Desktop, Claude legge i file sul tuo PC ed esegue attività. La connessione Claude MCP Linux sposta questo obiettivo via SSH su un server Linux remoto: i comandi girano sul server e a Claude tornano solo i risultati.
Sul server non serve aprire nulla di nuovo. Usi lo stesso SSH e la stessa chiave di sempre; l'unica differenza è che a digitare i comandi è Claude e non una persona. Cosa può eseguire e vedere dipende dai permessi dell'account di accesso.
Ⅱ. Configurare Claude MCP Linux
La configurazione richiede quattro passaggi, dal test della connessione SSH al controllo degli errori di connessione. Ti servono ⓐ l'app Claude Desktop, ⓑ i dati di accesso al server (indirizzo host, account, porta) e un file della chiave (.pem) e ⓒ Node.js per far girare il pacchetto del server MCP sul tuo PC.
Puoi vedere i passaggi 1️⃣–4️⃣ tutti insieme nel simulatore o controllarli dall'indice.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-del-tuo-server",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\percorso-chiave\\miachiave.pem"
]
}
1️⃣ Test della connessione SSH
Per registrare il server in Claude, prova la connessione SSH dal tuo PC e prepara ciò che serve.
~]# 2️⃣ Registrare SSH MCP Server
SSH MCP Server si può registrare solo nell'app, non sul web. Avvia l'app Claude e vai in [Settings › Developer].
Fai clic su [Edit Config].
Si apre la cartella che contiene claude_desktop_config.json.
Apri il file con un editor di testo come Blocco note o EditPlus e controllane il contenuto.
Alla riga 47 dell'immagine, digita una virgola dopo [}] (,) e incolla la voce.
La voce da incollare è qui sotto. Sostituisci [--host] con l'indirizzo del server, [--port] con la porta SSH (predefinita 22), [--username] con l'account di accesso e [--privateKey] con il percorso completo del file della chiave (.pem).
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-del-tuo-server",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\percorso-chiave\\miachiave.pem"
]
}Su Windows imposta command su cmd invece di npx e metti /c come primo elemento di args. Su macOS o Linux basta mettere npx direttamente in command e togliere /c.
Se il file non ha la voce mcpServers, non c'è un punto in cui incollare. In quel caso rendi l'intero file così.
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-del-tuo-server",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\percorso-chiave\\miachiave.pem"
]
}
}
}Quando hai finito, premi Ctrl + S per salvare.
3️⃣ Permessi degli strumenti e prima esecuzione
Riavvia l'app Claude.Se sullo schermo non cambia nulla, chiudila forzatamente da Gestione attività e riavviala; se compare un errore, vedi il passaggio 4️⃣.
Come semplice prova, abbiamo chiesto a Claude di eseguire il comando hostname.
4️⃣ Errore di connessione: Node.js non installato
Da [View logs] è risultato che l'errore si è verificato perché la cartella di Node.js (C:\Program Files\nodejs) non era installata.
Per installare Node.js, apri https://nodejs.org/ko/download nel browser.
Scarica il file .msi per Windows e installalo.
Lascia la casella vuota e fai clic su Next. Chiede se installare anche gli strumenti di compilazione C/C++; al pacchetto SSH MCP non servono, e se lo spunti vengono installati anche Chocolatey e gli strumenti di build di Visual Studio.
Chiudi del tutto Claude, anche in background, e riavvialo.
Ricontrollando il log, il messaggio era diventato 'non connesso'.
Digita comandi di risoluzione dei problemi in una finestra CMD per trovare la causa.
Da qui in poi è Claude stesso a poterti aiutare, quindi conviene controllare direttamente l'errore e risolverlo con l'aiuto di Claude.
Ⅲ. FAQ
ℹ️ Informativa sull'affiliazione
I contenuti di questo sito includono link di affiliazione. Se un visitatore acquista un prodotto o un servizio tramite uno di questi link, il sito riceve una commissione dal venditore. In questo processo l'importo pagato dall'acquirente (durante le promozioni l'importo scende↓) non aumenta. Prezzi, sconti e disponibilità indicati si riferiscono al momento della stesura e possono differire da quelli reali: prima di acquistare verifica sempre presso il venditore. I prodotti vengono scelti e valutati secondo criteri propri, e le commissioni non influiscono sull'ordine di presentazione né sul contenuto delle valutazioni.