Claude Code ile MCP server'lar
MCP servers with Claude Code
Bu derste neler öğreneceksin
- MCP server eklemenin üç farklı scope'unu (local/user/project) seçmek
- claude mcp add ile bir HTTP veya stdio server bağlamak
- .mcp.json ile takımla paylaşılan server seti kurmak
- Context maliyetini izlemek ve gereksiz server'ları kapatmak
Model Context Protocol (MCP), Claude Code’u dış araçlara (Linear, GitHub, Slack, kendi DB’in) bağlamanın standart yoludur. Bu ders kurulum, scope ve dikkat edilecek noktaları kapsar.
1. MCP server türleri
| Tür | Çalışma yeri | Tipik kullanım |
|---|---|---|
| HTTP | Uzak (servis sağlayıcı host eder) | Linear, GitHub Cloud, Notion |
| Stdio | Local process (makinende) | Local DB query’leri, in-house tool’lar |
2. Sunucu eklemek
claude mcp add linear "npx -y @linear/mcp-server"İlk argüman: adlandırma. İkinci: çalıştırma komutu. Claude bunu otomatik scope’larda user seviyesine yazar.
Scope belirlemek için:
claude mcp add --scope project linear "npx -y @linear/mcp-server"3. Üç scope
| Scope | Saklandığı yer | Erişim |
|---|---|---|
| Local | ~/.claude.json (proje bazlı dilim) | Sadece sen, sadece bu proje |
| User | ~/.claude.json (user dilimi) | Sadece sen, tüm projelerinde |
| Project | Repo’daki .mcp.json | Repo’yu açan herkes |
4. Server’ları yönetmek
Oturum içinde:
/mcpTüm bağlı server’ları, durumlarını ve sundukları tool’ları listeler. Buradan tek tek aktif/pasif yapabilirsin.
5. Context maliyetinin farkında ol
MCP server’lar tool tanımlarını context’e yükler — kullanmasan bile. 10 server bağlıysa context’inin %5-10’u oraya gider.
Önlem:
- Aktif kullanmadığın server’ları
/mcpile kapat - CLI alternatifi varsa onu tercih et (örn:
ghCLI → GitHub MCP’ye gerek olmayabilir) - Skill alternatifi varsa onu tercih et (skill sadece isim + açıklama yükler, içerik lazım olduğunda yüklenir)
6. Yaygın MCP server’ları
| Server | Ne işe yarar |
|---|---|
| GitHub | Issue, PR, repo işlemleri |
| Linear | Sprint ve issue context’i |
| Slack | Kanal mesajı, thread okuma |
| Notion | Dokuman yapısına erişim |
| Filesystem | Sandbox edilmiş dosya erişimi |
| Postgres / SQLite | Veritabanı query |
| Puppeteer / Playwright | Browser otomasyonu |
7. Kendi MCP server’ını yazmak
İhtiyacın tam karşılanmıyorsa kendi MCP server’ını yazabilirsin. Anthropic’in Introduction to Model Context Protocol kursunda Python ile sıfırdan örnek var. Bu kursun kapsamı dışında ama bilmen iyi — ihtiyacın çıktığında ders olarak orada.
Özet
claude mcp addile ekle, scope seç- Takım için
.mcp.jsoncommit et /mcpile durumu izle, gereksizleri kapat- Context maliyetini gözle — CLI veya Skill alternatiflerini değerlendir
Sırada ne var?
Bir sonraki derste GitHub entegrasyonu: PR yorumlarına yanıt, issue’dan PR üretme ve claude mention akışı.