Claude MCP Linux: server koppelen en SSH instellen
Ook als je werk op je Linux-server aan Claude overlaat, verlaat je SSH-sleutelbestand je pc nooit. Claude MCP Linux serververbinding koppelt Claude via SSH aan de terminal en de bestanden van je Linux-server. Hier lees je wat er wel en niet wordt doorgegeven, en daarna de stappen om het in te stellen.
Claude MCP(Model Context Protocol) is de standaard die Claude gebruikt om verbinding te maken met externe tools en data, en een MCP-server is een programma dat functies levert volgens die standaard. Het concept en het instellen van de connector in Claude Desktop worden in het artikel Claude MCP-basisbegrippen uitgelegd.
Ⅰ. Wat is een Claude MCP Linux-server?
Koppel je MCP aan Claude Desktop, dan leest Claude bestanden op je pc en voert hij taken uit. Een Claude MCP Linux-serververbinding verplaatst dat doel via SSH naar een externe Linux-server: commando's draaien op de server en alleen de resultaten komen terug bij Claude.
Op de server hoeft niets nieuws open te staan. Je gebruikt dezelfde SSH en sleutel als altijd; het enige verschil is dat Claude de commando's typt in plaats van een mens. Wat Claude kan uitvoeren en zien, hangt af van de rechten van het inlogaccount.
Ⅱ. Claude MCP Linux instellen
Het instellen gaat in vier stappen, van een SSH-verbindingstest tot het controleren van verbindingsfouten. Je hebt nodig: ⓐ de Claude Desktop-app, ⓑ toegangsgegevens van de server (hostadres, account, poort) en een sleutelbestand (.pem), en ⓒ Node.js om het MCP-serverpakket op je pc te draaien.
De stappen 1️⃣–4️⃣ kun je in één keer in de simulator bekijken of via de inhoudsopgave nalopen.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"jouw-server-ip",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\pad-naar-sleutel\\mijnsleutel.pem"
]
}
1️⃣ SSH-verbinding testen
Om de server in Claude te registreren, test je de SSH-verbinding vanaf je pc en zet je klaar wat je nodig hebt.
~]# 2️⃣ SSH MCP Server registreren
SSH MCP Server kan alleen in de app worden geregistreerd, niet op het web. Start de Claude-app en ga naar [Settings › Developer].
Klik op [Edit Config].
De map met claude_desktop_config.json gaat open.
Open het bestand in een teksteditor zoals Kladblok of EditPlus en bekijk de inhoud.
Typ op regel 47 in de afbeelding een komma na [}] (,) en plak het item.
Hieronder staat het item om te plakken. Vervang [--host] door het serveradres, [--port] door de SSH-poort (standaard 22), [--username] door het inlogaccount en [--privateKey] door het volledige pad van het sleutelbestand (.pem).
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"jouw-server-ip",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\pad-naar-sleutel\\mijnsleutel.pem"
]
}Zet onder Windows command op cmd in plaats van npx en zet /c als eerste item in args. Op macOS of Linux zet je npx direct in command en laat je /c weg.
Heeft het bestand geen item mcpServers, dan is er geen plek om te plakken. Maak in dat geval het hele bestand zo:
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"jouw-server-ip",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\pad-naar-sleutel\\mijnsleutel.pem"
]
}
}
}Druk als je klaar bent op Ctrl + S om op te slaan.
3️⃣ Toolrechten en eerste uitvoering
Start de Claude-app opnieuw.Verandert er niets op het scherm, sluit hem dan geforceerd af via Taakbeheer en start hem opnieuw; verschijnt er een fout, zie dan stap 4️⃣.
Als eenvoudige test is Claude gevraagd het commando hostname uit te voeren.
4️⃣ Verbindingsfout: Node.js niet geïnstalleerd
Volgens [View logs] ontstond de fout doordat de map van Node.js (C:\Program Files\nodejs) niet geïnstalleerd was.
Open voor de installatie van Node.js https://nodejs.org/ko/download in je browser.
Download het .msi-bestand voor Windows en installeer het.
Laat het vakje leeg en klik op Next. Er wordt gevraagd of je ook C/C++-compileertools wilt installeren; het SSH MCP-pakket heeft die niet nodig, en vink je het aan, dan worden ook Chocolatey en de buildtools van Visual Studio geïnstalleerd.
Sluit Claude helemaal af, ook op de achtergrond, en start hem opnieuw.
Bij een nieuwe blik op de log was de melding veranderd in 'niet verbonden'.
Typ in een CMD-venster commando's om het probleem op te lossen en zoek de oorzaak.
Vanaf hier kan Claude zelf je helpen het op te lossen, dus het is aan te raden de fout zelf te bekijken en hem met hulp van Claude te verhelpen.
Ⅲ. FAQ
ℹ️ Affiliatemelding
De content van deze site bevat affiliatelinks. Koopt een bezoeker via een van deze links een product of dienst, dan ontvangt deze site een commissie van de verkoper. Het bedrag dat de koper betaalt (bij acties gaat het omlaag ↓) wordt daardoor niet hoger. De vermelde prijzen, kortingen en voorraad gelden op het moment van schrijven en kunnen afwijken; controleer ze daarom vóór je aankoop bij de verkoper. Producten worden gekozen en beoordeeld volgens onze eigen criteria, en commissies hebben geen invloed op de volgorde of de inhoud van de beoordelingen.