Claude Code MCP Kurulumu: Terminalinizi AI Asistanına Dönüştürün

Terminalde hata ayıklamaktan yorulduysanız, yalnız değilsiniz. Ben Kamer, 15 yıllık müzisyen ve yazılımcı olarak Claude Code ile 50'den fazla projeyi hayata geçirdim. Bu yazıda, Claude Code MCP kurulumu hakkında öğrendiğim her şeyi—kurulumdan ileri düzey yapılandırmaya kadar—adım adım anlatacağım. Model Context Protocol (MCP) sayesinde Claude Code, sadece kod yazmakla kalmaz, dosya sisteminize, veritabanlarınıza ve harici API'lere doğrudan erişir. thekai.co'da 72'den fazla AI ajanını yönettiğimiz altyapıda MCP, bu ajanların birbiriyle iletişim kurmasını sağlayan temel yapı taşı oldu. Ek okuma: echo bazaar buyume stratejisi ai muzik deneyimi vaka analizi slot3.

MCP Nedir ve Neden Claude Code İçin Vazgeçilmez?

Model Context Protocol, kısaca MCP, Claude Code'un dış dünya ile iletişim kurmasını sağlayan bir protokoldür. Bunu, Claude Code'un 'gözleri ve elleri' olarak düşünebilirsiniz. Normalde bir AI modeli yalnızca metin üretebilir; MCP sayesinde dosya oluşturma, veritabanı sorgulama, web scraping ve GitHub üzerinden pull request açma gibi eylemleri gerçekleştirebilir. Ben ilk MCP sunucusunu bir müzik projesinde kullandığımda, Claude Code'un Spotify API'sine bağlanıp çalma listelerini otomatik olarak güncellemesini sağlamıştım. Bu deneyim, MCP'nin gücünü anlamam için bir dönüm noktası oldu. Ek okuma: claude code kullanim rehberi 2026.

Claude Code'un temel çalışma prensibi, terminal üzerinden proje klasörünüze erişmek ve komutları doğrudan çalıştırmaktır. MCP ise bu yeteneği genişletir. Örneğin, bir MCP sunucusu sayesinde Claude Code, Supabase veritabanınıza bağlanıp kullanıcıları listeleyebilir veya bir dosyayı S3'e yükleyebilir. Bu yetenek, özellikle büyük ölçekli projelerde ve AI ajan orkestrasyonu gibi karmaşık sistemlerde kritik rol oynar. thekai.co'daki ajanlarımızın her biri, farklı MCP sunucuları üzerinden görevlerini yerine getirir. Ek okuma: ai kodlama araclari karsilastirmasi 2026 gercek deneyim.

Claude Code MCP Kurulumu İçin Gereksinimler

Kuruluma başlamadan önce doğru ortamı hazırlamak çok önemlidir. Ben ilk denememde eksik bir Node.js sürümünden dolayı iki saat kaybetmiştim. İşinizi kolaylaştırmak için gereksinimleri sıralıyorum: Birincisi, Node.js v18 veya üzeri bir sürüm. MCP sunucuları genellikle JavaScript veya TypeScript ile yazıldığı için Node.js runtime'ı zorunludur. İkincisi, Claude Code'un yüklü ve çalışır durumda olması gerekiyor. Bunun için Anthropic'in resmi CLI aracını kullanabilirsiniz. Üçüncüsü, bir API anahtarı — Anthropic hesabınızdan alabilirsiniz. Son olarak, bir metin editörü veya IDE yeterli, ancak ben Visual Studio Code'u öneriyorum.

Kuruluma başlamadan önce terminalinizin doğru çalıştığından emin olun. Ben .zshrc dosyama export ANTHROPIC_API_KEY="your-key" satırını ekleyerek API anahtarımı kalıcı hale getirdim. Bu, her yeni terminal oturumunda anahtarı tekrar girmenizi engeller. Ayrıca, proje klasörünüzde bir .claude klasörü oluşturmanızı tavsiye ederim. Bu klasör, MCP yapılandırmaları ve ajan tanımları için kullanılır.

Adım Adım Claude Code MCP Kurulumu

