Claude MCP mit Linux-Server verbinden: SSH einrichten

Affiliate-Hinweis v3.1
Affiliate-Hinweis v3.2 (mobil)

Auch wenn du Claude Arbeit auf einem Linux-Server übergibst, verlässt deine SSH-Schlüsseldatei deinen PC nicht. Die Claude MCP Linux Server-Verbindung bindet Claude per SSH an Terminal und Dateien deines Linux-Servers; hier steht, was übertragen wird und was nicht, und danach die Einrichtung Schritt für Schritt.

Claude MCP(Model Context Protocol) ist der Standard, über den sich Claude mit externen Tools und Daten verbindet; Programme, die nach diesem Standard Funktionen bereitstellen, heißen MCP-Server. Grundlagen und die Einrichtung von Konnektoren in Claude Desktop sind im Beitrag Claude MCP: Grundlagen beschrieben.

Ⅰ. Was ist ein Claude MCP Linux-Server?

Bindest du MCP an Claude Desktop an, liest Claude Dateien auf deinem PC und führt Aufgaben aus. Die Claude MCP Linux Server-Verbindung verlegt dieses Ziel per SSH auf einen entfernten Linux-Server: Die Befehle laufen auf dem Server, und nur die Ergebnisse kommen zu Claude zurück.

Auf dem Server muss nichts neu geöffnet werden. Du nutzt dasselbe SSH und denselben Schlüssel wie immer; neu ist nur, dass Claude statt eines Menschen die Befehle eintippt. Was Claude ausführen und sehen darf, bestimmen die Rechte des Anmeldekontos.

Weg über die Anthropic-Server hervorheben Anthropic-Server Weg des Gesprächsinhalts hervorheben Gesprächsinhalt Mein PC Claude Desktop hervorheben Claude Desktop MCP-Serverprogramm hervorheben MCP-Serverprogramm Weg der Schlüsseldatei hervorheben Schlüsseldatei (.pem) Verlässt den PC nicht SSH Richtung des Befehls hervorheben Befehl Richtung der Ausgabe hervorheben Ausgabe Linux-Server Linux-Server hervorheben Führt den Befehl aus Schickt nur das Ergebnis zurück
Tippe auf einen Kasten oder Pfeil, dann bleibt nur dieser Teil hell. Vom Kasten der Schlüsseldatei führt keine Linie aus dem PC hinaus. Auf schmalen Bildschirmen das Bild zur Seite schieben.
Was übertragen wird
Eine Befehlszeile, die Claude geschrieben hat
Die Ausgabe, die dieser Befehl auf dem Server erzeugt hat
Beides ist Gesprächsinhalt und läuft daher über die Server von Anthropic. Sind die Daten auf deinem Server sensibel, bedenke das zuerst.
Was nicht übertragen wird
Der Inhalt der Schlüsseldatei (.pem)
Die SSH-Verbindung baut das MCP-Serverprogramm auf deinem PC auf. Dieses Programm liest den Schlüssel und nutzt ihn nur zur Authentifizierung; Claude bekommt ihn weder zu sehen noch geschickt.
Alle Dateien des Servers
Nur was ein Befehl ausliest, geht als Ausgabe hinaus; ganze Verzeichnisse werden nie kopiert.
Nur eine Richtung Der Server hat keinen Weg, Claude von sich aus anzusprechen. Eine Antwort kommt nur zurück, wenn eine Anfrage hinausgeht.

Ⅱ. Claude MCP Linux einrichten

Die Einrichtung läuft in vier Schritten, vom SSH-Verbindungstest bis zur Prüfung von Verbindungsfehlern. Du brauchst ⓐ die Claude Desktop App, ⓑ die Zugangsdaten des Servers (Host-Adresse, Konto, Port) und eine Schlüsseldatei (.pem) sowie ⓒ Node.js, um das MCP-Serverpaket auf deinem PC auszuführen.

Die Schritte 1️⃣–4️⃣ kannst du im Simulator auf einen Blick ansehen oder über das Inhaltsverzeichnis aufrufen.

🤖 Claude Desktop · SSH MCP Einstellungs-Simulator
1️⃣ SSH-Verbindung testen
Um den Server in Claude zu registrieren, testest du die SSH-Verbindung vom PC aus und legst bereit, was du brauchst.
~]#
ⓐ Claude Desktop App Die App, in der MCP läuft. Registrieren geht nur in der App, nicht im Web.
ⓑ Zugangsdaten des Servers Host-Adresse · Konto · Port und Schlüsseldatei (.pem)
ⓒ Node.js Führt das MCP-Serverpaket auf deinem PC aus.
2️⃣ Registrieren · Settings · Developer
Starte die Claude-App, öffne Settings · Developer, dann klicke auf [Edit Config]. Registrieren geht nur in der App, nicht im Web.
Eintrag für lokale MCP-Server im Bildschirm Settings › Developer der Claude-App
2️⃣ Registrieren · Ordner der Konfigurationsdatei
Der Ordner mit claude_desktop_config.json öffnet sich.
Ordner mit claude_desktop_config.json
2️⃣ Registrieren · Konfigurationsdatei öffnen
Öffne die Datei mit einem Texteditor wie Notepad oder EditPlus und prüfe den Inhalt.
claude_desktop_config.json in einem Texteditor geöffnet
2️⃣ Registrieren · Eintrag einfügen
Setze in Zeile 47 hinter } ein Komma (,), füge den Eintrag unten ein und speichere mit Ctrl + S.
    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "deine-server-ip",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\pfad-zum-schluessel\\meinschluessel.pem"
      ]
    }
