MCP Kurulum Rehberi: Adım Adım

MCP (Model Context Protocol), Claude’u istediğiniz dış servise bağlamanın açık standardıdır. Bu sayfa bir MCP server’ı Claude Desktop veya claude.ai’a nasıl ekleyeceğinizi adım adım anlatır.

Connectors ile karıştırmayın: connector Anthropic’in resmî, hazır entegrasyonudur; MCP daha geniş ve özelleştirilebilirdir.

Önce: MCP mi, Connector mu?

Servisiniz…Tercih
Resmî Connector listesinde (Gmail, Drive, Slack, Notion vs.)Connector, daha kolay
Listede yok ama popüler bir SaaSMCP, büyük olasılıkla bir community MCP var
Şirket içi sistem (CRM, ERP)MCP, özel server yazılır
Hassas veriyle çalışıyorMCP + dikkatli Güvenlik yapılandırması

Eğer connector seçeneğiniz varsa, MCP’ye gerek yok. Hızlı kararı Bağlantı Listesi sayfası verir; resmî dizinde yaklaşık 900 connector vardır.

Kurulum Yeri: Claude Desktop mı, claude.ai mi?

İki ortamda da MCP destekleniyor:

  • Claude Desktop: Kişisel bilgisayarda yerel kurulum. Daha esnek, özel server’lar buradan kullanılır.
  • claude.ai: Web/mobil. Kurulum tek tık, ama özel server seçenekleri sınırlı.

Bu sayfa Claude Desktop üzerinden kurulumu odak alır, çünkü daha güçlü ve esnektir. Web tarafı için kısa bir bölüm sonda var.

Adım 1: Server Seçimi

Hangi MCP server’ı kullanacağınızı belirleyin. Üç ana kaynak:

A. Anthropic Resmî MCP Server’ları

GitHub’daki resmî MCP referans server deposu (modelcontextprotocol/servers) bugün yalnızca filesystem, fetch, git, memory, sequentialthinking, time ve everything server’larını bakımda tutar. github, postgres, slack ve brave-search gibi eski referans server’lar bakımı yapılmayan modelcontextprotocol/servers-archived deposuna taşındı.

Arşiv notu: Bu sayfadaki GitHub ve PostgreSQL yapılandırma örnekleri yalnızca yapıyı göstermek içindir. Gerçek kurulumda arşivdeki paketler yerine hizmet sağlayıcının resmî uzak MCP sunucusunu ya da güncel paketini seçin ve paket adını kurmadan önce doğrulayın.

Popüler MCP’ler sayfasında detay ve seçim kriterleri.

B. Topluluk MCP’leri

Açık kaynak topluluğu yüzlerce MCP server üretti: Notion, Linear, Jira, Salesforce, AWS ve benzerleri. GitHub’da arayarak veya MCP marketplace’lerinden bulabilirsiniz.

Dikkat: Topluluk MCP’leri denetlenmemiş olabilir. Güvenlik sayfasına bakın.

C. Şirket İçi Özel MCP

Kendi ERP/CRM sisteminize MCP yazmak için Anthropic’in MCP SDK’sini kullanırsınız (Python veya TypeScript). Bu geliştirici işi; BT departmanı ile koordine edilir.

Adım 2: Ön Koşullar

Çoğu MCP server için şu araçlar gerekli:

  • Node.js (v18+) veya Python 3.10+: server türüne bağlı
  • Claude Desktop kurulu: claude.ai/download adresinden indirilir
  • Yetkili hesap: server bağlanacağı servis için (örn. GitHub token, Slack access token)

Ön koşulları kurmak için terminal kullanmanız gerekir. Geliştirici değilseniz BT’den yardım alın.

Adım 3: Yapılandırma Dosyası

Claude Desktop, MCP yapılandırmasını bir JSON dosyasında saklar:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Dosya yoksa yaratırsınız (Claude Desktop ilk açıldığında oluşturmuş olabilir).

Temel yapı:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/kullanici/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Her server bir JSON nesnesi. Hangi komut çalışacak, ne argümanlar, hangi env değişkenleri.

Adım 4: Server Kuruluş Örneği

Örnek: Filesystem MCP

Claude’un yerel Documents klasörünüze erişebilmesi için:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/kullanici/Documents"
      ]
    }
  }
}

Açıklama:

  • command: npx → Node.js paket yürütücüsü
  • -y → otomatik onay
  • Paket adı → server’ın npm’deki adı
  • Son arg → erişim verilen klasör (sadece bu ve alt klasörleri erişilebilir)

Güvenlik: “Tüm hard disk” demek yerine spesifik klasör seçin.

Örnek: GitHub MCP

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    }
  }
}

GitHub’da Settings → Developer settings → Personal access tokens → fine-grained token oluşturun. Hangi repo’lar, hangi yetkiler, minimum verin.

Örnek: PostgreSQL MCP

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://kullanici:sifre@localhost:5432/veritabani"
      ]
    }
  }
}

Şifreyi konfige yazmaktan kaçının. Yerine env değişkeni kullanın.

Adım 5: Claude Desktop’ı Yeniden Başlatın

