Source: https://claudetutorial.com/guides/tr-tr/claude-codea-mcp-sunucusu-ekleme-komutlar-kapsamlar-ve-cozumler [Rehberler sayfasına dön](https://claudetutorial.com/guides/tr-tr) Builders # Claude Code'a MCP Sunucusu Ekleme: Komutlar, Kapsamlar ve Çözümler 27 Ekim 2026 9 dk okuma --- Claude Code'u bir araca bağlamanın olağan yolu şudur: üç ayrı kurulum sayfası okursun, sisteminle tam uyuşmayan bir komut kopyalarsın ve hiçbir şeyin görünmediğine şaşırırsın. Gerçek süreç bir komut ve bir kontroldür; yeter ki eklediğin sunucunun hangi türden olduğunu bil. > Claude Code'a eklediğin her MCP sunucusu tek bir komuta iner: claude mcp add, ardından nasıl bağlandığı. Bu rehber üç sunucu türü için komutları verir, sunucuyu kimin alacağını belirleyen kapsamları açıklar ve girişi, güvenliği, ters giden şeylerin çözümlerini anlatır. MCP sana yeniyse [MCP Nedir?](https://claudetutorial.com/guides/tr-tr/mcp-nedir-model-context-protocolun-sade-anlatimi) rehberiyle başla. ## Neye ihtiyacın var - Kurulu ve çalışan bir Claude Code. Değilse [Yeni Başlayanlar İçin Claude Code](https://claudetutorial.com/guides/tr-tr/yeni-baslayanlar-icin-claude-code-kur-giris-yap-ve-ilk-gorevini-calistir) rehberine bak - Servisin kendi dokümantasyonundan, sunucunun adresi (uzak sunucu için) ya da başlatma komutu (yerel sunucu için) - Bağladığın servisin bir hesabı Başka bir araçtan sohbete veri kopyaladığını fark ettiğinde bir sunucu bağla. Bağlandıktan sonra Claude o sistemden doğrudan okuyabilir ve orada işlem yapabilir. ## Üç tür sunucu Hangi komutu kullanacağın, sunucunun sana nasıl bağlandığına bağlıdır. | Tür | Nasıl bağlanır | Ne için kullanılır | | --- | --- | --- | | **Remote HTTP** | İnternetteki bir web adresi | Çoğu bulut servisi. Önerilen seçim | | **Remote SSE** | Daha eski bir yöntemi kullanan web adresi | Yalnızca bunu sunan servisler. Kullanımdan kalkıyor, mümkünse HTTP'yi tercih et | | **Local stdio** | Makinende çalışan bir program | Yerel dosyalar, veritabanları ve araçlar | ### Uzak HTTP sunucusu Temel biçim her servis için aynıdır: ``` claude mcp add --transport http ``` Gerçek bir örnek Notion'ı bağlar: ``` claude mcp add --transport http notion https://mcp.notion.com/mcp ``` Sunucu bir token istiyorsa onu başlık olarak ver: ``` claude mcp add --transport http secure-api https://api.example.com/mcp \ --header "Authorization: Bearer your-token" ``` ### Uzak SSE sunucusu (kullanımdan kalkıyor) SSE yöntemi kullanımdan kalkıyor; servis sunuyorsa HTTP kullan. Bir servis yalnızca SSE sunuyorsa komut farklı bir transport kullanır: ``` claude mcp add --transport sse asana https://mcp.asana.com/sse ``` ### Yerel stdio sunucusu Bir stdio sunucusu, Claude Code tarafından başlatılan ve kendi makinende çalışan bir programdır. Temel biçimde çift tire bulunur ve ondan sonrasının tamamı sunucuyu başlatan komuttur: ``` claude mcp add [options] -- [args...] ``` Bir API anahtarıyla Airtable sunucusu ekleyen örnek: ``` claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \ -- npx -y airtable-mcp-server ``` Çift tireyi unutma `--` işaretinden sonraki her şey sunucuya olduğu gibi aktarılır. O olmazsa Claude Code, sunucunun kendi bayraklarını kendi seçenekleri sanıp okumaya çalışır ve komut kafa karıştırıcı biçimlerde başarısız olur. ## Çalıştığını kontrol et Bir sunucu ekledikten sonra terminalinden ya da Claude Code'un içinden kontrol et. Terminal ``` $ claude mcp list$ claude mcp get notion$ claude mcp remove notion ``` Ayarlanmış tüm sunucuları listele, birinin ayrıntılarını gör ya da birini kaldır. Bir oturumun içinde her sunucunun durumunu görmek için `/mcp` yaz. Üç durumdan biriyle karşılaşırsın: bağlı, kimlik doğrulama gerekiyor ya da bağlanamadı. | Durum | Ne anlama gelir | Ne yapmalı | | --- | --- | --- | | Connected (bağlı) | Sunucu hazır | Claude'dan kullanmasını iste | | Needs authentication | Henüz giriş yapmadın | `/mcp` çalıştır ve tarayıcıdaki girişi izle | | Failed to connect | Claude Code ona ulaşamadı ya da başlatamadı | Aşağıdaki çözümlere bak | ## OAuth ile giriş yap Birçok bulut sunucusu OAuth 2.0 kullanır, yani "hesabınla giriş yap" akışını. En basit yol iki adımdır. 1. Sunucuyu ekle Örneğin: `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` 2. Kimlik doğrula Claude Code'da `/mcp` çalıştır ve tarayıcıdaki giriş adımlarını izle. Kabuktan `claude mcp login ` ve `claude mcp logout ` komutlarını da çalıştırabilirsin. Token'lar güvenle saklanır ve otomatik yenilenir. Erişimi geri çekmek için `/mcp` menüsündeki **Clear authentication** (kimlik doğrulamayı temizle) seçeneğini kullan. ## Kapsamlar: sunucuyu kim alır Bir sunucu eklerken kapsamını seçersin. Kapsam, hangi projelerin onu göreceğini ve ekibinin paylaşıp paylaşmayacağını belirler. | Kapsam | Nerede kullanılabilir | Ekibinle paylaşılır mı | Nerede saklanır | | --- | --- | --- | --- | | **Local** (varsayılan) | Yalnızca mevcut proje | Hayır | `~/.claude.json` | | **Project** | Yalnızca mevcut proje | Evet, sürüm kontrolü üzerinden | Proje kökündeki `.mcp.json` | | **User** | Tüm projelerin | Hayır | `~/.claude.json` | `--scope` bayrağıyla birini seç: ``` # Project scope: shared with your team claude mcp add --transport http shared-server --scope project https://example.com/mcp # User scope: available in all your projects claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic ``` Proje kapsamlı bir sunucu, projenin kökünde bir `.mcp.json` dosyası yazar. Herkes aynı bağlantıyı alsın diye onu commit edersin: ``` { "mcpServers": { "shared-server": { "type": "http", "url": "https://example.com/mcp" } } } ``` Aynı sunucu adı birden fazla kapsamda geçiyorsa Claude Code bir kez bağlanır ve en yüksek öncelikli kaynağın tanımını kullanır: önce local, sonra project, sonra user. İlk kazanan Son kazanan 1. Local Yalnızca bu proje, yalnızca sen, ~/.claude.json içinde saklanır 2. Project Ekibinle .mcp.json üzerinden paylaşılır 3. User Tüm projelerin, yalnızca sen, ~/.claude.json içinde saklanır Tüm ekibin ihtiyaç duyduğu araçlar için project kapsamını, kişisel araçların için user kapsamını, denerken ise local kapsamını kullan. Başkasından gelen bir `.mcp.json` içeren bir projeyi açtığında Claude Code, etkileşimli bir oturumda sunucularını kullanmadan önce onayını ister. Bu onay seçimlerini sıfırlamak için `claude mcp reset-project-choices` çalıştır. ## Bugün ekleyebileceğin popüler sunucular Bu örnekler resmi dokümantasyondan geliyor. Güncel adres için her zaman servisin kendi sayfasını oku. | Servis | Komut | | --- | --- | | Sentry (hatalar) | `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` | | Stripe (ödemeler) | `claude mcp add --transport http stripe https://mcp.stripe.com` | | GitHub (kod incelemeleri) | `claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"` | | Notion | `claude mcp add --transport http notion https://mcp.notion.com/mcp` | | DBHub ile PostgreSQL | `claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"` | Veritabanında kullanıcı adına dikkat et: `readonly`. Claude'a yalnızca okuyabilen bir veritabanı hesabı ver. Bu tek seçim, yapabileceğin en pahalı hatayı ortadan kaldırır. Anthropic'in claude.ai/directory adresindeki dizininde incelenmiş bağlayıcılara da göz atabilirsin. claude.ai'da bir bağlayıcı eklediysen, Claude hesabınla giriş yaptığında o zaten Claude Code'da da kullanılabilir. ## Güvende kal Bir MCP sunucusu Claude'a bir sisteme erişim verir ve bazı sunucular web sayfaları ya da yabancıların yazdığı kayıtlar gibi dışarıdan içerik getirir. Her sunucuya güvendiğini doğrula Dışarıdan içerik getiren sunucular seni prompt injection'a açabilir: bir yapay zekâyı, senin istemediğin bir şeyi yapması için kandırmaya yazılmış metin. Yalnızca güvendiğin kaynaklardan sunucular ekle ve Claude'un onlarla ne yapmayı planladığına bak. - Sunucu, rastgele bir paylaşımdan değil, servisin kendi dokümantasyonundan geliyor - Veritabanları salt okunur bir hesap kullanıyor - Token'lar başlıklara ya da ortam değişkenlerine gidiyor, asla commit edeceğin bir dosyaya değil - Claude'un araçlarla ne yaptığını gördüğün bir izin modunda çalışıyorsun Son madde, Claude'un sormadan ne kadarını yapacağına bağlanır. Karar vermek için [Claude Code İzin Modları ve Plan Modu Açıklaması](https://claudetutorial.com/guides/tr-tr/claude-code-izin-modlari-ve-plan-modu-aciklamasi) rehberine bak. Claude Tutorial içinde Bir araca güvenmek bir karardır, varsayılan değil Hangi sistemlerin hangi eylemler için erişimi hak ettiğini yargılamak koddan çok daha geniş bir beceridir ve uygulama bunu gerçekçi senaryolarla çalıştırır. Çok yakında [BURADAN İNDİR: Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile) ## Sınırlar ve ayar İki sınır, aksi hâlde tuhaf görünen davranışları açıklamaya yardım eder. - **Büyük sonuçlar.** Claude Code, bir aracın çıktısı 10.000 token'ı geçince uyarı gösterir ve çıktıyı varsayılan olarak 25.000 token ile sınırlar. Sınırı yükseltmek için `MAX_MCP_OUTPUT_TOKENS` değişkenini ayarla, örneğin `MAX_MCP_OUTPUT_TOKENS=50000`. - **Yavaş sunucular.** Claude Code'un bir sunucunun başlamasını ne kadar bekleyeceğini değiştirmek için `MCP_TIMEOUT` ayarla. Örneğin `MCP_TIMEOUT=10000 claude` on saniyeye izin verir. Tool search varsayılan olarak açıktır; böylece bağlamın bir anda her aracın açıklamasıyla dolmaz. Neyin yer kapladığını görmek için `/context` çalıştır. ## Çalışmadığında | Gördüğün | Olası sebep | Çözüm | | --- | --- | --- | | Sunucu `claude mcp list` içinde yok | Başka bir kapsamda ya da projede eklendi | `claude mcp list` komutunu onu eklediğin projeden çalıştır ya da `--scope user` ile ekle | | `/mcp` kimlik doğrulama gerektiğini gösteriyor | Giriş yapmadın | `/mcp` çalıştır ve tarayıcı adımlarını izle ya da `claude mcp login ` kullan | | `/mcp` bağlanılamadığını gösteriyor | Yanlış adres, sunucu kapalı ya da başarısız olan bir başlatma komutu | Adresi servisin dokümantasyonunda kontrol et. Yerel sunucuda hatayı görmek için komutunu terminalinde çalıştır | | Yerel bir sunucunun kendi bayrakları reddediliyor | Çift tire eksik | Sunucu komutundan önce `--` ekle | | Bir projede çalışıyor, ötekinde çalışmıyor | Local kapsam tek bir projede geçerli | `--scope user` ile yeniden ekle, ekip için project kapsamını kullan | | Claude bir proje sunucusunu yok sayıyor | `.mcp.json` onayı reddedildi | `claude mcp reset-project-choices` çalıştır ve yeniden onayla | | Çıktı kesiliyor | Varsayılan 25.000 token sınırı | `MAX_MCP_OUTPUT_TOKENS` değerini yükselt | Hiçbiri uymuyorsa Claude Code'dan yardım iste: hatayı yapıştır ve ne anlama geldiğini sor. `/doctor` çalıştırmak da kurulumunu kontrol eder. ## Sık sorulan sorular ### Claude Code'a MCP sunucusu nasıl eklenir? Uzak sunucu için `claude mcp add --transport http `, yerel sunucu için `claude mcp add -- ` çalıştır. Sonra durumunu kontrol etmek ve giriş yapmak için Claude Code'un içinde `/mcp` çalıştır. ### Claude Code MCP sunucularını nerede saklar? Local ve user kapsamlı sunucular `~/.claude.json` içinde saklanır. Project kapsamlı sunucular projenin kökündeki bir `.mcp.json` dosyasında saklanır ve onu commit edebilirsin. ### Local, project ve user kapsamı arasındaki fark nedir? Local, mevcut projede ve yalnızca senin için geçerlidir. Project, mevcut projede geçerlidir ve ekibinle paylaşılır. User, tüm projelerinde ve yalnızca senin için geçerlidir. ### Bir MCP sunucusunu nasıl kaldırırım? `claude mcp remove ` çalıştır. Bir sunucuyu kaldırmadan çıkış yapmak için `claude mcp logout ` kullan. ### claude mcp add içindeki çift tire ne demek? Claude Code'un kendi seçeneklerini, sunucuyu başlatan komuttan ayırır. Ondan sonraki her şey sunucuya olduğu gibi aktarılır. ### MCP sunucuları güvenli mi? Yalnızca seçtiğin sunucular ve verdiğin erişim kadar. Güvenilir sunucular, salt okunur veritabanı hesapları ve Claude'un ne yaptığını gördüğün bir izin modu kullan. ### claude.ai bağlayıcılarımı Claude Code'da kullanabilir miyim? Evet. claude.ai'da eklediğin bağlayıcılar, Claude hesabınla giriş yaptığında Claude Code'da, hem terminalde hem bulut oturumlarında kullanılabilir. ## Claude Code MCP kontrol listen - `claude mcp list` sunucuyu gösteriyor ve `/mcp` onu bağlı olarak gösteriyor - Kapsamı bilerek seçtin: denemek için local, ekip için project, kendin için user - Kimlik bilgileri başlıklarda ya da ortam değişkenlerinde duruyor, commit edilen dosyalarda değil - Geri getiremeyeceğin veriye dokunan her şey salt okunur erişim kullanıyor ## Okumaya devam et - [MCP Nedir? Model Context Protocol'ün Sade Anlatımı](https://claudetutorial.com/guides/tr-tr/mcp-nedir-model-context-protocolun-sade-anlatimi), arkasındaki fikir için. - [Claude'a Bağlayıcı Ekleme: Dizin, Özel URL ve Güvenlik](https://claudetutorial.com/guides/tr-tr/claudea-baglayici-ekleme-dizin-ozel-url-ve-guvenlik), aynı işin Claude uygulamalarındaki hâli için. - [Claude Code En İyi Uygulamalar: Daha İyi Sonuç Getiren Alışkanlıklar](https://claudetutorial.com/guides/tr-tr/claude-code-en-iyi-uygulamalar-daha-iyi-sonuc-getiren-aliskanliklar), araçlar bağlandıktan sonra iyi çalışmak için. - [CLAUDE.md Açıklaması: Claude Code'a Projeni Bir Kez Öğret](https://claudetutorial.com/guides/tr-tr/claude-md-aciklamasi-claude-codea-projeni-bir-kez-ogret), Claude'a projende bağlı araçları nasıl kullanacağını söylemek için.