Genel bakış

Çalışma alanı yöneticileri, GitHub'daki bir eklenti pazar yerini çalışma alanı dizinlerine aktarabilir. Pazar yeri, içe aktarılacak eklentileri listeleyen bir JSON kataloğudur. İçe aktarmadan sonra günlük senkronizasyon, depodaki değişiklikleri uygulayarak eklentileri güncel tutar.


Pazar yeri senkronizasyonu, eklenti içeriğini içe aktarır; çalışma alanı üyelerinin hesaplarını bağlamaz veya eklentideki uygulamalara erişim sağlamaz.


Eklentiler ve içerdikleri uygulamalar hakkında temel bilgiler için bkz. ChatGPT ve Codex'te eklentiler.

Başlamadan önce

• Pazar yeri deposunu ve bu depoda referans verilen diğer tüm depoları okuma yetkisi olan bir GitHub hesabı kullanın. github.com üzerindeki herkese açık ve özel depolar desteklenir.

• İçe aktarma işlemini yapan hesabın bu depolara erişebilmesi için gereken GitHub kuruluş onaylarını tamamlayın.

• Depo içeriğini inceleyin. İçe aktarma işlemi, her eklenti için ayrı bir onay adımı olmadan tüm geçerli eklentileri işler. Sonraki senkronizasyonlar da yeni eklentiler ekleyebilir.

Yeni eklentilerde başlangıçta yükleme politikası Kullanılabilir, kimlik doğrulama ise yükleme sırasında yapılacak şekilde ayarlanır. Yeni pazar yerlerinde otomatik günlük senkronizasyon etkindir. İçe aktarmadan sonra her eklentinin çalışma alanı ayarlarını ve gerekli uygulamalarını inceleyin.

Pazar yerini içe aktarma

1. Yönetici Konsolu'na gidin, ilgili ChatGPT çalışma alanını seçin ve Eklentiler bölümünü açın. Ardından Ekle'yi ve Pazar yerini içe aktar seçeneğini seçin.

2. Kaynak alanına depo URL'sini girin (örneğin https://github.com/example/team-plugins). Dal veya klasör URL'si olmadan yalnızca depo URL'sini kullanın.

3. Pazar yeri bir alt dizindeyse bu dizini Yol alanına girin. Örneğin team-tools/.agents/plugins/marketplace.json için team-tools girin. Depo kök dizini için Yol alanını boş bırakın. Tanım dosyasının adını girmeyin.

4. İsteğe bağlı olarak Dal, etiket veya commit alanını doldurun. Deponun varsayılan dalını kullanmak için bu alanı boş bırakın. Sonraki commit'leri almak için bir dal kullanın. Sabit bir commit seçerseniz o revizyonda kalınır.

5. Pazar yerini içe aktar seçeneğini seçin ve istendiğinde GitHub erişimine izin verin.

6. İçe aktarma sonuçları'nı inceleyin, ardından içe aktarılan her eklentiyi açarak yükleme politikasını ve gerekli uygulamaları yapılandırın.

Çok büyük pazar yerlerinde ilk içe aktarma işlemi 1 saate kadar sürebilir. Sonraki günlük senkronizasyonlar genellikle birkaç dakika sürer.

Bir eklenti içe aktarılamazsa raporda hatanın açıklaması yer alır. Diğer geçerli eklentiler yine de içe aktarılabilir.

Desteklenen biçimler

Seçilen dizin, desteklenen bir tanım dosyası içermelidir:

• Codex pazar yeri için .agents/plugins/marketplace.json.

• Claude uyumlu pazar yeri için .claude-plugin/marketplace.json.

• Pazar yeri tanım dosyası yoksa bağımsız bir Claude eklentisi için .claude-plugin/plugin.json.

Pazar yeri kayıtları, aynı depodaki eklenti klasörlerine veya desteklenen GitHub depo kaynaklarına referans verebilir. Çalışma alanına içe aktarma işlemi, diğer Git barındırma hizmetlerini ve npm gibi paket kayıt kaynaklarını desteklemez.

