Ringkasan

Admin workspace dapat mengimpor marketplace plugin dari GitHub ke direktori workspace mereka. Marketplace adalah katalog JSON yang berisi daftar plugin untuk diimpor. Setelah impor, sinkronisasi harian menjaga plugin tetap mutakhir sesuai perubahan di repositori.


Sinkronisasi marketplace mengimpor konten plugin—bukan menghubungkan akun anggota workspace atau memberikan akses ke aplikasi yang disertakan dalam plugin.


Untuk pengenalan tentang plugin dan aplikasi yang disertakan, lihat: Plugin di ChatGPT dan Codex.

Sebelum memulai

• Gunakan akun GitHub yang memiliki akses baca ke repositori marketplace dan setiap repositori lain yang dirujuknya. Repositori publik dan privat di github.com didukung.

• Selesaikan proses persetujuan organisasi GitHub yang diperlukan agar akun pengimpor dapat mengakses repositori tersebut.

• Tinjau konten repositori. Impor memproses semua plugin yang valid tanpa langkah persetujuan terpisah untuk masing-masing plugin, dan sinkronisasi berikutnya dapat menambahkan plugin baru.

Plugin baru menggunakan kebijakan instalasi Tersedia dan autentikasi saat instalasi sebagai pengaturan awal. Sinkronisasi harian otomatis diaktifkan untuk marketplace baru. Setelah impor, tinjau pengaturan workspace dan aplikasi yang diperlukan untuk setiap plugin.

Mengimpor marketplace

1. Buka Konsol Admin, pilih workspace ChatGPT yang dituju, lalu buka Plugin. Lalu pilih Tambah dan pilih Impor marketplace.

2. Di Sumber, masukkan URL repositori, seperti https://github.com/example/team-plugins. Gunakan hanya URL repositori, bukan URL branch atau folder.

3. Jika marketplace berada di subdirektori, masukkan direktori tersebut di Jalur. Misalnya, masukkan team-tools untuk team-tools/.agents/plugins/marketplace.json. Biarkan Jalur kosong untuk direktori akar repositori. Jangan masukkan nama file manifes.

4. Jika perlu, masukkan Branch, tag, atau commit. Biarkan kosong untuk menggunakan branch default repositori. Gunakan branch untuk menerima commit berikutnya. Jika menggunakan commit tertentu, versi akan tetap pada revisi tersebut.

5. Pilih Impor marketplace dan berikan izin akses GitHub saat diminta.

6. Tinjau Hasil impor, lalu buka setiap plugin yang diimpor untuk mengonfigurasi kebijakan instalasi dan aplikasi yang diperlukan.

Impor awal dapat memakan waktu hingga 1 jam untuk marketplace yang sangat besar. Sinkronisasi harian berikutnya biasanya memakan waktu beberapa menit.

Jika plugin tidak dapat diimpor, laporan akan menjelaskan kesalahannya. Plugin lain yang valid tetap dapat diimpor.

Format yang didukung

Direktori yang dipilih harus berisi manifes yang didukung:

• .agents/plugins/marketplace.json untuk marketplace Codex.

• .claude-plugin/marketplace.json untuk marketplace yang kompatibel dengan Claude.

• .claude-plugin/plugin.json untuk plugin Claude mandiri jika tidak ada manifes marketplace.

Entri marketplace dapat merujuk ke folder plugin di repositori yang sama atau sumber repositori GitHub yang didukung. Layanan hosting Git lain dan sumber registri paket, seperti npm, tidak didukung untuk impor ke workspace.

Untuk format yang didukung, contoh JSON, dan kolom sumber, lihat: Pengelolaan Plugin.

Mengonfigurasi akses workspace

GitHub menyediakan konten plugin, sedangkan pengaturan workspace mengontrol instalasi dan autentikasi. Impor dan sinkronisasi tidak menerapkan nilai kebijakan repositori, seperti AVAILABLE atau ON_USE. Konfigurasikan pengaturan ini untuk setiap plugin di workspace Anda.


Gunakan Kebijakan instalasi untuk memilih Tersedia atau Terinstal bagi setiap peran yang memenuhi syarat. Aplikasi yang diperlukan juga harus diaktifkan, dan anggota harus memiliki akses ke layanan terhubung serta menyelesaikan autentikasi yang diperlukan.


Sinkronisasi pembaruan plugin atau pengalihan pengelolaan plugin yang sudah ada ke GitHub tetap mempertahankan kebijakan workspace-nya. Mengimpor plugin tidak memberikan akses aplikasi atau menghubungkan akun anggota.


Untuk navigasi workspace, akses aplikasi, dan kontrol workspace, lihat: Kontrol admin, keamanan, dan kepatuhan untuk plugin dan aplikasi.

Menjaga plugin tetap mutakhir

Marketplace baru memeriksa pembaruan setiap hari. Untuk meminta pembaruan tanpa menunggu sinkronisasi otomatis:

1. Buka Konsol Admin, pilih workspace ChatGPT yang dituju, lalu buka Plugin.

2. Buka Marketplace dan pilih marketplace yang dimaksud.

3. Pilih Sinkronkan sekarang.

