​
MCP Nedir?

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

​
Neden MCP kullanmalı?

MCP, Cursor’u harici sistemlere ve verilere bağlar. Proje yapınızı tekrar tekrar açıklamak yerine, doğrudan araçlarınızla entegre olun. MCP sunucularını stdout’a yazdırabilen veya HTTP endpoint’i sunabilen herhangi bir dilde yazın - Python, JavaScript, Go, vb.

​
Nasıl çalışır

MCP sunucuları protokol aracılığıyla yetenekleri ortaya çıkarır ve Cursor’u harici araçlara veya veri kaynaklarına bağlar. Cursor üç taşıma yöntemini destekler:
TaşımaYürütme ortamıDağıtımKullanıcılarGirdiKimlik doğrulama
stdioYerelCursor yönetirTek kullanıcıShell komutuManuel
SSEYerel/UzakSunucu olarak dağıtÇoklu kullanıcıSSE endpoint’ine URLOAuth
Streamable HTTPYerel/UzakSunucu olarak dağıtÇoklu kullanıcıHTTP endpoint’ine URLOAuth

​
MCP sunucularını yükleme

​
Tek tıkla yükleme

Koleksiyonumuzdan MCP sunucularını yükleyin ve OAuth ile kimlik doğrulaması yapın.

MCP Araçlarına Göz Atın

Mevcut MCP sunucularına göz atın

Cursor'a Ekle Butonu

“Cursor’a Ekle” butonu oluşturun

​
mcp.json kullanarak

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

​
Yapılandırma konumları

Proje Yapılandırması

Projeye özel araçlar için projenizde .cursor/mcp.json oluşturun.

Global Yapılandırma

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

​
Kimlik doğrulama

MCP sunucuları kimlik doğrulama için ortam değişkenlerini kullanır. API anahtarlarını ve token’ları yapılandırma üzerinden geçirin. Cursor, bunu gerektiren sunucular için OAuth’u destekler.

​
Chat’te MCP kullanımı

Composer Agent, ilgili olduğunda Available Tools altında listelenen MCP araçlarını otomatik olarak kullanır. Belirli bir aracı adıyla isteyin veya neye ihtiyacınız olduğunu açıklayın. Araçları ayarlardan etkinleştirin veya devre dışı bırakın.

​
Araçları açma/kapama

MCP araçlarını doğrudan chat arayüzünden etkinleştirin veya devre dışı bırakın. Açmak/kapatmak için araç listesindeki bir araç adına tıklayın. Devre dışı bırakılan araçlar bağlama yüklenmez veya 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ıklayın.

​
Otomatik çalıştırma

Agent’ın MCP araçlarını sormadan kullanması için otomatik çalıştırmayı etkinleştirin. Terminal komutları gibi çalışır. Yolo modu hakkında daha fazla bilgiyi buradan okuyun.

​
Araç yanıtı

Cursor yanıtı chat’te argümanların ve yanıtların genişletilebilir görünümleriyle gösterir:

​
Bağlam olarak görüntüler

MCP sunucuları görüntüler döndürebilir - ekran görüntüleri, diyagramlar, vb. Bunları base64 kodlanmış dizeler olarak döndürün: 
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",
      },
    ],
  };
});
Uygulama detayları için bu örnek sunucuya bakın. Cursor döndürülen görüntüleri chat’e ekler. Model görüntüleri destekliyorsa, onları analiz eder.

​
Güvenlik hususları

MCP sunucularını kurarken şu güvenlik uygulamalarını göz önünde bulundurun:
  • Kaynağı doğrulayın: Yalnızca güvenilir geliştiriciler ve depolardan MCP sunucuları kurun
  • İzinleri gözden geçirin: Sunucunun hangi verilere ve API’lere erişeceğini kontrol edin
  • API anahtarlarını sınırlayın: Minimum gerekli izinlere sahip kısıtlı API anahtarları kullanın
  • Kodu denetleyin: Kritik entegrasyonlar için sunucunun kaynak kodunu inceleyin
MCP sunucularının harici hizmetlere erişebileceğini ve sizin adınıza kod çalıştırabileceğini unutmayın. Kurulumdan önce bir sunucunun ne yaptığını her zaman anlayın.

​
Gerçek dünya örnekleri

MCP’nin pratikte nasıl kullanıldığına dair pratik örnekler için, geliştirme iş akışınıza Linear, Figma ve tarayıcı araçlarını entegre etmeyi gösteren Web Geliştirme kılavuzumuza bakın.

​
SSS