Claude Code MCP Kurulumu: 2026'da Arac Baglama Rehberi

Claude Code MCP kurulumu, 2026 yilinda bir gelistiricinin ogrenebilecegi en degerli becerilerden biri haline geldi. Ben Kamer, 15 yillik muzisyen ve yazilimci olarak thekai.co'da 72'den fazla AI ajanini yonettim ve Claude Code ile 50'den fazla projeyi hayata gecirdim. Bu yazida, MCP (Model Context Protocol) sunucularini Claude Code'a nasil baglayacaginizi, hangi araclari kullanacaginizi ve karsilastigim gercek sorunlari nasil cozdugumu anlatiyorum. Eger Claude Code'u sadece sohbet ederek kullaniyorsaniz, potansiyelinin ancak yuzde 20'sini goruyorsunuz demektir. MCP kurulumu ile bu aracin gercek gucunu kesfedeceksiniz.

MCP Nedir ve Neden Claude Code Icin Kritik?

MCP, Model Context Protocol'un kisaltmasi. Temelde, yapay zeka modelinin harici araclarla iletisim kurmasini saglayan bir standart. Dusunun ki Claude Code sadece bir sohbet kutusu degil; GitHub reposuna erisebilen, veritabanina sorgu gonderebilen, dosya sisteminde gezinip kod yazabilen bir asistan. MCP iste bu baglantilari mumkun kiliyor. Tech With Tim'in videosunda da vurguladigi gibi, cogu kullanici Claude Code'u acip hemen prompt yazmaya basliyor ve MCP'nin sagladigi derin entegrasyonu kaciriyor. Benim tecrubeme gore, MCP kurulumu olmadan Claude Code'u kullanmak, sadece 2 silindirle calisan bir spor arabaya binmek gibi.

MCP sunuculari, Claude Code'un dis dunyaya acilan kapilari. Bir MCP sunucusu bir API'yi cagirabilir, bir veritabanina baglanabilir veya bir dosyayi okuyup yazabilir. Bu sayede Claude Code, sadece kod onermekle kalmaz; gercek dunyadaki projelerinizle etkilesime gecer. Claude Code kullanim rehberi yazimda da belirttigim gibi, dogru MCP yapilandirmasi ile bir gelistiricinin gunluk is akisi tamamen degisebilir. thekai.co'da kullandigimiz ajan orkestrasyonu sistemlerinde de MCP'nin rolu buyuk.

Claude Code MCP Kurulumu: Adim Adim Baslangic

Claude Code MCP kurulumu aslinda sandiginizdan cok daha basit. Ilk adim, Claude Code'un terminal uzerinde calisacak sekilde kurulu oldugundan emin olmak. Eger henuz kurmadiysaniz, resmi dokumantasyondaki talimatlari izleyin: 'npm install -g @anthropic-ai/claude-code'. Kurulum tamamlandiktan sonra, projenizin ana dizininde bir '.claude' klasoru olusturmaniz gerekiyor. Bu klasorun icinde 'mcp.json' adli bir dosya, MCP sunucularinizin yapilandirmasini icerecek. Leon van Zyl'in egitim videosunda da belirttigi gibi, ilk kurulumda VS Code entegrasyonu ve API anahtari ayarlarini da yapmaniz onerilir.

MCP sunucusu eklemek icin 'mcp.json' dosyasina su formatta bir blok ekliyorsunuz: her bir arac icin bir 'name', 'command' (ornegin 'npx' veya 'node') ve 'args' dizisi. Ornegin GitHub MCP sunucusu icin 'command': 'npx', 'args': ['-y', '@modelcontextprotocol/server-github'] seklinde bir yapi kullaniyorum. Ardindan Claude Code'u yeniden baslattiginizda, yeni arac otomatik olarak taninacak. Ben bu islemi ilk yaptigimda, Claude Code'un GitHub API'sine erisip bir issue acmasini izlemek gercekten buyuleyiciydi. Bu adimdan sonra, Claude Code'a '/mcp' yazarak mevcut sunuculari listeleyebilirsiniz.

GitHub MCP Sunucusu Kurulumu ve Kullanimi

