MCP Nedir: Claude Code'u Dış Dünyaya Bağlamak

Claude Code'un varsayılan olarak yapabilecekleri sınırlıdır: yerel dosyaları okuyup yazabilir, terminal komutlarını çalıştırabilir, yerleşik araçları kullanabilir. Ama gerçek projelerde çok daha fazlası gerekir — veritabanı sorgulamak, Notion belgelerini okumak, Slack mesajlarını aramak, dahili API'lara çağrı yapmak.

MCP tam olarak bu sorunu çözer.

MCP'nin Konumu

MCP (Model Context Protocol), Anthropic'in önerdiği açık bir protokoldür; AI modellerinin harici araçlar ve veri kaynaklarıyla nasıl iletişim kurduğunu tanımlar. Bunu Claude Code'a eklenti yüklemek olarak düşünebilirsin — her MCP Server, bir araç seti sunan bağımsız bir servistir ve Claude bu araçları oturum sırasında doğrudan çağırabilir.

Hooks'tan farklı olarak (Claude bir eylem gerçekleştirdiğinde betikleri tetikler), MCP Claude'un yetenek sınırlarını aktif olarak genişletir: neyi bağlarsan, Claude onu işleyebilir.

Nasıl Çalışır

Mimari oldukça basittir:

Claude Code (Client)  ←→  MCP Server  ←→  Harici Sistem

Konfigürasyonda bir MCP Server bildirirsin (yerel süreç veya uzak servis)
Claude Code başlarken bu Server'a bağlanır ve sunulan araçların listesini alır
Oturum boyunca Claude, bu araçları yerleşik Read/Write/Bash gibi çağırabilir
MCP Server isteği işler ve sonucu Claude'a döndürür

Tüm süreç kullanıcıya görünmezdir. Sen sadece Claude'un "veritabanına bir bakayım" deyip sonucu getirdiğini görürsün; arka planda MCP isteği iletmektedir.

Üç Tür MCP Yeteneği

MCP Server üç şey sunabilir:

Tools (Araçlar)
Claude'un aktif olarak çağırabileceği fonksiyonlar — "kullanıcı tablosunu sorgula", "belge ara", "Slack mesajı gönder". En yaygın kullanılan türdür, gerçek kullanım senaryolarının %90'ını kapsar.

Resources (Kaynaklar)
Claude'un bağlam olarak okuyabileceği yapılandırılmış veriler — veritabanı şeması, API belgeleri, konfigürasyon dosyaları.

Prompts (Prompt Şablonları)
Kullanıcıların doğrudan başvurabileceği önceden tanımlanmış prompt parçacıkları.

Pratikte neredeyse her zaman Tools ile çalışacaksın.

Hızlı Başlangıç: Mevcut Bir MCP Server Ekleme

Resmi Filesystem MCP'yi örnek alalım — bu Server, Claude'un çalışma dizini dışındaki dosya sistemine erişmesini sağlar.

Yükleme

npm install -g @modelcontextprotocol/server-filesystem

Konfigürasyon

~/.claude/settings.json dosyasını düzenle:

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

Doğrulama

Claude Code'u yeniden başlat ve dene:

/Users/yourname/Documents altındaki tüm PDF dosyalarını listele

Claude "dosya sistemine erişemiyorum" demek yerine sonuçları döndürüyorsa MCP çalışıyor demektir.

Konfigürasyon Yapısı

{
  "mcpServers": {
    "servis-adı": {
      "command": "başlatma komutu",
      "args": ["argüman listesi"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}

command + args: Claude Code'un MCP Server sürecini başlatmak için kullandığı komut
Servis adı yalnızca yerel bir etiket; istediğini kullanabilirsin
API anahtarları ve hassas konfigürasyon için env kullan; koda gömmekten kaçın

Konfigürasyon Nereye Koyulur

MCP konfigürasyonu düşükten yükseğe öncelik sırasıyla üç yerde olabilir:

Konum	Dosya	Ne Zaman Kullanılır
Global	`~/.claude/settings.json`	Her projede kullanmak istediğin araçlar
Proje	`.claude/settings.json`	Bu projeye özgü araçlar
Yerel override	`.claude/settings.local.json`	Kişisel konfigürasyon, git'e commit edilmez

Veritabanı bağlantıları ve dahili API'lar için proje konfigürasyonunu kullan ve kodla birlikte commit et. Repoyu klonlayan ekip üyeleri aynı MCP ortamını otomatik olarak edinir.

Mevcut MCP Server'lar Nerede Bulunur

Anthropic resmi sunucular sağlar:

@modelcontextprotocol/server-filesystem — dosya sistemi erişimi
@modelcontextprotocol/server-github — GitHub işlemleri (PR, issue, kod arama)
@modelcontextprotocol/server-postgres — PostgreSQL sorguları
@modelcontextprotocol/server-slack — Slack mesajlarını okuma ve yazma
@modelcontextprotocol/server-google-maps — harita ve coğrafi bilgi

Topluluk, Notion, Linear, Jira ve çeşitli veritabanlarını kapsayan çok sayıda üçüncü taraf uygulama geliştirmiştir.

MCP vs Hooks: Hangisini Seçmeli

	Hooks	MCP
Tetikleyici	Claude belirli bir eylem gerçekleştirdiğinde	Claude aktif olarak bir araç çağırdığında
Amaç	Mevcut davranışları kesmek/geliştirmek	Yeni yetenekler eklemek
Tipik senaryo	Kaydetmede biçimlendirme, commit öncesi kontrol	DB sorgulama, harici API çağrısı
Konfigürasyon karmaşıklığı	Düşük	Orta

İkisi birbirini tamamlar. Hooks Claude'un nasıl çalıştığını; MCP ise Claude'un ne yapabileceğini kontrol eder.

Sonraki Adımlar

Bu makale MCP'ye kavramsal bir girişti. Sonraki makaleler şunları kapsayacak:

Claude Code'u gerçek bir PostgreSQL veritabanına (gerçek şema ile) bağlamak
Dahili araçları ve API'ları bağlamak
Sıfırdan kendi MCP Server'ını yazmak

Bağlamak istediğin bir sistem varsa önce MCP Server listesine bak — büyük ihtimalle biri zaten yapmıştır.