Backslashes schreibst du doppelt. Unter macOS oder Linux trägst du bei command direkt npx ein und lässt /c weg.
1 / 2
Stelle zum Bearbeiten in claude_desktop_config.json claude_desktop_config.json in EditPlus bearbeitet
3️⃣ Erster Start · Einrichtung abgeschlossen
Starte die Claude-App neu. Ändert sich nichts, beende sie im Task-Manager und starte sie wieder.
Bildschirm nach abgeschlossener Einrichtung von Claude MCP Linux
3️⃣ Erster Start · hostname ausführen
Hier wurde Claude gebeten, den Befehl hostname auszuführen.
1 / 2
hostname mit SSH MCP Server ausführen 1 hostname mit SSH MCP Server ausführen 2
4️⃣ Fehlerprüfung · Protokoll: Node.js fehlt
Laut [View logs] fehlte der Node.js-Ordner (C:\Program Files\nodejs).
Fehlerprotokoll der SSH MCP Server-Verbindung
4️⃣ Fehlerprüfung · Node.js installieren
Lade die .msi-Datei für Windows herunter und installiere sie. Im 5. Bildschirm klickst du ohne Haken auf Next. Gefragt wird nach C/C++-Compiler-Tools, die das SSH-MCP-Paket nicht braucht; mit Haken werden auch Chocolatey und die Visual Studio Build Tools installiert.
1 / 5
Download-Seite von Node.js für Windows Installation von Node.js für Windows 1 Installation von Node.js für Windows 2: Installationspfad Installation von Node.js für Windows 3 Installation von Node.js für Windows 4: zusätzliche Tools
Die .msi-Datei für Windows lädst du von der offiziellen Download-Seite.
Download-Seite von Node.js
4️⃣ Fehlerprüfung · Server nicht verbunden · CMD
Beende Claude nach der Installation von Node.js vollständig, auch im Hintergrund, und starte es neu; das Protokoll meldet dann «nicht verbunden». Die Ursache findest du mit Befehlen in einem CMD-Fenster.
1 / 2
Protokoll: SSH MCP Server nicht verbunden Befehle zur Fehlersuche in einem CMD-Fenster
Hier sind die vier Schritte aus dem Text unten an einem Ort. Klicke dich links durch das Menü; ein Klick auf einen Screenshot vergrößert ihn.
Einrichtung von Claude MCP Linux

1️⃣ SSH-Verbindung testen

Um den Server in Claude zu registrieren, testest du die SSH-Verbindung vom PC aus und legst bereit, was du brauchst.

 ~]# 

2️⃣ SSH MCP Server registrieren

SSH MCP Server lässt sich nur in der App registrieren, nicht im Web. Starte die Claude-App und geh zu [Settings › Developer].

Claude MCP mit Linux-Server verbinden: SSH einrichten

Klicke auf [Edit Config].

Claude MCP mit Linux-Server verbinden: SSH einrichten

Der Ordner mit claude_desktop_config.json öffnet sich.

Claude MCP Linux Einrichtung 1 - Datei claude_desktop_config.json

Öffne die Datei mit einem Texteditor wie Notepad oder EditPlus und prüfe den Inhalt.

Claude MCP mit Linux-Server verbinden: SSH einrichten

Setze im Bild in Zeile 47 hinter [}] ein Komma (,) und füge danach den Eintrag ein.

Der einzufügende Eintrag steht unten. Ersetze bei [--host] die Server-Adresse, bei [--port] den SSH-Port (Standard 22), bei [--username] das Anmeldekonto und bei [--privateKey] den vollständigen Pfad der Schlüsseldatei (.pem) durch deine eigenen Werte.

    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "deine-server-ip",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\pfad-zum-schluessel\\meinschluessel.pem"
      ]
    }

Unter Windows gilt für command: nicht npx, sondern cmd, und als erster Eintrag in args kommt /c. Unter macOS oder Linux trägst du bei command direkt npx ein und lässt /c weg.