GitHub MCP sunucusu, Claude Code'un GitHub reposuna dogrudan erismesini saglar. Issue acmak, pull request olusturmak, kod incelemesi yapmak gibi islemleri terminalden komut vererek yaptirabilirsiniz. Kurulum icin 'mcp.json' dosyasina su girdiyi ekleyin: isim olarak 'github', komut olarak 'npx', arguman olarak '['-y', '@modelcontextprotocol/server-github']' ve 'env' alanina 'GITHUB_TOKEN' degiskenini ekleyin. Token'i GitHub hesabinizdan 'Settings > Developer settings > Personal access tokens' bolumunden olusturmaniz gerekiyor. Tech With Tim'in videosunda da bu adimlari detaylica gorebilirsiniz.

Ben bu kurulumu thekai.co'nun bir projesinde kullandigimda, surekli manuel olarak actigim issue'lari Claude Code'a devrettim. Ornegin bir hata raporu geldiginde, 'su hatayi GitHub'da issue olarak ac' komutunu veriyorum, Claude Code otomatik olarak baslik, aciklama ve etiketlerle bir issue olusturuyor. Bu, haftada en az 2-3 saatimi kurtardi. Ayrica kod tabaninda bir degisiklik yapip 'bu branch'i push et ve PR ac' dediginizde, tum sureci sizin adiniza yonetecek sekilde yapilandirabiliyorsunuz. En iyi AI kodlama araclari karsilastirmasi yazimda da bu tur entegrasyonlarin verimliligi nasil artirdigini anlattim.

Harici Veritabani ve API Baglantilari Icin MCP Kullanimi

MCP sunuculari sadece GitHub ile sinirli degil. Kendi veritabaniniza, bulut depolama hizmetlerinize veya herhangi bir REST API'ye baglanmak icin ozel MCP sunuculari yazabilir veya hazir olanlari kullanabilirsiniz. Ornegin PostgreSQL icin bir MCP sunucusu kurarak, Claude Code'a 'kullanicilar tablosundaki son 10 kaydi getir' gibi dogal dil komutlari verebilirsiniz. Bu, ozellikle veri analizi ve raporlama islemlerinde inanilmaz bir hiz kazandiriyor. Futurepedia'nin egitim videosunda da, MCP ile harici araclara baglanmanin temel mantigi anlatiliyor.

Kendi API'niz icin MCP sunucusu yazmak isterseniz, resmi dokumantasyonda 'Model Context Protocol' spesifikasyonu detaylica aciklaniyor. Temel olarak bir Node.js sunucusu yazip, 'tools' adinda bir dizi tanimliyorsunuz. Her bir aracin bir 'name', 'description' ve 'inputSchema' alani olmali. Bu yapi sayesinde Claude Code, hangi aracin ne ise yaradigini anlayip dogru zamanda cagirabiliyor. thekai.co'da 72'den fazla AI ajanini yonetirken, bu tur ozel MCP sunuculari sayesinde her ajani birbirine baglayip kompleks is akislari olusturabiliyorum. Bu, ajan orkestrasyonunun temel taslarindan biri.

Plugin ve Skill'lerle MCP'yi Genisletmek

Claude Code'un MCP altyapisi, plugin ve skill'lerle daha da gucleniyor. 'Skills', Claude Code'un belirli bir gorevi nasil yapacagini ogreten ozel talimatlar. Ornegin bir 'React Bileseni Olusturma' skill'i yazip, MCP sunucusu uzerinden bir tasarim sistemine erisebilirsiniz. Tech With Tim, videosunda bu konuda cok degerli ipuclari veriyor. Kendi skill'lerinizi olusturmak icin 'CLAUDE.md' dosyasina markdown formatinda talimatlar ekliyorsunuz. Bu dosyayi projenizin kok dizinine koydugunuzda, Claude Code her seferinde bu talimatlari referans aliyor.

• CLAUDE.md dosyasina proje kurallarini ve tercihleri yazmak, MCP sunuculariyla birlikte kullanildiginda cok guclu bir kombinasyon olusturuyor.
• Plugin'ler (ornegin Context7) MCP sunuculari uzerinden calisarak, Claude Code'un dokumantasyon ve kutuphane bilgilerine erismesini sagliyor.
• Subagent'lar olusturarak, bir ana Claude Code oturumunun altinda birden fazla MCP baglantili alt ajan calistirabiliyorsunuz.
• Her bir subagent farkli bir MCP sunucusuna baglanarak, paralel islemleri yonetecek sekilde yapilandirilabiliyor.

