Claude MCP Linux: połączenie z serwerem i konfiguracja SSH
Nawet gdy powierzasz Claude pracę na serwerze Linux, plik klucza SSH nigdy nie opuszcza twojego komputera. Claude MCP Linux łączy Claude z terminalem i plikami twojego serwera Linux przez SSH. Tu opisano, co jest przesyłane, a co nie, a potem kolejne kroki konfiguracji.
Claude MCP(Model Context Protocol) to standard, którego Claude używa do łączenia się z zewnętrznymi narzędziami i danymi, a serwer MCP to program udostępniający funkcje zgodnie z tym standardem. Pojęcia i konfigurację konektorów w Claude Desktop opisano w artykule Claude MCP: podstawy poświęconym temu zagadnieniu.
Ⅰ. Czym jest serwer Claude MCP Linux?
Po podłączeniu MCP do Claude Desktop Claude czyta pliki na komputerze i wykonuje zadania. Połączenie Claude MCP Linux przenosi ten cel przez SSH na zdalny serwer Linux: polecenia działają na serwerze, a do Claude wracają tylko wyniki.
Na serwerze nie trzeba niczego nowego otwierać. Używasz tego samego SSH i klucza co zawsze; zmienia się tylko to, że polecenia wpisuje Claude, a nie człowiek. To, co może uruchomić i zobaczyć, wyznaczają uprawnienia konta logowania.
Ⅱ. Konfiguracja Claude MCP Linux
Konfiguracja ma cztery kroki, od testu połączenia SSH po sprawdzenie błędów połączenia. Potrzebujesz: ⓐ aplikacji Claude Desktop, ⓑ danych dostępu do serwera (adres hosta, konto, port) i pliku klucza (.pem) oraz ⓒ Node.js do uruchomienia pakietu serwera MCP na komputerze.
Kroki 1️⃣–4️⃣ zobaczysz naraz w symulatorze albo sprawdzisz w spisie treści.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-twojego-serwera",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\sciezka-do-klucza\\mojklucz.pem"
]
}
1️⃣ Test połączenia SSH
Aby zarejestrować serwer w Claude, przetestuj połączenie SSH z komputera i przygotuj to, czego potrzebujesz.
~]# 2️⃣ Rejestracja SSH MCP Server
SSH MCP Server można zarejestrować tylko w aplikacji, nie w przeglądarce. Uruchom aplikację Claude i przejdź do [Settings › Developer].
Kliknij [Edit Config].
Otwiera się folder z plikiem claude_desktop_config.json.
Otwórz plik w edytorze tekstu, takim jak Notatnik lub EditPlus i sprawdź zawartość.
W wierszu 47 na obrazku wpisz przecinek po [}] (,) i wklej wpis.
Wpis do wklejenia jest poniżej. W [--host] wpisz adres serwera, w [--port] port SSH (domyślnie 22), w [--username] konto logowania, a w [--privateKey] pełną ścieżkę pliku klucza (.pem).
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-twojego-serwera",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\sciezka-do-klucza\\mojklucz.pem"
]
}W Windows ustaw command na cmd zamiast npx i wpisz /c jako pierwszy element args. Na macOS lub Linuksie wystarczy wpisać npx bezpośrednio w command i pominąć /c.
Jeśli plik nie ma wpisu mcpServers, nie ma gdzie wkleić. Wtedy nadaj całemu plikowi taką postać.
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"ip-twojego-serwera",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\sciezka-do-klucza\\mojklucz.pem"
]
}
}
}Po zakończeniu naciśnij Ctrl + S, aby zapisać.
3️⃣ Uprawnienia narzędzi i pierwsze uruchomienie
Uruchom ponownie aplikację Claude.Jeśli na ekranie nic się nie zmieni, wymuś zamknięcie w Menedżerze zadań i uruchom ponownie; jeśli pojawi się błąd, zobacz krok 4️⃣.
Na prosty test poproszono Claude o uruchomienie polecenia hostname.
4️⃣ Błąd połączenia: brak Node.js
Według [View logs] błąd wystąpił, ponieważ folder Node.js (C:\Program Files\nodejs) nie był zainstalowany.
Aby zainstalować Node.js, otwórz https://nodejs.org/ko/download w przeglądarce.
Pobierz plik .msi dla Windows i zainstaluj go.
Zostaw pole niezaznaczone i kliknij Next. Pyta, czy zainstalować też narzędzia kompilacji C/C++; pakiet SSH MCP ich nie potrzebuje, a zaznaczenie instaluje też Chocolatey i narzędzia kompilacji Visual Studio.
Zamknij Claude całkowicie, także w tle, i uruchom ponownie.
Po ponownym sprawdzeniu logu komunikat zmienił się na 'niepołączony'.
Wpisz w oknie CMD polecenia diagnostyczne i ustal przyczynę.
Od tego miejsca pomóc może już sam Claude, więc warto samemu sprawdzić błąd i naprawić go z jego pomocą.
Ⅲ. FAQ
ℹ️ Informacja o linkach partnerskich
Treści tej witryny zawierają linki partnerskie. Jeśli odwiedzający kupi produkt lub usługę przez taki link, witryna otrzymuje od sprzedawcy prowizję. Kwota płacona przy tym przez kupującego (podczas promocji spada↓) nie wzrasta. Podane ceny, rabaty i dostępność odnoszą się do chwili pisania i mogą różnić się od stanu faktycznego, dlatego przed zakupem sprawdź je u sprzedawcy. Produkty wybieramy i oceniamy według własnych kryteriów, a prowizja nie wpływa ani na kolejność prezentacji, ani na treść ocen.