Cursor MCP Kurulumu: Bilgi Kartları için Adım Adım

Cursor'u ana editörün olarak kullanıyorsan, onu Model Context Protocol (MCP) aracılığıyla Deckbase(opens in a new tab) uygulamasına bağlayabilir ve doğrudan kod tabanından bilgi kartları oluşturabilirsin: uygulamalar arasında geçiş yapman, içerik kopyalaman veya editörden çıkman gerekmez.

Bu rehber, bilgi kartı oluşturma için eksiksiz Cursor MCP kurulumunu anlatır: MCP nedir, Deckbase entegrasyonuyla neler yapabilirsin ve adım adım yapılandırma.

MCP nedir ve bilgi kartları için neden önemlidir?

MCP (Model Context Protocol), yapay zeka araçlarının harici hizmetlere bağlanmasını sağlayan açık bir standarttır. Cursor'da bir MCP sunucusu yapılandırdığında, editöründeki yapay zeka asistanı bu hizmetin API'sini doğrudan çağırma yeteneği kazanır: ayrıca açman gereken bir tarayıcı sekmesi olarak değil, konuşmanın içinde bir araç olarak.

Bilgi kartı oluşturma açısından bu şu anlama gelir:

• Bir fonksiyon, sınıf veya dokümantasyon bloğu seçip Cursor'un bunlardan bilgi kartları oluşturmasını isteyebilirsin

• Kod yorumlarından, README dosyalarından veya satır içi dokümantasyondan kartlar üretebilirsin

• Projendeki herhangi bir dosya veya klasörden bir deste oluşturabilirsin

• Editörden çıkmadan mevcut bir Deckbase destesine kart ekleyebilirsin

Pratik sonuç: yeni bir kod tabanı öğreniyorsan, teknik sertifikasyonlara hazırlanıyorsan veya dokümantasyondan kişisel bir bilgi tabanı oluşturuyorsan, kart oluşturmayı tek bir yapay zeka komutuna indirgersin.

Ön koşullar

• Cursor (son sürüm)

• Bir Deckbase hesabı(opens in a new tab) (ücretsiz katman yeterlidir)

• Deckbase API anahtarı (hesap ayarlarında bulunur)

• Node.js 18+ kurulu (MCP sunucusunu çalıştırmak için)

Adım 1: Deckbase API anahtarını al

1. deckbase.co(opens in a new tab) adresine giriş yap

2. Ayarlar → API bölümüne git

3. Yeni bir API anahtarı oluştur

4. Anahtarı kopyala: sonraki adımda buna ihtiyacın olacak

Adım 2: Deckbase MCP sunucusunu Cursor'a ekle

Cursor Ayarları → Özellikler → MCP Sunucuları bölümünü aç. Yeni bir sunucu yapılandırması ekle:

{
  "name": "deckbase",
  "command": "npx",
  "args": ["-y", "@deckbase/mcp-server"],
  "env": {
    "DECKBASE_API_KEY": "your-api-key-here"
  }
}

Yapılandırmayı kaydet ve Cursor'u yeniden başlat. Deckbase MCP sunucusu, Cursor açıldığında otomatik olarak başlar.

→ MCP sunucusu dokümantasyonunun tamamı(opens in a new tab)

Adım 3: Bağlantıyı doğrula

Yeni bir Cursor konuşması aç ve şunu yaz:

Deckbase MCP aracını kullanarak destelerimi listele.

