Eklentiler

Eklentiler; kuralları, becerileri, agent'ları, komutları, MCP sunucularını ve hook'ları dağıtılabilir paketler hâlinde bir araya getirir.

Cursor, kendi eklenti biçiminin yanı sıra Agent Plugins açık standardını da destekler. Bunları Özelleştir sayfasından kurup yönetebilir veya Cursor pazaryeri üzerinden resmî eklentilere göz atabilirsiniz. Topluluk eklentileri ve MCP sunucuları için cursor.directory sitesine göz atın. Ayrıca diğer geliştiricilerle paylaşmak için kendi eklentilerinizi geliştirebilirsiniz.

Eklentilerin içeriği

Bir eklenti, aşağıdaki bileşenlerin herhangi bir birleşimini içerebilir:

Agent Plugins standardı

Eklentiler, bir agentın kullanabileceği yeniden kullanılabilir bileşenleri bir araya getirir. Agent Plugins, tekil yetenekler için standart tanımlayan Agent Skills gibi, taşınabilir yetenekleri ve MCP sunucularını paketlemeye yönelik açık bir standarttır. Cursor, Cursor eklentilerinin yanı sıra Agent Plugins'i de destekler.

• Agent Plugins: eklenti kökünde plugin.json manifesti bulunan, yetenekleri ve MCP sunucularını paketleyen spesifikasyona uygun eklentiler
• Cursor Plugins: .cursor-plugin/plugin.json manifesti bulunan; kurallar, agentlar, komutlar, hook'lar ve değişkenler ekleyen eklentiler

Agent Plugins spesifikasyonuna uyan bir eklenti, değişiklik yapılmadan Cursor'a yüklenir. Cursor eklentileri standartla paralel olarak gelişmeye devam eder; bu sayede Cursor'a özgü bileşenler ve marketplace özellikleri bugünkü gibi çalışmayı sürdürür.

Daha fazla bilgi için agent-plugins.org adresini ziyaret edin veya GitHub'daki spesifikasyonu okuyun.

Cursor eklentisi Canvases'leri

Eklentiler artık ekibinizin açıp yeniden kullanabileceği paylaşımlı kurulum şablonları olan hazır Canvases'lerle birlikte sunuluyor.

• Hex Canvas — Veri görselleştirmeleri oluşturun. Cursor'da analizleri incelemek ve paylaşmak için Hex Canvas'ı kullanıyoruz.
• Atlassian Canvas — Jira ve Confluence'taki sorunlarınızı, projelerinizi ve belgelerinizi gerçek zamanlı olarak görüntüleyin.

Her şeyi sıfırdan yapılandırmak yerine rehberli bir başlangıç noktası için Customize'ta kurulu bir eklentiden bir canvas açın.

Pazaryeri

Cursor pazaryeri, resmi Cursor eklentilerini keşfedip kurabileceğiniz yerdir. Eklentiler Git depoları olarak dağıtılır ve Cursor ekibi aracılığıyla gönderilir.

Her eklenti, listelenmeden önce manuel olarak incelenir. Resmi eklentilere cursor.com/marketplace adresinden göz atabilir veya Özelleştir bölümünde anahtar kelimeyle arayabilirsiniz. Topluluk eklentileri ve MCP sunucuları için cursor.directory adresine göz atın.

Ekip marketplace’leri

Ekip marketplace’leri Teams ve Kurumsal planlarda kullanılabilir. Aynı marketplace üzerinden Agent Eklentileri ve Cursor eklentileri dağıtabilir.

• Teams planı: en fazla 1 ekip marketplace’i
• Kurumsal plan: sınırsız ekip marketplace’i

Sınırsız ekip marketplace’i ve Kurumsal yönetici denetimleri için satış ekibiyle iletişime geçin.

Ekip marketplace’lerini yönetmek için Kontrol Paneli -> Eklentiler’i açın.

Varsayılan ekip marketplace'i

Default ekip marketplace'i, paylaşılan eklentileri ve MCP sunucularını Cursor genelinde erişilebilir kılar. Yöneticiler, Cloud Agents için zaten kullanılabilir olan Ekip MCP sunucularını ekleyebilir ve aynı sunucuları ekip arkadaşlarının Agent Window, IDE ve CLI üzerinden kurup yapılandırmasına sunabilir.

Bir Ekip MCP sunucusunu Default marketplace'ine eklemek, sunucuyu her geliştirici için kurmaz veya etkinleştirmez. Yöneticiler marketplace erişimini ve eklenti kurulum modlarını kontrol etmeye devam eder. Her geliştiricinin ayrıca MCP sağlayıcısıyla kimlik doğrulaması yapması gerekebilir.

Mevcut Ekip MCP'lerini taşıma

Yöneticiler, bağımsız Ekip MCP sunucularını Default marketplace'e bağlayabilir:

1. Dashboard -> Integrations & MCP bölümünü açın.
2. Team MCP Servers öğesini bulun.
3. Taşıma isteminde Add to Team Marketplace seçeneğini belirleyin.
4. Default marketplace'i, erişim ayarlarını ve eklenti kurulum modlarını incelemek için Dashboard -> Plugins bölümünü açın.

Cursor, gerekirse Default marketplace'i oluşturur ve mevcut MCP sunucularını buna bağlar. Sunucular bulut ajanları tarafından kullanılmaya devam ederken ekip arkadaşları da bunları yerel olarak kurup yapılandırabilir.

Marketplace erişimi

Ekip marketplace'leri varsayılan olarak ekipteki herkesin kullanımına açıktır. Yöneticiler, Marketplace Ayarları -> Marketplace Erişimi bölümünden bir marketplace'e erişimi seçili Kuruluş Gruplarıyla sınırlayabilir. Yalnızca marketplace'in ekibinde yer alan ve seçili bir gruba ait üyeler erişebilir. Ekip yöneticileri erişimlerini korur.

SCIM nasıl çalışır?

Kuruluş Grupları, SCIM aracılığıyla kimlik sağlayıcınızdaki üyelikleri senkronize edebilir. Üyelikleri kimlik sağlayıcınızdan yönetin; Cursor bu güncellemeleri Kuruluş Grubuyla senkronize eder.

Ekip düzeyindeki SCIM dizin gruplarını kullanan mevcut marketplace'ler bu yapılandırmayı korur. Cursor bu atamaları otomatik olarak taşımaz. Kuruluş Grupları olmayan kuruluşlar SCIM dizin gruplarını kullanmaya devam eder.

Eklenti kurulum modları

Marketplace erişimini ayarladıktan sonra, her eklentinin bu kullanıcılara nasıl sunulacağını seçin:

• Default Kapalı: Geliştiriciler eklentiyi bulabilir ve yükleyip yüklemeyeceklerini seçebilir.
• Default Açık: Eklenti varsayılan olarak yüklenir, ancak geliştiriciler bunu devre dışı bırakabilir.
• Zorunlu: Eklenti her zaman yüklenir ve kaldırılamaz.

Ekip marketplace'i ekleme

Bir GitHub reposunu ekip marketplace'i olarak içe aktarmak için şu adımları izleyin:

1. Dashboard -> Plugins bölümüne gidin.
2. Team Marketplaces bölümünde Add Marketplace seçeneğine tıklayın.
3. Sıfırdan bir marketplace oluşturmak için talimatları izleyin veya GitHub'dan içe aktarıyorsanız "Repodan İçe Aktar" seçeneğini kullanın.
4. "Add to Marketplace" seçeneğini kullanarak eklentileri ekleyip inceleyin.
5. Marketplace Settings altında Marketplace Erişimi ayarını yapın, isteğe bağlı olarak Auto Refresh'i etkinleştirin ve kaydedin.

Denemek için örnek repo:

• fieldsphere/cursor-team-marketplace-template

Eklentileri güncel tutun

GitHub'dan içe aktarırken eklentiler, depoyu ilk içe aktardığınızda indekslenir. Eklentileri iki şekilde yenileyebilirsiniz:

• Otomatik: Marketplace'in takip ettiği dala değişiklikler push edildiğinde eklentileri otomatik olarak güncellemek için Enable Auto Refresh seçeneğini etkinleştirin. Bunun için Cursor GitHub App'in depoda kurulu olması gerekir. Cursor, bir marketplace'i en fazla 10 dakikada bir yeniden indeksler ve hızlı push işlemlerini en son commit'te toplu hâlde işler.
• Manuel: Manuel olarak güncellemek için "Refresh" seçeneğine tıklayın.

Geliştiriciler ekip marketplace'lerini nerede bulabilir?

Geliştiriciler ekip marketplace'lerini Özelleştir bölümünde bulabilir.

• Kenar çubuğundan Özelleştir'i açın
• Ekip marketplace'inizdeki eklentileri bulun.
• Default Off eklentilerini doğrudan bu panelden kurun.
• Default On eklentileri otomatik olarak kurulur, ancak geliştiriciler bunları devre dışı bırakabilir.
• Zorunlu eklentiler otomatik olarak kurulur ve kaldırılamaz.
• Marketplace MCP sunucularını Agent Penceresi, IDE ve CLI'de kullanmak üzere kurun ve yapılandırın.

Eklentileri kurma

Agent eklentilerini ve Cursor eklentilerini bir marketplace'ten kurun. Cursor, biçimi eklenti manifestinden algıladığından kurulum akışı ikisi için de aynıdır:

1. Kenar çubuğunda Özelleştir'i açın.
2. Kullanmak istediğiniz eklentiyi bulun.
3. Kur'u seçin ve proje veya kullanıcı kapsamını belirleyin.

Bir Agent eklentisinin kök dizininde plugin.json manifesti bulunur. Bir Cursor eklentisinde ise .cursor-plugin/plugin.json manifesti bulunur. Ekip marketplace'leri, yukarıda açıklanan erişim ve kurulum modlarını kullanarak her iki biçimi de dağıtabilir.

Eklenti geliştirirken her iki biçimi de doğrudan ~/.cursor/plugins/local konumundan yükleyebilirsiniz. Bkz. Eklentileri yerel olarak test etme.

MCP Apps Deeplink'leri

MCP sunucu yapılandırmalarını kurulum bağlantılarıyla paylaşın:

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

Bu bağlantıların nasıl oluşturulacağı hakkında bilgi için MCP yükleme bağlantılarına bkz.

Kurulu eklentileri yönetme

Kurulu Agent Plugins, Cursor Plugins, MCP sunucuları, kurallar ve becerileri tek bir yerden yönetmek için kenar çubuğunda Özelleştir'i açın. Nelerin kurulu olduğunu görmek için kullanıcı, çalışma alanı veya ekip kapsamına göre filtreleyin.

MCP sunucuları

Kişisel ve ekip tarafından dağıtılan MCP sunucularını Customize bölümünden açıp kapatabilirsiniz:

1. Kenar çubuğunda Customize bölümünü açın
2. Değiştirmek istediğiniz MCP sunucusunu bulun
3. Etkinleştirmek veya devre dışı bırakmak için açma/kapatma düğmesini kullanın

Devre dışı bırakılan sunucular yüklenmez ve sohbette görünmez.

Kurallar ve beceriler

Kuralları ve becerileri Özelleştir bölümünden yönetin. Tek tek kurallar için Her Zaman, Agent Karar Verir ve Manuel modları arasında geçiş yapın. Beceriler Agent Karar Verir bölümünde görünür ve sohbette /skill-name ile manuel olarak çağrılabilir.

workspaceOpen hook'unu kullanma

Bir workspaceOpen hook'u, çalışma alanı açıldığında yüklenecek eklenti yollarını döndürebilir. Bu, eklenti kümesinin çalışma alanına bağlı olduğu durumlarda kullanışlıdır.

Eklenti oluşturma

Eklenti, manifest ve bileşenlerinden oluşan bir dizindir. Taşınabilir becerileri ve MCP sunucularını paketlemek için Agent Plugins'i seçin. Kurallar, ajanlar, komutlar, hook'lar veya değişkenler gibi Cursor'a özgü bileşenlere de ihtiyacınız varsa Cursor eklentilerini seçin.

my-plugin/├── plugin.json├── skills/│   └── code-reviewer/│       └── SKILL.md└── mcp.json

{  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",  "name": "my-plugin",  "description": "Portable code review tools",  "version": "1.0.0",  "author": { "name": "Your Name" }}

Cursor eklentisi şablon deposundan başlayın veya Agent Plugin oluşturmak için Agent Plugins oluşturma kılavuzunu okuyun.

Eklentileri yerel olarak test etme

Yayımlamadan önce, iki eklenti biçiminden birini ~/.cursor/plugins/local konumundan yükleyin:

1. Eklentiniz için bir klasör oluşturun: ~/.cursor/plugins/local/my-plugin
2. Eklenti dosyalarınızı bu klasöre kopyalayın. Agent Plugin için kök dizine plugin.json, Cursor eklentisi için ise .cursor-plugin/plugin.json ekleyin.
3. Cursor'ı yeniden başlatın veya Developer: Reload Window komutunu çalıştırın.
4. Kurallar, beceriler veya MCP sunucuları gibi eklenti bileşenlerinizin Cursor'da yüklendiğini doğrulayın.

Daha hızlı yinelemek için eklenti deponuza sembolik bağlantı oluşturun:

ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-plugin

Eklentiniz hazır olduğunda, incelemeye göndermek için cursor.com/marketplace/publish adresini kullanın. Cursor eklentileri, çoklu eklenti repoları için .cursor-plugin/marketplace.json kullanabilir.

Manifest şemasının tamamı, bileşen biçimleri ve gönderim kontrol listesi için Eklentiler başvuru rehberi sayfasına bakın.

SSS