Sinkronisasi dapat menambahkan entri marketplace baru dan memperbarui plugin yang sudah ada. Tinjau perubahan repositori sebelum menggabungkannya, karena sinkronisasi otomatis dapat mengimpor plugin baru tanpa langkah impor tambahan.

Meninjau hasil sinkronisasi

Setelah sinkronisasi, tinjau status dan laporan yang tersimpan. Selesai — N kesalahan berarti sinkronisasi telah selesai, tetapi beberapa plugin tidak dapat diproses.


Jika pembaruan untuk plugin yang sudah ada tidak valid, versi terakhirnya yang berfungsi akan dipertahankan. Pembaruan lain yang valid tetap dapat diselesaikan. Perbaiki masalah yang dilaporkan di GitHub, lalu pilih Sinkronkan sekarang untuk mencoba lagi.


Jika tampilan admin Anda menampilkan Segarkan untuk plugin yang diimpor secara terpisah, gunakan opsi tersebut untuk menyegarkan plugin itu. Segarkan daftar plugin hanya memuat ulang daftar yang ditampilkan, bukan menyinkronkannya dari GitHub.

Memahami dampak penghapusan entri dan marketplace

Menghapus entri dari repositori tidak menghapus salinannya yang telah diimpor ke workspace. Plugin akan ditandai sebagai Tidak lagi ada di sumber.


Menghapus marketplace di ChatGPT akan menghapus semua plugin yang diimpor darinya. Jangan hapus marketplace untuk menghubungkan kembali GitHub atau mengubah kepemilikan.

Menghubungkan kembali atau mengubah akses GitHub

Sinkronisasi marketplace menggunakan koneksi GitHub milik admin yang mengimpornya. Akun tersebut harus tetap memiliki akses ke repositori marketplace dan semua repositori yang dirujuk.

Menghubungkan kembali akun awal

1. Pastikan akun GitHub yang digunakan untuk impor masih memiliki akses ke semua repositori yang diperlukan.

2. Minta admin yang awalnya mengimpor marketplace untuk membuka plugin GitHub di ChatGPT dan menghubungkan kembali akunnya.

Mengalihkan ke admin baru

Admin workspace yang baru dapat mengimpor marketplace yang sama menggunakan koneksi GitHub miliknya sendiri:

1. Buka Konsol Admin, pilih workspace ChatGPT yang dituju, lalu buka Plugin. Lalu pilih Tambah > Impor marketplace.

2. Masukkan nilai Sumber, Jalur, dan Branch, tag, atau commit yang sama dengan yang digunakan untuk marketplace yang sudah ada.

3. Pilih Impor marketplace dan berikan izin akses GitHub saat diminta.

Sinkronisasi berikutnya menggunakan koneksi GitHub milik admin baru. Akun admin baru harus memiliki akses baca ke repositori marketplace dan setiap repositori yang dirujuknya.

Mengalihkan pengelolaan plugin yang sudah ada ke GitHub

Anda dapat menggunakan marketplace untuk mengelola plugin workspace yang sudah ada, yang diunggah sebagai arsip atau belum dikelola melalui sumber GitHub. Plugin yang sudah ada harus berada di workspace yang sama dan memiliki nama plugin yang sama. Plugin yang dikelola melalui sumber GitHub lain tidak dapat diambil alih dengan cara ini.


Untuk mengidentifikasi plugin yang sudah ada di marketplace Anda:

1. Buka Konsol Admin, pilih workspace ChatGPT yang dituju, lalu buka Plugin. Buka plugin tersebut.

2. Salin ID plugin setelah /admin/plugins/ di URL-nya.

3. Tambahkan ID tersebut sebagai pluginId di samping name dan source pada entri yang sesuai dalam array plugins marketplace. Jangan tambahkan ID tersebut ke file plugin.json milik plugin.

ID, pengaturan berbagi, dan kebijakan workspace plugin tetap dipertahankan. GitHub menjadi sumber pembaruan selanjutnya, sehingga unggahan arsip berikutnya tidak dapat menggantikan plugin tersebut.


Untuk contoh dan persyaratan migrasi, lihat: Pengelolaan Plugin.

Merujuk ke aplikasi yang sudah ada

Plugin dapat merujuk ke aplikasi yang sudah ada melalui .app.json di direktori akar plugin. Sertakan titik di awal nama file, dan gunakan ID aplikasi, bukan ID plugin. Untuk plugin native, atur kolom apps di .codex-plugin/plugin.json ke ./.app.json.


Referensi ini tidak membuat aplikasi atau memberikan izin tambahan. Akses workspace, autentikasi, kontrol tindakan, dan izin layanan terhubung yang sudah ditetapkan untuk aplikasi tersebut tetap berlaku.


Untuk format JSON, lihat: Pengelolaan Plugin.

Memahami label Hanya desktop

Plugin berlabel Hanya desktop tidak dapat dijalankan di ChatGPT versi web. Plugin yang diimpor dapat diberi label ini jika mendeklarasikan server MCP, misalnya di mcp.json atau .mcp.json, meskipun server tersebut menggunakan URL HTTPS jarak jauh.


Menambahkan referensi .app.json saja tidak menghapus label Hanya desktop. Setiap aplikasi yang dirujuk tetap harus tersedia bagi peran anggota, dan persyaratan akses serta autentikasi yang biasa berlaku untuk aplikasi tersebut tetap berlaku.