Anla Dene

Claude · Gelişmiş · 202 Genişlet · Konu 3 / 5

4.3 MCP

Başka araçtan veri kopyalamayı bırak, Claude doğrudan bağlansın.

Bu sayfada ne öğreneceksin

Kısaca

Bir sorun takip aracından, bir izleme panosundan ya da bir veritabanından Claude'a sürekli veri kopyalıyorsan, MCP bunun içindir. Dokümana göre MCP (Model Context Protocol, "model bağlam protokolü") yapay zekâ ile araçları birleştirmek için kullanılan açık kaynaklı bir standarttır. Bir MCP sunucusu Claude Code'a araçlarına, veritabanlarına ve API'lerine erişim verir. Bağlandıktan sonra Claude o sisteme doğrudan bakabilir ve ona karşı iş yapabilir; sen yapıştırmak zorunda kalmazsın.

Kursun ifadesiyle bağlamın çoğu kod tabanının dışında durur: veritabanlarında, üretkenlik uygulamalarında, açık depolarda. MCP bu boşluğu kapatır. Örneğin ekibin proje yönetiminde Linear kullanıyorsa bir Linear MCP sunucusu eklersin, belirli sorunların ayrıntıları Claude'a gelir. Bir bağımlılığın güncel belgesi lazımsa Context7 gibi bir belge sunucusu bunu sağlar.

Bu sayfa MCP'yi kullanmayı anlatır. Kendi MCP sunucunu yazmak Seviye 5'in konusudur ve burada işlenmez.

Kavramlar

MCP kursundan üç kavram yeter:

Claude Code'da üçünün karşılığı şöyle (dokümana göre): sunucunun araçlarını Claude gerektiğinde kendisi çağırır. Kaynaklara komut satırında @ yazarak bakarsın, dosya gibi anılırlar. İstemler / yazınca komut olarak listelenir ve /mcp__sunucuadi__istemadi biçiminde de çalıştırılır.

Adım adım

  1. Önce güvenmeye karar ver. Eklemeden önce sunucuya güvendiğinden emin ol. Doküman uyarıyor: dış içerik getiren sunucular seni istem enjeksiyonu (prompt injection) riskine açabilir. Anthropic Directory'deki gözden geçirilmiş bağlayıcılara dokümanda bağlantı var; başka sunucular için güven kararı sende.
  2. Taşıma türünü seç. Uzak hizmetler için HTTP sunucusu (dokümanın önerdiği, en yaygın desteklenen tür). Makinende çalışan bir süreç için stdio sunucusu. SSE (Server-Sent Events) taşıması eskidir (deprecated); mümkünse HTTP kullan. WebSocket yalnızca .mcp.json ya da claude mcp add-json ile ayarlanır.
  3. Terminalde ekle. Komutu claude oturumunun içinde değil, terminalde çalıştır. Biçim: claude mcp add --transport http <ad> <url>. Ad senin seçtiğin bir etikettir; Claude Code aracı onunla etiketler ve claude mcp remove gibi komutlarda onunla anar. Beklenen sonuç: Added ... ile başlayan bir onay satırı.
  4. Durumunu kontrol et. claude mcp list her sunucunun yanında sağlık durumunu gösterir (örneğin bağlı, kimlik doğrulaması gerekiyor, bağlanamadı). Oturum içinde /mcp yazarak da bakabilirsin.
  5. Gerekirse giriş yap. Bazı bulut sunucuları kimlik doğrulaması ister; Claude Code OAuth 2.0'ı destekler. Oturumda /mcp yaz ve tarayıcıdaki adımları izle. Dokümana göre jetonlar güvenli saklanır ve otomatik yenilenir; erişimi geri almak için /mcp menüsündeki "Clear authentication" seçeneği var.
  6. Kullan. Normal bir istek yaz; Claude, sunucunun araçlarını ne zaman kullanacağına kendisi karar verir. Doküman örnek olarak bir sorun takip kaydında anlatılan özelliği eklemeyi ve GitHub'da PR açmayı sayıyor.
  7. Kullanmadığını kapat. Her bağlı sunucu araç adlarını ve talimatlarını bağlam penceresine ekler, kullanmasan bile. /mcp ile hangisi bağlı bak, işine yaramayanı kapat. Doküman, sunucuyu silmeden kapatmanın da yolu olduğunu söylüyor: /mcp panelinde sunucuyu kapatırsın, yapılandırma silinmez.