Bağlantı çalışıyorsa Cursor, Deckbase destelerinin bir listesini döndürür. Bir hata görürsen API anahtarının doğru olduğundan ve MCP sunucusunun hatasız başladığından emin ol (Cursor'un MCP sunucusu günlüklerini Ayarlar bölümünden kontrol edebilirsin).

Adım 4: Bir kod dosyasından ilk kartlarını oluştur

Editöründe bir fonksiyon veya sınıf seç, bir Cursor konuşması aç ve şunu dene:

Bu koddan, bu fonksiyonun nasıl çalıştığını gözden geçirmem için kullanabileceğim 5 bilgi kartı oluştur. Bunları "Python internals" desteme ekle.

Cursor, kartları doğrudan oluşturmak ve eklemek için Deckbase MCP aracını kullanır. Kopyala-yapıştır yok, sekme değiştirme yok.

Nelerden kart oluşturabilirsin

Deckbase MCP entegrasyonu, Cursor'un erişebildiği her metinle çalışır:

• Kod dosyaları: fonksiyonlar, sınıflar, algoritmalar, tasarım desenleri

• Dokümantasyon: README dosyaları, API referansları, satır içi dokümanlar

• Yorumlar: TODO yorumları, mimari notlar, satır içi açıklamalar

• Yapılandırma dosyaları: her seçeneğin ne yaptığını anlama

• Test dosyaları: hangi davranışın doğrulandığını anlama

Teknik bilgi kartı oluşturma için örnek komutlar

Yeni bir kod tabanı için:

Bu kod tabanını öğreniyorum. Kimlik doğrulama modülünden, oturum yönetiminin nasıl çalıştığını anlamama yardımcı olacak 10 bilgi kartı oluştur. Bunları "Codebase onboarding" desteme ekle.

Sınav hazırlığı için:

Roller, politikalar ve izin sınırları arasındaki farkları kapsayan bu AWS IAM dokümantasyon bölümünden 15 bilgi kartı oluştur. "AWS Solutions Architect" desteme ekle.

İşten günlük tekrar için:

Bugün yazdığım son 3 fonksiyonu ele al ve her biri için temel mantığı, ele alınan uç durumları ve neden bu yaklaşımı seçtiğimi kapsayan tekrar kartları oluştur. "Work knowledge base" desteme ekle.

Kartları Deckbase'de gözden geçirme

Cursor MCP aracılığıyla oluşturduğun kartlar, hemen Deckbase destende görünür ve FSRS ile planlanan tekrara hazır olur. Düzenli programında gözden geçirmek için Deckbase web uygulamasını(opens in a new tab) veya mobil uygulamayı aç.

Oluşturma için Cursor ile tekrar için Deckbase'in birleşimi kapalı bir döngü oluşturur: çalışan koddan öğrenirsin, kavramları uyarlanabilir zamanlamayla tekrar edersin ve projeler arasında kaybolacak teknik bilgiyi kalıcı hale getirirsin.

→ MCP çalışma otomasyonu örnekleri(opens in a new tab)

SSS: Bilgi kartları için Cursor MCP

Deckbase MCP, Cursor dışındaki diğer editörlerle çalışır mı?

Evet. Deckbase MCP sunucusu, MCP destekli her istemciyle uyumludur. Claude Desktop, Cline, Continue ve MCP'yi destekleyen diğer araçlar aynı sunucu yapılandırmasını kullanabilir.

MCP erişimi için ücretli bir Deckbase planına ihtiyacım var mı?

Güncel plan ayrıntılarına deckbase.co/mcp(opens in a new tab) adresinden bak. Ücretsiz katman, temel deste işlemleri için MCP bağlantılarını destekler.

Özel koddan, makinemden çıkmadan kart oluşturabilir miyim?

MCP sunucusu, kart oluşturma için seçilen içeriği Deckbase API'sine gönderir. Tescilli veya hassas kodlarla çalışıyorsan, bu entegrasyonu kullanmadan önce kuruluşunun harici API çağrılarına ilişkin politikasını gözden geçir.

Cursor'dan kart eklemesini istediğimde destem henüz yoksa ne olur?

Deckbase MCP aracı, kart oluşturma akışının bir parçası olarak yeni desteler oluşturabilir. Cursor'a "X adında yeni bir deste oluştur ve bu kartları ekle" komutunu ver.

Bunun metni elle Deckbase'e kopyalamaktan farkı nedir?

Başlıca avantajlar şunlardır: uygulamalar arasında bağlam değiştirme yok, kopyala-yapıştır adımı yok ve tarayıcı açmadan projendeki herhangi bir dosyadan kart oluşturma imkânı. Çalışma zamanının çoğunu bir kod editöründe geçiren öğrenciler için iş akışındaki bu kısalma önemlidir.

→ Deckbase MCP sunucusu kurulumu(opens in a new tab)

→ Deckbase yapay zeka bilgi kartı genel bakışı(opens in a new tab)