Benim en cok kullandigim plugin'lerden biri Context7. Bu plugin, MCP uzerinden calisarak Claude Code'un en guncel npm paket dokumantasyonuna erismesini sagliyor. Bir kutuphane kurarken 'context7' komutunu kullanarak, o kutuphanenin en guncel API'sini ogrenebiliyorum. Bu, ozellikle hizli prototipleme yaparken cok degerli. Ayrica kendi ozel skill'lerinizi yazarak, MCP sunucularinizin nasil kullanilacagini da belirleyebilirsiniz. Ornegin ben, 'veritabani-sorgula' adli bir skill yazdim ve bu skill, PostgreSQL MCP sunucusunu kullanarak belirli bir formatta sorgu sonuclari donduruyor.

Karsilastigim 3 Yaygin Hata ve Cozumleri

Claude Code MCP kurulumu yaparken karsilastigim en yaygin hata, 'MCP sunucusu bulunamadi' uyarisi. Bunun sebebi genelde 'mcp.json' dosyasinin yanlis yerde olmasi. Dosyanin '.claude' klasoru icinde ve dogru JSON formatinda oldugundan emin olun. Ikinci hata, API anahtari veya token eksikligi. GitHub MCP sunucusu icin 'GITHUB_TOKEN' ortam degiskenini tanimlamazsaniz, sunucu calismaz. Ucuncu hata ise, MCP sunucusunun kullandigi portun baskasi tarafindan isgal edilmesi. Bu durumda farkli bir port belirleyerek veya mevcut sureci sonlandirarak cozebilirsiniz.

Bu hatalari cozmek icin once Claude Code'u kapatip tekrar acmayi deneyin. Eger sorun devam ediyorsa, terminalde 'claude mcp list' komutunu calistirarak hangi sunucularin aktif oldugunu gorebilirsiniz. Ayrica 'claude mcp logs' komutu ile hata mesajlarini inceleyebilirsiniz. Ben bir projemde, bir MCP sunucusunun surekli zaman asimina ugramasi sorunuyla karsilastim. Cozum olarak, sunucunun calistigi makinenin saat dilimini UTC'ye aldim ve sorun cozuldu. Bu tur detaylar, kurulumun ne kadar hassas olabilecegini gosteriyor. Tailwind CSS v4 rehberi yazimda da benzer surpriz hatalarla nasil bas ettigimi anlatmistim.

MCP ile Guvenlik ve Erisim Kontrolu

MCP sunuculari dis dunyaya acilan kapilar oldugu icin guvenlik onlemleri kritik. Her MCP sunucusu icin en az yetki prensibini uygulayin. Ornegin GitHub MCP sunucusu icin sadece gerekli repo'lara erisimi olan bir token kullanin. Ayrica 'mcp.json' dosyasinda 'env' alanina yazdiginiz API anahtarlarini asla versiyon kontrol sistemine eklemeyin. Ben '.env' dosyasi kullanip, 'mcp.json' icinde '${GITHUB_TOKEN}' seklinde degisken referansi veriyorum. Bu sayede anahtarlar guvende kaliyor.

Bir diger guvenlik onlemi de, MCP sunucularinin hangi komutlari calistirabilecegini sinirlamak. Kendi ozel MCP sunucunuzu yaziyorsaniz, 'tools' dizisinde sadece ihtiyac duyulan islemleri tanimlayin. Ornegin bir veritabani MCP sunucusu yaziyorsaniz, 'SELECT' sorgularina izin verip 'DROP TABLE' gibi yikici islemleri engelleyebilirsiniz. Futurepedia'nin videosunda da guvenlik incelemesi bolumunde, MCP sunucularinin nasil denetlenmesi gerektigi anlatiliyor. thekai.co'da bu prensipleri uygulayarak, 72'den fazla ajanin guvenli bir sekilde calismasini sagliyoruz.

Claude Code MCP kurulumu, 2026'da bir gelistiricinin araç kutusunda bulunmasi gereken en önemli becerilerden biri. Bu rehberde adim adim anlattigim gibi, GitHub'dan veritabanina, plugin'lerden ozel skill'lere kadar her seyi MCP ile baglayabilirsiniz. Ben thekai.co'da ve muzik kariyerimde bu teknolojiyi kullanarak is akislarimi kokten degistirdim. Siz de bugun baslayin, once bir GitHub MCP sunucusu kurun ve Claude Code'un gercek potansiyelini kesfedin. Unutmayin, dogru yapilandirma ile bu arac sadece bir kod asistani degil, tam bir gelistirme ortagi haline geliyor. Herhangi bir sorunuz olursa, iletisim sayfasindan bana ulasabilirsiniz.