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
- MCP'nin ne olduğunu ve Claude Code'a ne kazandırdığını
- Bir MCP sunucusunu komutla eklemeyi, durumunu görmeyi ve kaldırmayı
- Hangi sunucuya güvenmen gerektiğini ve bağlamına maliyetini
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:
- İstemci ve sunucu: İstemci (client), araçlara ihtiyacı olan uygulamadır; Claude Code bu durumda istemcidir. Sunucu (server), dış bir hizmetin önünde duran arayüzdür ve o hizmetin araçlarını, istemlerini ve kaynaklarını standart biçimde sunar. Bir GitHub sunucusu örneğin GitHub'ın karmaşık işlevini senin yerine hazır araçlara çevirir.
- Üç öğe: Sunucu üç şey sunabilir. Araçlar (tools) modelin kendisinin çağırdığı işlevlerdir. Kaynaklar (resources) uygulamanın alıp bağlama kattığı veridir. İstemler (prompts) kullanıcının tetiklediği hazır iş akışlarıdır. Kurs bunu "araçlar modele, kaynaklar uygulamaya, istemler kullanıcıya hizmet eder" diye özetliyor.
- Taşıma: İstemci ve sunucu farklı yollarla konuşabilir (aynı makinede standart giriş/çıkış, HTTP gibi); kurs buna "taşımadan bağımsız" diyor.
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
- Ö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.
- 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.jsonya daclaude mcp add-jsonile ayarlanır. - Terminalde ekle. Komutu
claudeoturumunun 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 veclaude mcp removegibi komutlarda onunla anar. Beklenen sonuç:Added ...ile başlayan bir onay satırı. - Durumunu kontrol et.
claude mcp listher sunucunun yanında sağlık durumunu gösterir (örneğin bağlı, kimlik doğrulaması gerekiyor, bağlanamadı). Oturum içinde/mcpyazarak da bakabilirsin. - Gerekirse giriş yap. Bazı bulut sunucuları kimlik doğrulaması ister; Claude Code OAuth 2.0'ı destekler. Oturumda
/mcpyaz 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/mcpmenüsündeki "Clear authentication" seçeneği var. - 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.
- Kullanmadığını kapat. Her bağlı sunucu araç adlarını ve talimatlarını bağlam penceresine ekler, kullanmasan bile.
/mcpile hangisi bağlı bak, işine yaramayanı kapat. Doküman, sunucuyu silmeden kapatmanın da yolu olduğunu söylüyor:/mcppanelinde 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).
| Kapsam | Nerede yüklenir | Ekiple paylaşılır mı | Nerede saklanır |
|---|---|---|---|
| Yerel (local) | Yalnızca bu proje | Hayır | ~/.claude.json |
| Proje (project) | Yalnızca bu proje | Evet, sürüm kontrolüyle | Proje kökündeki .mcp.json |
| Kullanıcı (user) | Tüm projelerin | Hayı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
- Yalnızca güvendiğin sunucuyu bağla. Doküman bunu açık bir uyarı olarak koyuyor. Dış içerik getiren sunucu, o içerikteki gizli talimatlarla Claude'u yanıltmaya çalışan bir saldırıya (prompt injection) kapı açabilir.
- stdio sunucusu makinendeki bir süreçtir. Dokümana göre stdio sunucuları makinende yerel süreç olarak çalışır;
npxgibi bir komutla indirdiğin paketin ne olduğunu bilmeden ekleme. - Anahtarı ve jetonu komuta gömme ve paylaşma. Komut örneklerinde gördüğün
YOUR_KEYbir yer tutucudur; gerçek anahtarı sohbete, ekran görüntüsüne, commit edilen dosyaya yazma. Bearer jetonu gerektiren bir sunucu için doküman--header "Authorization: Bearer ..."yolunu gösteriyor.
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
- Tanımadığın sunucuyu bağlamak. Yalnızca güvendiğin sunucuyu ekle; dış içerik getiren sunucu prompt injection riski taşır.
- Komutu oturumun içinde yazmak.
claude mcp addterminalde çalışır. Oturum içindeki komut/mcp'dir. - Yerel sunucuyu başka projede aramak. Yerel kapsamdaki sunucu yalnızca eklediğin projede etkindir. Her projede lazımsa
--scope userile ekle. - Yanlış dosyayı düzenlemek. Dokümana göre doğru dosyalar
~/.claude.jsonve proje kökündeki.mcp.json'dir; Claude Code~/.claude/mcp.jsongibi yolları okumaz. --env'den hemen sonra sunucu adını yazmak. Doküman, bu durumda adın başka bir anahtar=değer çifti sanılıp reddedildiğini söylüyor. Araya--transport stdiogibi başka bir seçenek koy.- Kimlik doğrulaması gereken sunucuda
401ya da403görüp pes etmek. Doküman bunu sunucunun çalıştığı, senin giriş yapman gerektiği diye yorumluyor./mcpile OAuth akışını tamamla. - Çok sayıda sunucu bırakmak. Her biri bağlama yer açar; kullanmadığını kapat.
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code 101: MCP
- Anthropic Academy, Introduction to Model Context Protocol (yalnızca kavramlar): Introducing MCP, MCP clients, MCP review
- Claude Code dokümanı: Connect Claude Code to tools via MCP (komutlar, taşıma türleri, kapsamlar, yönetim, kimlik doğrulama, kaynaklar, istemler, güvenlik uyarısı)
- Claude Code dokümanı: Connect to MCP servers (ilk sunucu, kapsamı değiştirme, sorun giderme)
Son doğrulama: 2026-10-21