MCP sunucusu nedir ve ne işe yarar?

Model Context Protocol (MCP) sunucusu, Claude Desktop ve Cursor gibi yapay zeka istemcilerinin yerel dosyalara, veritabanlarına veya harici API sistemlerine güvenli şekilde bağlanmasını sağlayan protokol katmanıdır.

Cursor için MCP konfigürasyonu nereye kaydedilmelidir?

Cursor projelerinde yapılandırma dosyası proje ana kök dizininde .cursor/mcp.json konumuna yerleştirilmelidir.

Claude Desktop için config dosyası nerede bulunur?

macOS için ~/Library/Application Support/Claude/claude_desktop_config.json, Windows için ise %APPDATA%\Claude\claude_desktop_config.json yolunda yer alır.

MCP (Model Context Protocol) Config Builder

Claude Desktop, Cursor IDE ve Windsurf için hazır MCP sunucu şablonlarıyla hatasız JSON konfigürasyonları oluşturun.

Model Context Protocol (MCP) Standardı

Hedef IDE / Ajan Seçin

Konfigürasyon dosyasını oluşturmak istediğiniz istemciyi belirleyin.

Claude Desktop dosya konumu (claude_desktop_config.json):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonLinux: ~/.config/Claude/claude_desktop_config.json

Kullanılabilir MCP Sunucuları

3 sunucu aktif (9 toplam)

postgresnpx

Şema okuma, salt-okunur sorgu çalıştırma ve tablo ilişkilerini keşfetme.

Argümanlar (Args):

filesystemnpx

Yapay zekanın izin verilen proje klasörlerini okuyup yazabilmesini sağlar.

Argümanlar (Args):

githubnpx

Repo içeriklerini, issue ve Pull Request durumlarını doğrudan inceleme ve güncelleme.

Argümanlar (Args):

Ortam Değişkenleri (Env):

GITHUB_PERSONAL_ACCESS_TOKEN:

brave_searchnpx

Yapay zekaya güncel internet sorguları ve haber arama yeteneği kazandırır.

sqliteuvx

Hafif yerel SQLite dosyalarını doğrudan sorgulama ve analiz etme.

puppeteernpx

Web sitelerini ziyaret etme, JavaScript çalıştırma ve ekran görüntüsü alma.

fetchuvx

Web sayfalarını temiz metin / markdown olarak okuma ve ajan içeriğine sunma.

gituvx

Commit geçmişi, git log, diff ve branch durumlarını doğrudan inceleme.

memorynpx

Oturumlar arası kalıcı hafıza ve varlık ilişkilerini saklama.

claude_desktop_config.json

30 satır • 3 aktif sunucu

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://user:password@localhost:5432/mydb"
      ]
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/kullanici/Desktop/proje"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PAT_TOKEN}"
      }
    }
  }
}

Hızlı Kurulum Talimatı:

Yukarıdaki JSON içeriğini kopyalayın veya indirin.
Yukarıda belirtilen claude_desktop_config.json dosya yoluna kaydedin.
Claude Desktop uygulamasını tamamen kapatıp tekrar başlatın.

Model Context Protocol (MCP) Nedir ve Neden Standart Hale Geldi?

Model Context Protocol (MCP), Anthropic tarafından açık kaynaklı bir standart olarak duyurulan ve yapay zeka modelleri ile yerel/uzak veri kaynakları (veritabanları, dosya sistemleri, GitHub, API'lar ve geliştirici araçları) arasında güvenli, iki yönlü bir köprü kuran evrensel protokoldür. Claude Desktop, Cursor IDE ve Windsurf gibi modern yapay zeka ajanları, harici araçlarla doğrudan iletişim kurabilmek için MCP sunucularını kullanır.

Bu interaktif MCP Config & JSON Builder aracı; karmaşık JSON şemalarını, komut argümanlarını ve ortam değişkenlerini manuel yazma zahmetinden kurtararak saniyeler içinde hatasız claude_desktop_config.json ve .cursor/mcp.json dosyaları üretmenizi sağlar.

Öne Çıkan MCP Sunucu Şablonları ve Yetenekleri

Aşağıdaki hazır şablonları tek tıkla konfigürasyonunuza dahil edebilir ve parametrelerini özelleştirebilirsiniz:

🐘 PostgreSQL & SQLite

Yapay zeka asistanınıza yerel veya uzak veritabanı şemalarını okuma, SQL sorguları çalıştırma ve veri analizi yeteneği verir.

📂 Yerel Dosya Sistemi (Filesystem)

Güvenli izin protokolüyle seçilen dizinlerde dosya okuma, oluşturma, düzenleme ve proje dosyalarını indeksleme imkanı sağlar.

🐙 GitHub Entegrasyonu

Repo dallarını, commit geçmişini, issue ve Pull Request içeriklerini doğrudan ajanınızın bağlam penceresine aktarır.

🦁 Brave Search Web Araması

Modele internet erişimi kazandırarak 2026 yılı güncel kütüphane dokümantasyonlarını ve API değişikliklerini canlı aratmasını sağlar.

🎭 Puppeteer Web Otomasyonu

Başsız (headless) tarayıcı kontrolüyle web sayfalarını render etme, dinamik SPA sitelerini kazıma ve ekran görüntüsü yakalama.

🧠 Memory & Knowledge Graph

Ajan oturumları kapansa dahi projeniz hakkındaki kritik bilgileri ve kararları hatırlamasını sağlayan kalıcı bellek sunucusu.

Claude Desktop veya Cursor'a MCP Sunucusu Nasıl Eklenir?

Hedef Ortamı ve Sunucuları Belirleyin:

Üst kısımdan Claude Desktop, Cursor veya Windsurf seçeneğini tıklayın. İhtiyacınız olan sunucuları (Postgres, Filesystem vb.) işaretleyin.

Parametre ve API Anahtarlarını Güncelleyin:

Veritabanı bağlantı URI'si veya erişim izin yolu gibi parametreleri proje yolunuza göre düzenleyin.

JSON'ı Kopyalayın veya İndirin:

Üretilen JSON dosyasını işletim sisteminize uygun konfigürasyon dizinine kaydedin ve IDE'nizi yeniden başlatın.

Sıkça Sorulan Sorular (SSS)

MCP sunucuları bilgisayarımda güvenlik riski oluşturur mu?▼

MCP mimarisi en az yetki (least privilege) prensibiyle çalışır. Filesystem sunucusunda yalnızca açıkça izin verdiğiniz klasörlere erişilebilir. Veritabanlarında ise salt-okunur (read-only) kullanıcı yetkileri tanımlanması tavsiye edilir.

Claude Desktop ile Cursor MCP konfigürasyonları aynı mıdır?▼

Her iki istemci de "mcpServers" JSON şemasını kullanır. Temel fark dosya konumlarıdır: Claude Desktop işletim sistemi uygulama verisi altında global bir dosya kullanırken, Cursor proje kök dizinindeki .cursor/mcp.json dosyasından okur.

Python uvx ile Node.js npx arasındaki fark nedir?▼

Bazı resmi MCP sunucuları TypeScript/Node.js ile yazılmıştır ve npx gerektirir. Python tabanlı sunucular (örneğin sqlite ve fetch) ise Astral UV paket yöneticisinin uvx komutuyla milisaniyeler içinde izole bir ortamda çalıştırılır.