Kapsamlar

Bir sunucuyu nerede kaydettiğin, hangi projelerde yüklendiğini ve ekiple paylaşılıp paylaşılmadığını belirler. Varsayılan kapsam yereldir (local).

KapsamNerede yüklenirEkiple paylaşılır mıNerede saklanır
Yerel (local)Yalnızca bu projeHayır~/.claude.json
Proje (project)Yalnızca bu projeEvet, sürüm kontrolüyleProje kökündeki .mcp.json
Kullanıcı (user)Tüm projelerinHayır~/.claude.json

Kapsamı --scope seçeneğiyle verirsin: --scope user ya da --scope project. Gizli bilgi isteyen kişisel sunucuları sürüm kontrolüne koymak istemiyorsan yerel kapsamı kullan; doküman da yerel kapsamı kimlik bilgisi içeren sunucular için öneriyor. Aynı sunucu birden çok yerde tanımlıysa Claude Code ona bir kez bağlanır ve en yüksek öncelikli kaynağı kullanır: sırayla yerel, proje, kullanıcı, sonra eklentilerin sunucuları ve claude.ai bağlayıcıları.

Proje kapsamı .mcp.json dosyasını yazar. Dokümandaki biçim:

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Güvenlik gereği Claude Code, etkileşimli oturumlarda .mcp.json içindeki proje sunucularını kullanmadan önce senden onay ister. Başka birinden aldığın bir depoda bu onayı vermeden önce dosyanın içine bak. Onay seçimlerini sıfırlamak için claude mcp reset-project-choices var.

Güvenlik

Bağlam maliyeti

Kurs ve doküman aynı noktayı söylüyor: bağlı sunucular araç adlarını ve talimatlarını bağlama koyar. Araç arama (tool search) varsayılan olarak açıktır; Claude Code her MCP aracının tam tanımını Claude'un ihtiyacı olana kadar bağlamın dışında tutar. Yine de kullanmadığın sunucuyu kapat. Bir aracın komut satırı karşılığı varsa (GitHub için gh, AWS için aws gibi) kurs komut satırının bağlam açısından daha verimli olduğunu söylüyor, çünkü her araç için ayrı bir kayıt eklemez. Bir MCP sunucusunu, araçlarını iyi kullanmayı öğreten bir skill ile (4.1) birlikte kullanabilirsin.

Hazır komutlar

Terminalde, Claude Code oturumunun dışında. Claude Code belgelerini arayan, kimlik doğrulaması istemeyen uzak bir sunucu (dokümanın ilk sunucu denemesi için kullandığı örnek):

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

Genel biçim (HTTP sunucusu):

claude mcp add --transport http <ad> <url>

Bearer jetonu isteyen uzak sunucu (jeton yer tutucudur, kendi jetonunu bir sır olarak sakla):

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Yerel stdio sunucusu. -- işareti Claude'un kendi seçeneklerini sunucunun komutundan ayırır; YOUR_KEY yer tutucudur:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Tüm projelerinde kullanmak için kullanıcı kapsamı, ekiple paylaşmak için proje kapsamı:

claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp
claude mcp add --scope project --transport http claude-code-docs https://code.claude.com/docs/mcp

Yönetim komutları (terminalde):

claude mcp list
claude mcp get <ad>
claude mcp remove <ad>

Oturum içinde durumu görmek ve gerekirse giriş yapmak için:

/mcp

Dokümana göre uzak bir sunucuyu kaldırdığında Claude Code onun için sakladığı OAuth jetonlarını ve istemci kaydını da siler.

Hazır prompt

Sunucuyu eklediysen (ilk örnekteki belge sunucusuyla):

claude-code-docs sunucusunu kullanarak [bir özellik adı] hakkında ne yazdığını bul ve bana kısaca anlat. Cevabında hangi sayfadan aldığını yaz.

Bağlı sunucuların bağlamına maliyetini gözden geçirmek için:

/mcp

Sonra listedeki her sunucu için kendine şunu sor: bu hafta bunu gerçekten kullandım mı? Kullanmadığını kapat.

Sık yapılan hata

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-10-21

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik