AIREITER

Claude Plugin Gönderim Portalı: Adım Adım Rehber

Son Güncelleme: 2026-09-25 18:56:42

Claude eklentisi gönderim portalını arıyorsanız Anthropic’in geliştirici portalını kullanın: claude.ai/directory/manage. Mevcut akışta Submit new → Plugin bundle seçiliyor. Ancak eklentinin dizinde yayımlanabilmesi için herkese açık bir GitHub deposu, gönderim yapmaya uygun bir plan ve rol ile incelemeyi geçen bir sürüm gerekiyor.

Claude eklentisi göndermenin güncel yolu

Resmi süreç, herkese açık GitHub marketplace deposundan değil, Anthropic’in eklenti gönderim belgelerinden başlıyor. Aynı depoda birden fazla eklenti bulunsa bile her eklenti klasörü ayrı bir gönderim olarak ele alınıyor.

GerekenGüncel koşul
Gönderim sayfasıclaude.ai/directory/manage
Gönderim türüPlugin bundle
KaynakListe yayımlanmadan önce herkese açık bir GitHub deposu
ErişimDizine gönderim yapmaya izin veren plan ve rol
İncelemeDoğrulama ve güvenlik taraması; bazı sürümler incelemeciye yönlendirilir
YayımlamaKontrolleri geçen sürümün ayrıca yayımlanması gerekir

Bu rehber, özel ekip paylaşımını veya eklentiyi yerel olarak kurmayı değil, herkese açık dizin dağıtımını anlatıyor.

Portalı açmadan önce hazırlık

Portalın başına geçmeden önce depoyu hazır hale getirin.

1. Eklentiyi GitHub’a koyun

Dizin eklentileri github.com üzerinden okuyor ve Anthropic, liste yayımlanmadan önce deponun herkese açık olması gerektiğini belirtiyor. Eklenti depo kökünde değilse klasör yolunu not edin.

Standart bir Claude Code eklentisinde genellikle şu dosya ve klasörler bulunur:

plugin-name/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json          # optional
├── commands/          # optional
├── agents/            # optional
├── skills/            # optional
└── README.md

Dizin kaydındaki bilgilerin önemli bir bölümü manifest dosyası ile README’den alınır. Gönderimden önce eklentinin lisansını ve kullandığı harici servisleri kontrol edin.

2. Yerel doğrulamayı çalıştırın

Eklenti klasörünü içeren dizinde şu komutu çalıştırın:

claude plugin validate ./<plugin-folder>

Bu komut yapı ve biçimlendirme sorunlarını yakalar. Ancak portalda bulunan Validate adımı ek kontroller de yapar. Yerel doğrulamayı onay değil, ilk kontrol olarak değerlendirin.

3. Gerekiyorsa MCP bağlayıcısını ayrı gönderin

Eklentiniz sizin işlettiğiniz uzak bir MCP sunucusuna referans veriyorsa ve bu sunucu daha önce gönderilmediyse Anthropic’in rehberine göre sunucuyu ayrıca MCP connector olarak göndermeniz gerekir. Eklenti paketi ile bağlayıcı, dizinde ayrı kayıtlar olarak yer alır.

Tek bir eklenti paketini adım adım gönderme

1. Plugin bundle seçeneğini seçin

Geliştirici portalını açıp Submit new seçeneğine tıklayın. Ne göndermek istediğiniz sorulduğunda Plugin bundle seçeneğini işaretleyin. MCP connector yalnızca uzak bir MCP sunucusunu ayrı bir kayıt olarak gönderiyorsanız kullanılmalı.

2. Depo, yol ve dal bilgilerini girin

Source bölümünde şu bilgileri sağlayın:

  • GitHub URL’si veya owner/repo biçimi.
  • .claude-plugin/plugin.json depo kökünde değilse Plugin path.
  • Dizinin varsayılan dal yerine başka bir dalı ya da etiketi takip etmesini istiyorsanız Branch or tag.

Bir etiket, siz etiketi değiştirene kadar kendi commit’inde kalır. Dal adında eğik çizgi varsa adı açıkça girin veya resmi gönderim rehberinde açıklanan owner/repo@branch biçimini kullanın.

Validate seçeneğine tıklayın. Bir bulgu gönderimi engelliyorsa depoyu düzeltin, değişikliği gönderin ve doğrulamayı yeniden çalıştırın. Doğrulama tek bir commit için geçerlidir.

3. Oluşturulan liste kaydını kontrol edin

Listing details adımı, eklentinin dizinde nasıl görüneceğini gösterir. Anthropic bu bilgileri plugin.json ve README’den alır.

Adı veya kısa açıklamayı düzeltmeniz gerekiyorsa kaynak dosyalarını değiştirin. Anthropic’in resmi eklenti dizini de yayımlanmış bir kurulum slug’ının sabit kalması gerektiği konusunda uyarıyor; aksi halde kullanıcılar plugin-not-found hatasıyla karşılaşabilir. Sıradan metin değişikliklerinde görünen etiketi güncelleyin, yeniden adlandırma eşlemesini ise zorunlu bir geçiş gerekiyorsa kullanın.

4. Veri işleme sorularını yanıtlayın

Data handling adımında eklentinin şunları yapıp yapmadığı sorulur:

  • Kişisel verileri okuması veya saklaması.
  • Verileri tanımlı bağlayıcılar dışındaki servislere göndermesi.
  • Verileri saklaması ve saklama süresi.
  • 18 yaşından küçük kişileri hedeflemesi.

Yanıtları eklentinin gerçek davranışına göre verin. Uzak servisleri, dosya erişimini, telemetriyi ve veri saklama davranışını da hesaba katın.

5. Uyumluluk onaylarını tamamlayın

Compliance bölümünde Anthropic’in size ulaşabileceği bir iletişim e-postasını doğrulayın ve gerekli onayları seçin. Eklentinin Anthropic’in Software Directory policy kurallarına uyması gerekir.

6. Gönderin ve güncellemelerin nasıl teslim edileceğini seçin

Review and submit adımında bilgileri son kez kontrol edin ve yeni sürümlerin nasıl alınacağını seçin:

  • GitHub push webhook; mevcut rehberde varsayılan seçenek olarak belirleniyor ve yapılandırıldığında push işlemlerinden sonra kontrolleri tetikleyebiliyor.
  • Scheduled check only; takip edilen dal veya etikete yönelik periyodik kontrollere dayanıyor.

Submit for review seçeneğine tıklayın. Webhook’u yapılandırmak için GitHub yönetici erişimi gerekir. Anthropic şu anda bir kuruluşu 24 saatlik herhangi bir dönemde 10 gönderimle sınırlıyor; kaydedilmiş taslaklar ve geri çekilen gönderimler de bu sınıra dahil. Bu sınırlar ve güncelleme seçenekleri gönderim iş akışı belgelerinde açıklanıyor.

Gönderimden sonra ne olur?

Anthropic, takip edilen dal veya etiketteki en yeni commit’i tarar, dizin doğrulamasını yeniden çalıştırır ve güvenlik taraması yapar. Resmi rehberde yer alan durumlar şöyle:

DurumAnlamıSonraki adım
Tüm kontrolleri geçerSürüm yayımlanmaya uygundurPublish seçeneğine tıklayın
İncelemeci bekliyorBulguların bir incelemeci tarafından temizlenmesi gerekirİstenen değişiklikleri yapın veya incelemeyi bekleyin
Kontrolleri geçemezPortal, ihlal edilen kuralları veya güvenlik kategorisini listelerDepoyu düzeltin, ardından yeni commit’i kontrol edin
ReddedildiGönderim onaylanmadıİstenen değişiklikleri okuyup Resubmit for review seçeneğini kullanın

Kontrolleri geçen bir sürümün hemen yayında olması şart değil. Varsayılan ayar, yayımlama isteği oluşturulmasını ve bir incelemecinin yayına almasını gerektirebilir; portal bazı sonraki başarılı sürümler için otomatik yayımlama ayarlarını da destekler.

İlerlemeyi takip etmek için Submissions altında eklentiyi açıp Versions bölümünü inceleyin. Düzeltme yaptıktan sonra kullanılabiliyorsa Check for new commits seçeneğini kullanın. Güncellemelerde formu yeniden göndermeniz gerekmez; takip edilen dala push yapmanız veya takip edilen etiketi taşımanız yeterlidir. Yeni sürüm hata veriyor ya da inceleme bekliyor olsa bile son yayımlanan sürüm yayında kalır.

Geliştiricilerin atlamaması gereken güvenlik kontrolleri

Anthropic’in resmi dizini, eklentilerin MCP sunucuları, dosyalar ve Anthropic’in kontrolü dışındaki başka yazılımlar içerebileceği konusunda uyarıyor. Gönderimden önce tüm harici servisleri, izinleri, saklama sürelerini ve arka planda çalışan işlemleri belgeleyin.

“Yani, eklenti gönderimlerimin neden başarısız olduğunu denetlemesini ve sorunu düzeltmesini istedim.” — @tarasshyn, gönderim hatası ve denetim akışını anlatırken X.

Gönderim öncesi kontrol listeniz şöyle olsun:

  1. Giden tüm servisleri belirtin ve belgeleyin.
  2. İzinleri, kurulumu, veri akışını ve saklama süresini README’de açıklayın.
  3. Takip edilen referansta yayımlamak istediğiniz kodun bulunduğunu doğrulayın.
  4. Her düzeltme commit’inden sonra doğrulamayı yeniden çalıştırın.
  5. Arka planda çalışan indeksleme işlemlerini, telemetriyi veya maliyetli otomatik davranışları açıkça belirtin.

SSS: Claude eklentisi gönderimi

GitHub deposunun herkese açık olması gerekiyor mu?

Evet. Anthropic’in güncel belgelerinde, liste yayımlanmadan önce deponun herkese açık olması gerektiği belirtiliyor.

Tek bir depodan birden fazla eklenti gönderebilir miyim?

Evet, ancak her eklenti klasörü kendi gönderimi olarak değerlendirilir. Portala ilgili her yolu ayrı ayrı girin.

Topluluk deposuna pull request açarak gönderim yapabilir miyim?

Hayır. Anthropic’in topluluk marketplace README’si, bu deponun salt okunur bir ayna olduğunu ve doğrudan pull request’lerin otomatik olarak kapatıldığını belirtiyor. Bunun yerine geliştirici portalını kullanın.

Uzak bir MCP sunucusunu ayrıca göndermem gerekiyor mu?

Eklentiniz sizin işlettiğiniz ve henüz listelenmemiş bir uzak MCP sunucusuna referans veriyorsa sunucuyu ayrıca MCP connector olarak gönderin.

Doğrulama başarısız olursa ne yapmalıyım?

Depoyu düzeltin, değişikliği gönderin ve doğrulamayı yeniden çalıştırın. Doğrulama belirli bir commit için geçerlidir. Gönderimden sonra, kullanılabiliyorsa portalın yeni commit kontrolünü çalıştırın.

Tarama başarılı olduğunda eklenti otomatik olarak yayımlanır mı?

Her zaman değil. Kontrolleri geçen bir sürüm için yine de Publish seçeneğine tıklamanız ve incelemecinin yayımlamasını beklemeniz gerekebilir. Sonraki başarılı sürümlerin nasıl ele alınacağını portalın otomatik yayımlama ayarı belirler.

Yayımlanmış bir eklentiyi dizinden kaldırabilir miyim?

Evet. Geliştirici portalında yayındaki eklentiyi açıp Delist plugin isteği oluşturun. Anthropic’e göre değişikliğin tüm Claude uygulamalarına ulaşması zaman alabilir ve mevcut kullanıcılar güncellemeleri almayı bırakabilir.

Herkese açık bir liste için en kısa yol şu: depoyu herkese açık hale getirin, yerel doğrulamayı çalıştırın, Plugin bundle gönderin, commit’e özel bulguları düzeltin, veri ve uyumluluk adımlarını tamamlayın ve kontrolleri geçen sürümü yayımlayın. Dizin görünürlüğünün getireceği inceleme ve bakım yükünü karşılamıyorsa ekip içi paketi özel tutun.