Desteklenen biçimler, JSON örnekleri ve kaynak alanları için bkz. Eklenti Yönetimi.

Çalışma alanı erişimini yapılandırma

Eklenti içeriğini GitHub sağlarken yükleme ve kimlik doğrulama, çalışma alanı ayarlarıyla kontrol edilir. İçe aktarma ve senkronizasyon işlemleri, depodaki AVAILABLE veya ON_USE gibi politika değerlerini uygulamaz. Bu ayarları çalışma alanınızdaki her eklenti için yapılandırın.


Uygun her rol için Kullanılabilir veya Yüklü seçeneğini belirlemek üzere Yükleme politikası ayarını kullanın. Gerekli uygulamalar da etkinleştirilmelidir. Ayrıca üyelerin bağlı hizmete erişimi olmalı ve gerekli kimlik doğrulama işlemlerini tamamlamaları gerekir.


Bir eklenti güncellemesini senkronize ettiğinizde veya mevcut bir eklentiyi GitHub yönetimine taşıdığınızda eklentinin çalışma alanı politikaları korunur. Bir eklentiyi içe aktarmak, uygulama erişimi sağlamaz veya üyelerin hesaplarını bağlamaz.


Çalışma alanında gezinme, uygulama erişimi ve çalışma alanı kontrolleri için bkz. Eklentiler ve uygulamalar için yönetici kontrolleri, güvenlik ve uyumluluk.

Eklentileri güncel tutma

Yeni pazar yerleri, güncellemeleri her gün kontrol eder. Otomatik senkronizasyonu beklemeden güncelleme istemek için:

1. Yönetici Konsolu'na gidin, ilgili ChatGPT çalışma alanını seçin ve Eklentiler bölümünü açın.

2. Pazar yerleri bölümünü açın ve pazar yerini seçin.

3. Şimdi senkronize et seçeneğini seçin.

Senkronizasyon, pazar yerine yeni kayıtlar ekleyebilir ve mevcut eklentileri güncelleyebilir. Depodaki değişiklikleri birleştirmeden önce inceleyin; otomatik senkronizasyon, ayrı bir içe aktarma adımı olmadan yeni eklentileri içe aktarabilir.

Senkronizasyon sonuçlarını inceleme

Senkronizasyondan sonra işlemin durumunu ve kaydedilen raporu inceleyin. Tamamlandı — N hata, senkronizasyonun tamamlandığı ancak bazı eklentilerin işlenemediği anlamına gelir.


Mevcut bir eklentiye yönelik güncelleme geçersizse eklentinin son çalışan sürümü korunur. Diğer geçerli güncellemeler yine de tamamlanabilir. Bildirilen sorunu GitHub'da düzeltin, ardından yeniden denemek için Şimdi senkronize et seçeneğini seçin.


Yönetici görünümünüzde tek başına içe aktarılmış bir eklenti için Yenile seçeneği görünüyorsa eklentiyi yenilemek için bu seçeneği kullanın. Eklenti listesini yenile, yalnızca görüntülenen listeyi yeniden yükler; GitHub'dan senkronizasyon yapmaz.

Kaldırma ve silme işlemlerini anlama

Bir kaydı depodan kaldırmak, çalışma alanına aktarılmış kopyasını silmez. Eklenti, Artık kaynakta yok olarak işaretlenir.


ChatGPT'de pazar yerini silmek, bu pazar yerinden içe aktarılan tüm eklentileri siler. GitHub'ı yeniden bağlamak veya sahipliği değiştirmek için pazar yerini silmeyin.

GitHub erişimini yeniden bağlama veya değiştirme

Pazar yeri senkronizasyonu, pazar yerini içe aktaran yöneticinin GitHub bağlantısını kullanır. Bu hesabın pazar yeri deposuna ve referans verilen tüm depolara erişimi devam etmelidir.

İlk kullanılan hesabı yeniden bağlama

