Claude Code'a MCP Sunucusu Ekleme: Komutlar, Kapsamlar ve Çözümler

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.

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? rehberiyle başla.

Neye ihtiyacın var

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.

Uzak HTTP sunucusu

Temel biçim her servis için aynıdır:

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

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] <name> -- <command> [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

Çalıştığını kontrol et

Bir sunucu ekledikten sonra terminalinden ya da Claude Code'un içinden kontrol et.

$ claude mcp list$ claude mcp get notion$ claude mcp remove notion

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ı.

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.

Kabuktan claude mcp login <name> ve claude mcp logout <name> 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.

--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.

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.

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.

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ı 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

Şuradan indir:App Store

BURADAN İNDİR:Google Play

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

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 <name> <url>, yerel sunucu için claude mcp add <name> -- <command> ç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 <name> çalıştır. Bir sunucuyu kaldırmadan çıkış yapmak için claude mcp logout <name> 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

Okumaya devam et

• MCP Nedir? Model Context Protocol'ün Sade Anlatımı, arkasındaki fikir için.
• Claude'a Bağlayıcı Ekleme: Dizin, Özel URL ve Güvenlik, aynı işin Claude uygulamalarındaki hâli için.
• Claude Code En İyi Uygulamalar: Daha İyi Sonuç Getiren Alışkanlıklar, araçlar bağlandıktan sonra iyi çalışmak için.
• CLAUDE.md Açıklaması: Claude Code'a Projeni Bir Kez Öğret, Claude'a projende bağlı araçları nasıl kullanacağını söylemek için.