Yapılandırma dosyasını kaydettikten sonra:

  1. Claude Desktop’ı tamamen kapatın (sadece pencere kapatma değil, çıkış)
  2. Yeniden açın
  3. Yeni sohbet başlatın

MCP server’lar Claude açılışında tetiklenir. Açılış sırasında bir terminal penceresi açılabilir; bu normaldir, server süreci başlıyordur.

Adım 6: Doğrulama

Yeni bir sohbet açın, Claude’a sorun:

“Hangi MCP araçların aktif?”

Claude size aktif server’ların listesini söylemeli. Yoksa:

  • Server hata vermiş olabilir → Claude Desktop loglarını kontrol edin
  • Yapılandırma JSON yanlış olabilir → JSON validator ile sözdizimi kontrolü
  • Env değişkeni eksik → token / şifre doğru mu

Yaygın Sorunlar

Sorun: “Server bağlanamadı”

Çözüm:

  • Komut yolu doğru mu (npx PATH’te mi)
  • Paket adı doğru mu (yazım hatası yaygın)
  • Yetkilendirme token’ı geçerli mi

Sorun: “Claude server’ı görüyor ama çağıramıyor”

Çözüm:

  • Server yetkisi yetersiz (örn. GitHub token’da read yok)
  • Filesystem’de klasör yolu var olmayabilir

Sorun: “JSON syntax hatası”

Çözüm:

  • Virgül eksik / fazla
  • Tırnak işareti eksik
  • jsonlint.com gibi araçla kontrol

Sorun: “Antivirus / Firewall engelliyor”

Çözüm:

  • Kurumsal bilgisayarda IT politikası npx çalıştırmayı engelleyebilir
  • BT ile konuşun, BT Departmanı sayfası rehber içerir

claude.ai (Web) Üzerinde MCP

Web tarayıcısı sürümünde MCP desteği gelişiyor ve Claude Desktop kadar esnek değil. Resmî connector dizini buradan kullanılır; özel server eklemek için:

  1. Settings → Connectors / MCP (sürüme göre değişir)
  2. “Add custom MCP” benzeri seçenek (eğer mevcutsa)
  3. Server URL’si veya yapılandırma yüklenir

Çoğu durumda web’de Anthropic onaylı hazır server’lar gelir; özel şirket-içi MCP’leri Claude Desktop’tan kullanmak daha pratik.

Şirket İçi MCP: Özel Geliştirme

Kendi sisteminize MCP yazmak için:

  1. Anthropic MCP SDK seçin (Python veya TypeScript)
  2. Server’ın hangi kaynakları (resource) ve hangi araçları (tool) sunacağını tasarlayın
  3. Yetkilendirme akışını netleştirin (OAuth, API key, mTLS, vs.)
  4. Test edin (Claude Desktop’ta yerel olarak)
  5. Şirket içinde dağıtım (genelde dahili NPM registry, internal Docker, vs.)

BT Departmanı ve Güvenlik sayfaları kurumsal pratiği detaylandırır.

Birden Fazla Server Birlikte

Tek yapılandırma dosyasında 5-10 farklı server tutabilirsiniz:

{
  "mcpServers": {
    "filesystem": { ... },
    "github": { ... },
    "postgres": { ... },
    "slack": { ... },
    "internal-crm": { ... }
  }
}

Hepsi Claude’a sunulur. Hangisini ne zaman kullanacağına Claude karar verir. “GitHub’da ABC repo’sundaki son issue’ları getir” derseniz GitHub server’ına gider.

Kullanım: İlk Test

Server kurulduktan sonra deneme:

“Documents klasörümde bu hafta değiştirilen dosyaları listele.” (filesystem)

“Şu repo’daki açık PR’ları getir: kullanici/depo-adi” (github)

“Postgres’te customers tablosundan son 10 kayıt çek.” (postgres)

İlk kullanımda Claude size izin sormak isteyebilir; onayladığınızda server çağrılır.

Sürüm ve Güncellemeler

MCP server’lar npm üzerinden geliyorsa otomatik güncel sürüm kullanılır (-y argümanı). Manuel sabitlemek için sürüm belirtin:

"args": ["-y", "@modelcontextprotocol/server-github@1.2.3"]

Kurumsal kullanımda sürümü sabitlemek güvenlik açısından önerilir, çünkü beklenmedik bir güncelleme davranışı değiştirebilir.

Kurumsal Toplu Dağıtım

50+ kişiye aynı MCP yapılandırmasını dağıtmak için:

  • MDM (Mobile Device Management): şirket bilgisayarlarına otomatik config dağıtım
  • Internal package: şirket içi bir kurulum scripti
  • Enterprise plan ile organizasyon-genelinde MCP yönetimi (gelişen özellik)

Kurumsal MCP yönetimi için Takım ve Admin sayfasına bakın.

Yapılandırmayı Versiyonlamak

Yapılandırma dosyanızı git’te tutarsanız:

  • Değişiklik geçmişi izlenir
  • Bir bilgisayardan diğerine taşınabilir
  • BT’nin onayı PR ile yapılabilir

Ama sırlarınızı (token, şifre) git’e koymayın. Env değişkeni kullanın, .gitignore ekleyin.

İlgili Sayfalar

Son güncelleme:

Görüşme Talep Et