1. İçe aktarma için kullanılan GitHub hesabının gerekli tüm depolara hâlâ erişebildiğini doğrulayın.

2. Pazar yerini ilk kez içe aktaran yöneticiden ChatGPT'de GitHub eklentisini açıp hesabını yeniden bağlamasını isteyin.

Yeni bir yöneticiye devretme

Yeni çalışma alanı yöneticisi, kendi GitHub bağlantısını kullanarak aynı pazar yerini içe aktarabilir:

1. Yönetici Konsolu'na gidin, ilgili ChatGPT çalışma alanını seçin ve Eklentiler bölümünü açın. Ardından Ekle > Pazar yerini içe aktar seçeneğini seçin.

2. Mevcut pazar yeri için kullanılan Kaynak, Yol ve Dal, etiket veya commit değerlerinin aynısını girin.

3. Pazar yerini içe aktar seçeneğini seçin ve istendiğinde GitHub erişimine izin verin.

Sonraki senkronizasyonlarda yeni yöneticinin GitHub bağlantısı kullanılır. Yeni yöneticinin hesabı, pazar yeri deposunu ve bu depoda referans verilen tüm depoları okuma yetkisine sahip olmalıdır.

Mevcut bir eklentiyi GitHub yönetimine taşıma

Arşiv olarak yüklenmiş veya henüz bir GitHub kaynağı tarafından yönetilmeyen mevcut bir çalışma alanı eklentisini yönetmek için pazar yeri kullanabilirsiniz. Mevcut eklenti aynı çalışma alanında bulunmalı ve aynı eklenti adına sahip olmalıdır. Farklı bir GitHub kaynağı tarafından yönetilen eklentinin yönetimi bu şekilde devralınamaz.


Pazar yerinizde mevcut eklentiyi belirtmek için:

1. Yönetici Konsolu'na gidin, ilgili ChatGPT çalışma alanını seçin ve Eklentiler bölümünü açın. Eklentiyi açın.

2. URL'sinde /admin/plugins/ bölümünden sonra gelen eklenti kimliğini kopyalayın.

3. Pazar yerinin plugins dizisindeki ilgili kayıtta, name ve source alanlarının yanına bu kimliği pluginId olarak ekleyin. Kimliği eklentinin plugin.json dosyasına eklemeyin.

Eklentinin kimliği, paylaşım ayarları ve çalışma alanı politikaları korunur. Sonraki güncellemelerin kaynağı GitHub olur; bu nedenle daha sonra yüklenen arşivler eklentinin yerini alamaz.


Taşıma örneği ve gereksinimleri için bkz. Eklenti Yönetimi.

Mevcut bir uygulamaya referans ekleme

Bir eklenti, kök dizinindeki .app.json dosyasında mevcut bir uygulamaya referans verebilir. Dosya adının başındaki noktayı ekleyin ve eklenti kimliği yerine uygulamanın kimliğini kullanın. Yerel bir eklenti için .codex-plugin/plugin.json dosyasındaki apps alanını ./.app.json olarak ayarlayın.


Bu referans, uygulama oluşturmaz veya ek izinler vermez. Uygulamanın mevcut çalışma alanı erişimi, kimlik doğrulaması, eylem kontrolleri ve bağlı hizmet izinleri geçerliliğini korur.


JSON biçimi için bkz. Eklenti Yönetimi.

Yalnızca masaüstü etiketini anlama

Yalnızca masaüstü olarak işaretlenmiş bir eklenti, ChatGPT'nin web sürümünde çalışamaz. İçe aktarılan eklentiler, örneğin mcp.json veya .mcp.json dosyasında MCP sunucuları tanımlıyorsa bu etiketi alabilir. Sunucunun uzak bir HTTPS URL'si kullanması da bunu değiştirmez.



.app.json referansı eklemek, tek başına Yalnızca masaüstü etiketini kaldırmaz. Referans verilen her uygulama, üyenin rolüne açık olmalıdır. Uygulamanın normal erişim ve kimlik doğrulama gereksinimleri de geçerliliğini korur.