Model Context Protocol (MCP)

MCP ile Cursor’a harici araçları ve veri kaynaklarını bağla

MCP nedir?

Model Context Protocol (MCP), Cursor’ın dış araçlara ve veri kaynaklarına bağlanmasına olanak tanır.

Neden MCP kullanmalı?

MCP, Cursor’ı harici sistemlere ve verilere bağlar. Proje yapını yeniden yeniden anlatmak yerine, doğrudan araçlarınla entegre ol.

stdout’a yazdırabilen veya bir HTTP endpoint’i sunabilen herhangi bir dille MCP sunucuları yaz — Python, JavaScript, Go, vb.

Nasıl çalışır

MCP sunucuları, protokol üzerinden yeteneklerini sunar ve Cursor’ı harici araçlara ya da veri kaynaklarına bağlar.

Cursor üç aktarım yöntemi destekler:

Aktarım	Çalışma ortamı	Dağıtım	Kullanıcılar	Girdi	Kimlik doğrulama
stdio	Yerel	Cursor yönetir	Tek kullanıcı	Kabuk komutu	Manuel
SSE	Yerel/Uzak	Sunucu olarak dağıtılır	Birden çok kullanıcı	Bir SSE uç noktasına URL	OAuth
Streamable HTTP	Yerel/Uzak	Sunucu olarak dağıtılır	Birden çok kullanıcı	Bir HTTP uç noktasına URL	OAuth

Protokol desteği

Cursor, şu MCP protokol yeteneklerini destekler:

Özellik	Destek	Açıklama
Tools	Destekleniyor	AI modelinin çalıştırması için fonksiyonlar
Prompts	Destekleniyor	Kullanıcılar için şablon mesajlar ve iş akışları
Resources	Destekleniyor	Okunup referans verilebilen yapılandırılmış veri kaynakları
Roots	Destekleniyor	Çalışılacak uri veya dosya sistemi sınırlarına yönelik sunucu başlatımlı sorgular
Elicitation	Destekleniyor	Kullanıcılardan ek bilgi talep eden sunucu başlatımlı istekler

MCP sunucularını kurma

Tek tıkla kurulum

Koleksiyonumuzdan MCP sunucularını yükle ve OAuth ile oturum açarak kimlik doğrula.

MCP Araçlarını Keşfet

Kullanılabilir MCP sunucularını keşfet

Cursor’a Ekle Düğmesi

“Cursor’a Ekle” düğmesi oluştur

mcp.json kullanımı

Özel MCP sunucularını bir JSON dosyasıyla yapılandır:

CLI Sunucusu - Node.js

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

STDIO sunucu yapılandırması

STDIO sunucuları (yerel komut satırı sunucuları) için mcp.json içinde şu alanları yapılandır:

Field	Required	Description	Examples
type	Yes	Sunucu bağlantı türü	"stdio"
command	Yes	Sunucu çalıştırılabilirini başlatan komut. Sistem yolunda bulunmalı ya da tam yolunu içermeli.	"npx", "node", "python", "docker"
args	No	Komuta iletilen argümanlar dizisi	["server.py", "--port", "3000"]
env	No	Sunucu için ortam değişkenleri	{"API_KEY": "${input:api-key}"}
envFile	No	Ek değişkenler yüklemek için ortam dosyasının yolu	".env", "${workspaceFolder}/.env"

Extension API’yi kullanma

Programatik MCP sunucu kaydı için Cursor, mcp.json dosyalarını değiştirmeden dinamik yapılandırma yapmana izin veren bir Extension API sunar. Bu, özellikle kurumsal ortamlar ve otomatik kurulum iş akışları için kullanışlıdır.

MCP Extension API Referansı

vscode.cursor.mcp.registerServer() kullanarak MCP sunucularını programatik olarak nasıl kaydedeceğini öğren

Yapılandırma konumları

Proje Yapılandırması

Projeye özel araçlar için projenin içinde .cursor/mcp.json oluştur.

Genel Yapılandırma

Her yerde kullanılabilen araçlar için ana dizininde ~/.cursor/mcp.json oluştur.

Yapılandırma interpolasyonu

mcp.json değerlerinde değişkenler kullan. Cursor şu alanlardaki değişkenleri çözümler: command, args, env, url ve headers.

Desteklenen sözdizimi:

• ${env:NAME} ortam değişkenleri
• ${userHome} ana dizininin yolu
• ${workspaceFolder} proje kökü (.cursor/mcp.json dosyasını içeren klasör)
• ${workspaceFolderBasename} proje kökünün adı
• ${pathSeparator} ve ${/} işletim sistemi yol ayırıcıları

Örnekler

