Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

Satış ortaklığı bildirimi v3.1
Satış ortaklığı bildirimi v3.2 (yalnızca mobil)

Linux sunucu işlerini Claude'a bıraksanız da SSH anahtar dosyanız bilgisayarınızdan hiç çıkmaz. Claude MCP Linux sunucu bağlantısı, Claude'u SSH üzerinden Linux sunucunuzun terminaline ve dosyalarına bağlar; neyin gidip neyin gitmediğinden kurulum sırasına kadar derledik.

Claude MCP(Model Context Protocol), Claude'un harici araçlara ve verilere bağlanırken kullandığı standarttır; MCP sunucusu ise bu standarda göre işlev sunan programdır. Kavram ve Claude Desktop bağlayıcı ayarları Claude MCP temel kavramlar yazısında anlatılıyor.

Ⅰ. Claude MCP Linux sunucusu nedir?

Claude Desktop'a MCP bağlarsanız Claude bilgisayarınızdaki dosyaları okur ve işleri çalıştırır. Claude MCP Linux sunucu bağlantısı bu hedefi SSH ile uzak bir Linux sunucusuna taşır; komutlar sunucuda çalışır ve Claude'a yalnızca sonuçlar döner.

Sunucu tarafında yeni bir şey açmanız gerekmez. Her zamanki SSH'yi ve anahtarı kullanırsınız; değişen tek şey komutları yazanın insan değil Claude olmasıdır. Neleri çalıştırıp görebileceğini bağlantı hesabının yetkileri belirler.

Anthropic sunucu yolunu vurgula Anthropic sunucuları Sohbet içeriği yolunu vurgula Sohbet içeriği Bilgisayarım Claude Desktop'ı vurgula Claude Desktop MCP sunucu programını vurgula MCP sunucu programı Anahtar dosyası yolunu vurgula Anahtar dosyası (.pem) Bilgisayardan hiç çıkmaz SSH Komut yönünü vurgula Komut Çıktı yönünü vurgula Çıktı Linux sunucusu Linux sunucusunu vurgula Komutu çalıştırır Yalnızca sonucu geri gönderir
Bir kutuya ya da oka tıklayınca yalnızca o kısım vurgulanır. Anahtar dosyası kutusundan bilgisayarın dışına çıkan çizgi yoktur. Dar ekranlarda şemayı yana kaydırın.
Gidip gelenler
Claude'un yazdığı tek satırlık komut
O komutun sunucuda verdiği çıktı
İkisi de sohbet içeriği olduğu için Anthropic sunucularından geçer. Sunucunuzdaki veriler hassassa önce bunu değerlendirin.
Gidip gelmeyenler
Anahtar dosyasının (.pem) içeriği
SSH bağlantısını kuran, bilgisayarınızda çalışan MCP sunucu programıdır. Anahtarı bu program okuyup yalnızca kimlik doğrulamada kullanır; Claude onu ne alır ne de görür.
Sunucunun tüm dosyaları
Yalnızca komutun okuduğu kısımlar çıktı olarak gider; klasörler hiçbir zaman toptan kopyalanmaz.
Tek yön Sunucunun Claude'a kendiliğinden ulaşacağı bir yol yoktur. Yanıt yalnızca bir istek gittiğinde geri gelir.

Ⅱ. Claude MCP Linux kurulumu

Kurulum, SSH bağlantı testinden bağlantı hatası kontrolüne kadar dört adımda ilerler. Gerekenler: ⓐ Claude Desktop uygulaması, ⓑ sunucu bağlantı bilgileri (ana makine adresi, hesap, port) ve anahtar dosyası (.pem), ⓒ MCP sunucu paketini bilgisayarınızda çalıştıracak Node.js.

1️⃣–4️⃣ adımlarını simülatörde tek seferde görebilir ya da içindekiler tablosundan kontrol edebilirsiniz.

🤖 Claude Desktop · SSH MCP Ayar simülatörü
1️⃣ SSH bağlantı testi
Sunucuyu Claude'a kaydetmek için bilgisayarınızdan SSH bağlantısını test edin ve gerekenleri hazırlayın.
~]#
ⓐ Claude Desktop uygulaması MCP'nin çalıştığı uygulama. Kayıt web'de değil, yalnızca uygulamada yapılır.
ⓑ Sunucu bağlantı bilgileri Ana makine adresi · hesap · port ve anahtar dosyası (.pem)
ⓒ Node.js MCP sunucu paketini bilgisayarınızda çalıştırır.
2️⃣ Kayıt · Settings · Developer
Claude uygulamasını başlatıp Settings · Developer bölümüne gidin ve [Edit Config] düğmesine tıklayın. Kayıt web'de değil, yalnızca uygulamada yapılır.
Claude uygulamasının Settings › Developer ekranındaki yerel MCP sunucusu
2️⃣ Kayıt · Yapılandırma dosyası klasörü
claude_desktop_config.json dosyasının bulunduğu klasör açılır.
claude_desktop_config.json dosyasının bulunduğu klasör
2️⃣ Kayıt · config dosyasını açma
Dosyayı Not Defteri ya da EditPlus gibi bir metin düzenleyiciyle açıp içeriği kontrol edin.
Metin düzenleyicide açılmış claude_desktop_config.json
2️⃣ Kayıt · Öğeyi yapıştırma
47. satırdaki } işaretinden sonra virgül (,) yazın, aşağıdaki öğeyi yapıştırın ve Ctrl + S ile kaydedin.
    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "sunucu-ip-adresiniz",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\anahtar-yolu\\anahtarim.pem"
      ]
    }
