MCP nedir?

Model Context Protocol (MCP), Cursor’ın harici araçlara ve veri kaynaklarına bağlanmasını sağlar.

Neden MCP kullanılır?

MCP, Cursor’ı harici sistemlere ve verilere bağlar. Proje yapını tekrar tekrar anlatmak yerine doğrudan araçlarınla entegre ol. MCP sunucularını stdout’a yazdırabilen ya da bir HTTP uç noktası sunabilen herhangi bir dille yazabilirsin — Python, JavaScript, Go vb.

Nasıl çalışır

MCP sunucuları, protokol üzerinden yeteneklerini sunarak Cursor’ı harici araçlara veya veri kaynaklarına bağlar. Cursor üç aktarım yöntemini destekler:
AktarımÇalışma ortamıDağıtımKullanıcılarGirdiKimlik doğrulama
stdioYerelCursor yönetirTek kullanıcıKabuk komutuManuel
SSEYerel/UzakSunucu olarak dağıtBirden çok kullanıcıSSE uç noktasına URLOAuth
Streamable HTTPYerel/UzakSunucu olarak dağıtBirden çok kullanıcıHTTP uç noktasına URLOAuth

Protokol desteği

Cursor şu MCP protokol yeteneklerini destekler:
ÖzellikDestekAçıklama
ToolsDestekleniyorYapay zeka modelinin çalıştıracağı fonksiyonlar
PromptsDestekleniyorKullanıcılar için şablonlu mesajlar ve iş akışları
RootsDestekleniyorÇalışılacak URI veya dosya sistemi sınırlarına sunucu başlatımlı sorgular
ElicitationDestekleniyorKullanıcılardan ek bilgi almak için sunucu başlatımlı istekler

MCP sunucularını yükleme

Tek tıkla kurulum

Koleksiyonumuzdan MCP sunucularını kur ve OAuth ile kimliğini doğrula.

mcp.json kullanma

Özel MCP sunucularını bir JSON dosyasıyla yapılandır:
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Extension API kullanma

Programatik MCP sunucusu kaydı için Cursor, mcp.json dosyalarını değiştirmeden dinamik yapılandırma sağlayan 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ı

Projende proje özelindeki araçlar için .cursor/mcp.json oluştur.

Genel Yapılandırma

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

Kimlik doğrulama

MCP sunucuları kimlik doğrulama için ortam değişkenlerini kullanır. API anahtarlarını ve belirteçleri yapılandırma üzerinden ilet. Cursor, gerekli olan sunucular için 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ı doğrudan sohbet arayüzünden etkinleştir veya devre dışı bırak. Araç listesindeki bir araç adına tıklayarak aç/kapa yap. Devre dışı bırakılan araçlar bağlama yüklenmez ve Agent tarafından kullanılamaz.

Araç onayı

Varsayılan olarak Agent, 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 MCP araçlarını sormadan kullanabilmesi için otomatik çalıştırmayı etkinleştir. Terminal komutları gibi çalışır. Yolo modu hakkında daha fazlasını buradan oku.

Araç yanıtı

Cursor, yanıtı sohbette argümanlar ve yanıtlara ait genişletilebilir görünümlerle gösterir:

Bağlam olarak görseller

MCP sunucuları görseller döndürebilir — ekran görüntüleri, diyagramlar vb. Bunları base64 kodlanmış dizeler olarak döndür:
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ okunabilirlik için tam base64 kırpıldı

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
Uygulamaya dair ayrıntılar için bu örnek sunucuya bak. Cursor döndürülen görselleri sohbete ekler. Model görselleri destekliyorsa, bunları analiz eder.

Güvenlik hususları

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ştiricilerden ve depolardan kur
  • İzinleri gözden geçir: Sunucunun hangi verilere ve API’lere erişeceğini kontrol et
  • API anahtarlarını sınırla: Yalnızca gerekli en düşük yetkilere sahip kısıtlı API anahtarları kullan
  • Kodu denetle: Kritik entegrasyonlar için sunucunun kaynak kodunu incele
MCP sunucularının harici hizmetlere erişebileceğini ve 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 pratikte nasıl çalıştığına dair örnekler için, Linear, Figma ve tarayıcı araçlarını geliştirme iş akışına entegre etmeyi gösteren Web Development guide rehberine göz at.

SSS