Hat die Datei keinen Eintrag mcpServers, gibt es keine Stelle zum Einfügen. Dann baust du die ganze Datei so auf wie unten.

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "deine-server-ip",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\pfad-zum-schluessel\\meinschluessel.pem"
      ]
    }
  }
}
Claude MCP Linux Einrichtung 2 - claude_desktop_config.json bearbeiten (EditPlus)

Wenn du fertig bist, speichere mit Ctrl + S.

3️⃣ Tool-Berechtigungen und erster Start

Starte die Claude-App neu.Ändert sich nichts, beende sie im Task-Manager und starte sie wieder; bei einem Fehler siehe Schritt 4️⃣.

Claude MCP Linux Einrichtung 'abgeschlossen'

Als einfachen Test habe ich Claude gebeten, den Befehl hostname auszuführen.

Claude MCP Linux - hostname mit SSH MCP Server ausführen 1
Claude MCP Linux - hostname mit SSH MCP Server ausführen 2

4️⃣ Verbindungsfehler: Node.js nicht installiert

Claude MCP mit Linux-Server verbinden: SSH einrichten

Laut [View logs] trat der Fehler auf, weil der Node.js-Ordner (C:\Program Files\nodejs) nicht installiert war.

Für die Installation von Node.js öffnest du https://nodejs.org/ko/download.

Claude MCP mit Linux-Server verbinden: SSH einrichten

Lade die .msi-Datei für Windows herunter und installiere sie.

Installation von Node.js für Windows 1
Claude MCP mit Linux-Server verbinden: SSH einrichten
Claude MCP mit Linux-Server verbinden: SSH einrichten
Installation von Node.js für Windows 4

Ohne Haken mit Next weiter. Gefragt wird, ob zusätzlich C/C++-Compiler-Tools installiert werden sollen; das SSH-MCP-Paket braucht sie nicht, und mit Haken werden auch Chocolatey und die Visual Studio Build Tools installiert.

Beende Claude vollständig, auch im Hintergrund, und starte es neu.

Claude MCP mit Linux-Server verbinden: SSH einrichten

Beim erneuten Blick ins Protokoll lautete die Meldung nun «nicht verbunden».

SSH MCP Server Verbindungsfehler 3 - Befehle im CMD-Fenster

Gib im CMD-Fenster Befehle zur Fehlersuche ein und finde die Ursache.

Ab hier kann dir Claude selbst gut weiterhelfen; ich empfehle, den Fehler direkt anzusehen und ihn mit Claudes Hilfe zu beheben.

Ⅲ. FAQ

Nein. SSH MCP Server ist ein Programm, das auf deinem PC läuft, und die Verbindung kommt nur zustande, wenn Claude dieses Programm direkt startet. Ein Browser kann keine Programme auf deinem PC ausführen; im Web lassen sich nur Remote-Dienste mit einer Internetadresse anbinden.

Bevor ein Befehl läuft, erscheint ein Freigabefenster, das den auszuführenden Befehl genau anzeigt. Ohne deine Freigabe läuft nichts. Was ausgeführt werden kann, ist außerdem auf die Rechte des Anmeldekontos begrenzt. Das SSH-MCP-Paket hat die Option [--whitelist], mit der du alle Befehle außer denen ablehnen lassen kannst, die zu den angegebenen regulären Ausdrücken passen.

Gib als Anmeldekonto eines an, das der Server zulässt. Bei AWS-Images ist ec2-user das Standardkonto, bei Ubuntu-Images ubuntu. Diese Konten haben sudo-Rechte; für Aufgaben mit Admin-Rechten bittest du Claude, dem Befehl sudo voranzustellen. Für einen direkten Root-Login musst du sowohl die sshd-Einstellungen des Servers als auch die Schlüsseldatei des Root-Kontos anpassen.

🤖 Beiträge zu Claude 3 Beiträge · 3 Tools
🗂️ Claude
📋 MCP-Grundlagen 📄 Linux-Server verbinden
📄 Drei Tools im Vergleich
🛠️ Whois-Domainabfrage 🛠️ IP-Abfrage 🛠️ UTF-8-Konverter

ℹ️ Affiliate-Hinweis
Die Inhalte dieser Website enthalten Affiliate-Links. Kauft ein Besucher über einen dieser Links ein Produkt oder eine Dienstleistung, erhält die Website vom Verkäufer eine Provision. Der Betrag, den der Käufer zahlt(bei Aktionsrabatten sinkt er ↓), steigt dadurch nicht. Angegebene Preise, Rabatte und Lagerbestände entsprechen dem Stand bei Erstellung und können abweichen; prüfe sie daher vor dem Kauf beim Verkäufer. Produkte werden nach eigenen Kriterien ausgewählt und bewertet, und Provisionen beeinflussen weder die Reihenfolge noch den Inhalt der Bewertungen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Beweisen Sie, dass Sie ein Mensch sind: 6   +   6   =