Ters eğik çizgileri ikişer yazın. macOS ya da Linux'ta command'a doğrudan npx yazın ve /c'yi çıkarın.
1 / 2
claude_desktop_config.json düzenleme yeri EditPlus'ta düzenlenmiş claude_desktop_config.json
3️⃣ İlk çalıştırma · Kurulum tamam
Claude uygulamasını yeniden başlatın. Ekranda değişiklik olmazsa Görev Yöneticisi'nden zorla kapatıp yeniden açın.
Claude MCP Linux kurulumu tamamlandıktan sonraki ekran
3️⃣ İlk çalıştırma · hostname çalıştırma
Claude'dan hostname komutunu çalıştırmasının istendiği ekran.
1 / 2
SSH MCP Server ile hostname komutunu çalıştırma 1 SSH MCP Server ile hostname komutunu çalıştırma 2
4️⃣ Hata kontrolü · Kayıt: Node.js kurulu değil
[View logs] ile bakıldığında hatanın Node.js klasörü (C:\Program Files\nodejs) olmadığı için çıktığı görüldü.
SSH MCP Server bağlantı hatası kaydı
4️⃣ Hata kontrolü · Node.js kurulumu
Windows için .msi dosyasını indirip kurun. 5. ekranda kutuyu işaretlemeden Next ile devam edin. Bu ekran C/C++ derleme araçlarını sorar; SSH MCP paketinin bunlara ihtiyacı yoktur, işaretlerseniz Chocolatey ve Visual Studio derleme araçları da kurulur.
1 / 5
Windows için Node.js indirme ekranı Windows için Node.js kurulumu 1 Windows için Node.js kurulumu 2: kurulum yolu Windows için Node.js kurulumu 3 Windows için Node.js kurulumu 4: ek araçlar
Windows için .msi dosyasını resmî indirme sayfasından indirin.
Node.js indirme sayfası
4️⃣ Hata kontrolü · Sunucu bağlanmadı · CMD
Node.js kurulduktan sonra Claude'u arka plan dahil tamamen kapatıp yeniden başlatınca kayıt «bağlanmadı» olarak değişir. Nedeni bulmak için CMD penceresine komut yazın.
1 / 2
SSH MCP Server bağlanmadı kaydı CMD penceresine yazılan sorun giderme komutları
Aşağıdaki yazıda anlatılan dört adım burada bir arada. Sol menüye tıklayarak inceleyin; ekran görüntüsüne tıklarsanız büyütülür.
Claude MCP Linux kurulum ekranı

1️⃣ SSH bağlantı testi

Sunucuyu Claude'a kaydetmek için bilgisayarınızdan SSH bağlantısını test edin ve gerekenleri hazırlayın.

 ~]# 

2️⃣ SSH MCP Server kaydı

SSH MCP Server web'de değil, yalnızca uygulamada kaydedilebilir. Claude uygulamasını başlatıp [Settings › Developer] bölümüne gidin.

Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

[Edit Config] düğmesine tıklayın.

Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

claude_desktop_config.json dosyasının bulunduğu klasör açılır.

Claude MCP Linux kurulumu 1 - claude_desktop_config.json dosyası

Dosyayı Not Defteri ya da EditPlus gibi bir metin düzenleyiciyle açıp içeriği kontrol edin.

Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

Görseldeki 47. satırda [}] işaretinden sonra virgül (,) yazıp öğeyi yapıştırın.

Yapıştırılacak öğe aşağıdadır. [--host] yerine sunucu adresini, [--port] yerine SSH portunu (varsayılan 22), [--username] yerine bağlantı hesabını, [--privateKey] yerine anahtar dosyasının (.pem) tam yolunu kendi değerlerinizle yazın.

    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "sunucu-ip-adresiniz",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\anahtar-yolu\\anahtarim.pem"
      ]
    }

Windows'ta command değerini npx yerine cmd yapın ve args'ın ilk öğesine /c koyun. macOS ya da Linux'ta command'a doğrudan npx yazıp /c'yi çıkarmanız yeterlidir.

Dosyada mcpServers öğesi yoksa yapıştıracak yer de yoktur. Bu durumda dosyanın tamamını aşağıdaki biçime getirin.

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "sunucu-ip-adresiniz",
        "--port",
        "22",
        "--username",
        "root",
        "--privateKey",
        "C:\\anahtar-yolu\\anahtarim.pem"
      ]
    }
  }
}
Claude MCP Linux kurulumu 2 - claude_desktop_config.json düzenleme (EditPlus)

Bitince Ctrl + S ile kaydedin.

3️⃣ Araç izinleri ve ilk çalıştırma