Şimdi kuruluma geçiyorum. İlk adım, Claude Code'u terminalinizde başlatmaktır. Bunun için terminale claude yazıp Enter'a basın. Eğer ilk kez çalıştırıyorsanız, sizden API anahtarı isteyecektir. Anahtarı girdikten sonra Claude Code terminalde hazır hale gelir. İkinci adım, bir MCP sunucusu kurmaktır. En popüler başlangıç sunucusu, dosya sistemi erişimi sağlayan 'filesystem' sunucusudur. Bunu npm üzerinden kurabilirsiniz: npm install -g @modelcontextprotocol/server-filesystem. Kurulum tamamlandıktan sonra sunucuyu Claude Code'a tanıtmanız gerekir.

Sunucuyu tanıtmak için Claude Code içinde /mcp komutunu kullanın. Bu komut, mevcut MCP sunucularını listeler ve yeni sunucu eklemenizi sağlar. Ben genellikle .claude klasörümün içine bir mcp-config.json dosyası oluşturarak tüm sunucuları buradan yönetiyorum. Bu yapı, proje bazında farklı MCP sunucuları kullanmanıza olanak tanır.

Popüler MCP Sunucuları ve Kullanım Alanları

MCP ekosistemi hızla büyüyor. Benim en çok kullandığım üç sunucu var: Playwright MCP, veritabanı MCP ve GitHub MCP. Playwright MCP, web sayfalarında gezinebilir, form doldurabilir ve ekran görüntüsü alabilir. Veritabanı MCP, PostgreSQL veya MySQL gibi veritabanlarına doğrudan SQL sorguları gönderir. GitHub MCP ise repo yönetimi, issue açma ve PR oluşturma gibi işlemleri otomatikleştirir. Bu üç sunucu, günlük iş akışımın büyük bir bölümünü kapsıyor.

Bir de özel MCP sunucuları yazma imkanınız var. Örneğin, ben Echo Bazaar projem için Spotify API'sine bağlanan özel bir MCP sunucusu yazdım. Bu sunucu, yeni şarkılar yayınlandığında otomatik olarak çalma listelerine ekleme yapıyor. Kendi MCP sunucunuzu yazmak için TypeScript veya Python kullanabilirsiniz. Resmi MCP SDK, bu süreci oldukça basit hale getiriyor. İhtiyacınız olan tek şey, bir API'ye erişim ve temel programlama bilgisi.

• Playwright MCP: Web otomasyonu ve test için idealdir. Tarayıcı kontrollerini Claude Code'a devreder.
• Veritabanı MCP: SQL sorguları çalıştırır, tablo yapılarını okur. Büyük veri projelerinde zaman kazandırır.
• GitHub MCP: Repo yönetimi, issue takibi ve CI/CD entegrasyonu sağlar. Ekip çalışmalarında vazgeçilmez.
• Dosya Sistemi MCP: Yerel dosyalara okuma/yazma yetkisi verir. Güvenlik ayarlarına dikkat edin.
• Özel MCP Sunucuları: Kendi API entegrasyonlarınızı yazabilirsiniz. Örneğin, bir e-ticaret platformuna bağlanmak için.

MCP Kurulumunda Karşılaştığım Yaygın Hatalar ve Çözümleri

Yeni başlayanların en sık yaptığı hata, MCP sunucusunu yanlış yoldan çalıştırmaktır. Ben de ilk denememde sunucuyu çalıştırmak için doğru dizinde olmadığım için 'command not found' hatası almıştım. Çözüm: MCP sunucusunu global olarak kurduktan sonra, herhangi bir dizinden çalıştırabilirsiniz. Ancak, proje bazında çalışmak istiyorsanız, sunucuyu proje klasörünüzün içine kurun. İkinci yaygın hata, API anahtarı yetkisizliğidir. MCP sunucuları bazen harici API'lere erişirken farklı anahtarlar gerektirir. Her sunucunun dokümantasyonunu dikkatlice okuyun.

Üçüncü hata, izin sorunlarıdır. Dosya sistemi MCP sunucusu, belirli bir dizine erişim izni verir. Eğer bu dizini yanlış ayarlarsanız, Claude Code dosyaları okuyamaz veya yazamaz. Çözüm: mcp-config.json dosyasında izin verilen dizinleri doğru tanımlayın. Ayrıca, .claude_ignore dosyası oluşturarak hassas dosyaların indekslenmesini engelleyebilirsiniz.