{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Kimlik Doğrulama

MCP sunucuları kimlik doğrulaması için ortam değişkenlerini kullanır. API anahtarlarını ve belirteçleri config üzerinden ilet.

Cursor, gerektiğinde OAuth’u destekler.

Sohbette MCP kullanma

Composer Agent, uygun olduğunda Available Tools altında listelenen MCP araçlarını otomatik olarak kullanır. Belirli bir aracı adıyla iste ya da neye ihtiyacın olduğunu anlat. Araçları ayarlardan etkinleştir veya devre dışı bırak.

Araçları açıp kapatma

MCP araçlarını direkt sohbet arayüzünden etkinleştir veya devre dışı bırak. Bir aracı açıp kapatmak için araçlar listesindeki araç adına tıkla. Devre dışı bırakılan araçlar bağlama yüklenmez ve Agent tarafından kullanılamaz.

Araç onayı

Agent, varsayılan olarak MCP araçlarını kullanmadan önce onay ister. Argümanları görmek için araç adının yanındaki oka tıkla.

Otomatik çalıştırma

Agent’ın sormadan MCP araçlarını kullanabilmesi için otomatik çalıştırmayı etkinleştir. Terminal komutları gibi çalışır. Otomatik çalıştırma ayarları hakkında daha fazlasını buradan öğrenebilirsin.

Araç yanıtı

Cursor, sohbette argümanlar ve yanıtlar için genişletilebilir görünümlerle sonucu gösterir:

Bağlam olarak görseller

MCP sunucuları görseller döndürebilir — ekran görüntüleri, diyagramlar vb. Bunları base64 kodlanmış string’ler olarak döndür:

const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ okunabilirlik için tam base64 kısaltıldı

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});

Uygulama ayrıntıları için şu örnek sunucuya bak. Cursor, döndürülen görselleri sohbete ekler. Model görselleri destekliyorsa, onları analiz eder.

Güvenlikle ilgili dikkat edilmesi gerekenler

MCP sunucularını kurarken şu güvenlik uygulamalarını göz önünde bulundur:

• Kaynağı doğrula: MCP sunucularını yalnızca güvenilir geliştiriciler ve depolardan yükle
• İzinleri gözden geçir: Sunucunun hangi verilere ve API’lere erişeceğini kontrol et
• API anahtarlarını sınırla: Gerekli en az izinlere sahip kısıtlı API anahtarları kullan
• Kodu denetle: Kritik entegrasyonlar için sunucunun kaynak kodunu incele

MCP sunucularının harici hizmetlere erişip senin adına kod çalıştırabileceğini unutma. Kurmadan önce bir sunucunun ne yaptığını mutlaka anla.

Gerçek dünya örnekleri

MCP’nin pratik kullanımına dair örnekler için, geliştirme iş akışına Linear, Figma ve tarayıcı araçlarını entegre etmeyi gösteren Web Development kılavuzu’na göz at.

SSS

MCP sunucularının amacı nedir?

MCP sunucuları Cursor’ı Google Drive, Notion ve diğer hizmetler gibi harici araçlara bağlayarak dokümanları ve gereksinimleri kodlama iş akışına dahil eder.

MCP sunucu sorunlarını nasıl debug ederim?

MCP loglarını görüntülemek için: 1. Cursor’da Output panelini aç (Ctrl+Shift+U) 2. Dropdown’dan “MCP Logs”u seç 3. Bağlantı hatalarını, kimlik doğrulama sorunlarını veya sunucu çökmelerini kontrol et Loglar sunucu başlatma, araç çağrıları ve hata mesajlarını gösterir.

Bir MCP sunucusunu geçici olarak devre dışı bırakabilir miyim?

Evet! Sunucuları kaldırmadan açıp kapatabilirsin: 1. Ayarları aç ( Ctrl+Shift+J) 2. Features → Model Context Protocol’e git 3. Herhangi bir sunucunun yanındaki toggle’a tıklayarak etkinleştir/devre dışı bırak Devre dışı bırakılan sunucular yüklenmez veya sohbette görünmez. Bu, sorun giderme veya araç karmaşasını azaltmak için kullanışlı.

Bir MCP sunucusu çökerse veya zaman aşımına uğrarsa ne olur?

Bir MCP sunucusu başarısız olursa: - Cursor sohbette bir hata mesajı gösterir - Araç çağrısı başarısız olarak işaretlenir - İşlemi yeniden deneyebilir veya ayrıntılar için logları kontrol edebilirsin - Diğer MCP sunucuları normal şekilde çalışmaya devam eder Cursor, bir sunucunun diğerlerini etkilemesini önlemek için sunucu başarısızlıklarını izole eder.

Bir MCP sunucusunu nasıl güncellerim?

npm tabanlı sunucular için: 1. Sunucuyu ayarlardan kaldır 2. npm cache’ini temizle: npm cache clean --force 3. En son sürümü almak için sunucuyu yeniden ekle Özel sunucular için, yerel dosyalarını güncelle ve Cursor’ı yeniden başlat.

MCP sunucularını hassas verilerle kullanabilir miyim?

Evet, ama güvenlik en iyi uygulamalarını takip et: - Gizli bilgiler için environment variable’ları kullan, asla hardcode etme - Hassas sunucuları stdio transport ile yerel olarak çalıştır - API key izinlerini gerekli minimum ile sınırla - Hassas sistemlere bağlanmadan önce sunucu kodunu incele - Sunucuları izole edilmiş ortamlarda çalıştırmayı düşün