Claude uygulamasını yeniden başlatın.Ekranda değişiklik olmazsa Görev Yöneticisi'nden zorla kapatıp yeniden açın; hata çıkarsa 4️⃣ adımına bakın.

Claude MCP Linux kurulumu 'tamam'

Basit bir deneme olarak Claude'dan hostname komutunu çalıştırması istendi.

Claude MCP Linux - SSH MCP Server ile hostname çalıştırma 1
Claude MCP Linux - SSH MCP Server ile hostname çalıştırma 2

4️⃣ Bağlantı hatası: Node.js kurulu değil

Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

[View logs] ile bakıldığında hatanın Node.js klasörü (C:\Program Files\nodejs) kurulu olmadığı için oluştuğu görüldü.

Node.js'i kurmak için https://nodejs.org/ko/download adresine gidin.

Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

Windows için .msi dosyasını indirip kurulumu yapın.

Windows için Node.js kurulumu 1
Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu
Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu
Windows için Node.js kurulumu 4

Kutuyu işaretlemeden Next ile devam edin.  C/C++ derleme araçlarının da kurulup kurulmayacağını sorar; SSH MCP paketinin bunlara ihtiyacı yoktur, işaretlerseniz Chocolatey ve Visual Studio derleme araçları da kurulur.

Claude'u arka plan dahil tamamen kapatıp yeniden başlatın.

Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu

Kayda yeniden bakınca mesajın 'bağlanmadı' olarak değiştiği görüldü.

SSH MCP Server bağlantı hatası 3 - CMD'ye yazılan komutlar

Sorunu çözmek için CMD penceresine komutlar yazıp nedeni bulun.

Bu noktadan sonrasını Claude'a sorarak çözmek gayet mümkündür; bu yüzden hatayı kendiniz inceleyip Claude'un yardımıyla düzeltmenizi öneririz.

Ⅲ. FAQ

Çalışmaz. SSH MCP Server bilgisayarınızın içinde çalışan bir programdır ve bağlantı ancak Claude bu programı kendisi başlattığında kurulur. Tarayıcı bilgisayarınızdaki programları çalıştıramaz; web'de bağlayabileceğiniz yalnızca internet adresi olan uzak hizmetlerdir.

Komut çalışmadan önce bir izin penceresi açılır ve orada çalışacak komut olduğu gibi gösterilir. Siz izin vermezseniz hiçbir şey çalışmaz. Çalıştırılabilecekler de bağlantı hesabının yetkilerini aşamaz. SSH MCP paketinde [--whitelist] seçeneği vardır; belirttiğiniz düzenli ifadelere uymayan her komutu tamamen reddettirebilirsiniz.

Bağlantı hesabını sunucunun izin verdiği bir hesap olarak ayarlamanız yeterlidir. AWS türevi görüntülerde varsayılan hesap ec2-user, Ubuntu görüntülerinde ubuntu'dur. Bu hesaplar sudo yetkisine sahiptir; yönetici yetkisi gereken işlerde Claude'dan komutun başına sudo eklemesini isteyin. Doğrudan root ile bağlanmak için sunucunun sshd ayarlarını ve root hesabının anahtar dosyasını birlikte düzenlemeniz gerekir.

🤖 Claude ile ilgili yazılar 3 yazı · 3 araç
🗂️ Claude
📋 MCP temel kavramları 📄 Linux sunucu bağlantısı
📄 Üç aracın karşılaştırması
🛠️ Whois alan adı sorgulama 🛠️ IP sorgulama 🛠️ UTF-8 dönüştürücü
Claude MCP: temel kavramlar, kullanım ve kurulum
App · MCP
Claude MCP: temel kavramlar, kullanım ve kurulum
MCP'nin ne olduğu ve Claude Desktop'a nasıl bağlandığı; kurulum adımları ve yerel sunucu ile uzak bağlayıcı arasındaki farkla birlikte.
Yazıyı oku →
Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu
Linux · SSH
Claude MCP Linux: sunucu bağlantısı ve SSH kurulumu
Claude'un bir Linux sunucusunda komut çalıştırabilmesi için SSH MCP sunucusunu kaydetme ayarı. Claude'un yapabileceklerinin sınırını bağlanılan hesabın yetkileri belirler.
Şu anki yazı

ℹ️ Satış ortaklığı bildirimi
Bu sitenin içeriklerinde satış ortaklığı bağlantıları bulunur. Bir ziyaretçi bu bağlantılar üzerinden ürün veya hizmet satın alırsa bu site satıcıdan komisyon alır. Bu süreçte alıcının ödediği tutar (kampanya indirimlerinde tutar düşer↓) artmaz. Yayımlanan fiyat, indirim ve stok bilgileri yazının yazıldığı zamana aittir ve gerçek durumdan farklı olabilir; bu yüzden satın almadan önce son bilgiyi satıcıdan kontrol etmenizi rica ederiz. Ürünler kendi ölçütlerimize göre seçilir ve değerlendirilir; komisyon alınıp alınmaması tanıtım sırasını veya değerlendirme içeriğini etkilemez.

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

İnsan olduğunuzu kanıtlayın: 10   +   10   =