MCP ile AI Ajan Orkestrasyonu: thekai.co Deneyimi

thekai.co'da 72'den fazla AI ajanını yönettiğimiz altyapıda MCP, ajanların birbiriyle iletişim kurmasını sağlayan temel yapı taşı oldu. Her ajan, belirli bir MCP sunucusu üzerinden görevini yerine getirir. Örneğin, içerik üretim ajanımız Playwright MCP ile web'den veri toplar, veritabanı MCP ile bu verileri kaydeder, GitHub MCP ile kod deposuna yükler. Bu entegrasyon, ajanların bağımsız çalışmasını ve aynı anda birden fazla görevi yerine getirmesini sağlar.

Bir projede, müzik dağıtım ajanımız ile sosyal medya ajanımızı MCP üzerinden birbirine bağladık. Müzik ajanımız Spotify'da yeni bir şarkı yayınladığında, otomatik olarak Twitter'da bir duyuru paylaşılıyor. Bu tür bir otomasyon, MCP'nin güçlü yanını gösteriyor. Eğer siz de benzer bir yapı kurmak isterseniz, otomasyon ile zaman tasarrufu yazımdaki örnekleri inceleyebilirsiniz. MCP, sadece kod yazmak için değil, tüm iş akışınızı otomatikleştirmek için bir köprü görevi görüyor.

Güvenlik ve En İyi Uygulamalar

MCP sunucuları güçlü araçlar, ancak doğru yapılandırılmazsa güvenlik riski oluşturabilir. Ben her zaman .claude_ignore dosyası kullanarak hassas dosyaların (örneğin .env, ssh anahtarları) Claude Code tarafından indekslenmesini engelliyorum. Ayrıca, her MCP sunucusuna yalnızca ihtiyacı kadar izin veriyorum. Dosya sistemi sunucusunu tüm disk yerine yalnızca proje klasörüyle sınırlandırmak, olası bir veri sızıntısını önler. Bir diğer önemli nokta, MCP sunucularını yalnızca güvenilir kaynaklardan kurmaktır.

API anahtarlarınızı asla doğrudan kod içine yazmayın. Ben bunun için .env dosyası ve export komutları kullanıyorum. Ayrıca, MCP sunucularının loglarını düzenli olarak kontrol edin. Beklenmedik bir API çağrısı veya dosya erişimi fark ederseniz, hemen ilgili sunucuyu devre dışı bırakın. Güvenlik, AI ajan orkestrasyonu gibi karmaşık sistemlerde en kritik konulardan biridir.

MCP ile Verimliliğinizi Artıracak İpuçları

MCP kurulumunu tamamladıktan sonra iş akışınızı hızlandırmak için bazı ipuçları paylaşmak istiyorum. Birincisi, proje bazında CLAUDE.md dosyası oluşturun. Bu dosya, Claude Code'un projeniz hakkında bilmesi gereken her şeyi içerir: mimari, kullandığınız kütüphaneler, test komutları. Bu dosyayı kullanarak Claude Code'un bağlamı anlamasını kolaylaştırıyorum.

İkincisi, MCP sunucularınıza açıklayıcı isimler verin. Bu, birden fazla sunucu kullanırken kafa karışıklığını önler. Üçüncü ipucu, MCP sunucularınızı düzenli olarak güncellemektir. Ekosistem hızla gelişiyor ve yeni özellikler ekleniyor. Son olarak, topluluktan öğrenin. MCP sunucuları için GitHub'da birçok açık kaynaklı örnek bulunmaktadır.

Claude Code MCP kurulumu, doğru yapıldığında terminalinizi adeta bir AI asistanına dönüştürür. Ben 50'den fazla projede bu sistemi kullandım ve her seferinde iş akışımda gözle görülür bir iyileşme yaşadım. Eğer siz de bu güçlü aracı öğrenmek ve kendi projelerinizde kullanmak istiyorsanız, yukarıdaki adımları takip ederek başlayabilirsiniz.