Kelola plugin untuk organisasi Anda

Pasar plugin memungkinkan pemilik paket Team dan Enterprise untuk mendistribusikan plugin yang dikurasi kepada semua orang di organisasi mereka. Anda membuat pasar, menambahkan plugin ke dalamnya, dan mengontrol dengan tepat plugin mana yang dapat dilihat dan digunakan oleh anggota tim Anda. Plugin yang Anda distribusikan muncul di chat (di web dan tab Chat di Claude Desktop) dan Claude Cowork.

Persyaratan: Cowork dan Skills harus keduanya diaktifkan untuk organisasi Anda sebelum Anda dapat menggunakan pasar plugin.

Anthropic menyediakan pasar plugin bawaan untuk berbagai fungsi, seperti hukum dan keuangan. Pasar Knowledge Work ditambahkan ke organisasi Anda secara default.

Untuk menambahkan pasar yang dibangun Anthropic:

Untuk menghapus pasar Knowledge Work jika tidak relevan dengan tim Anda:

Pasar yang dibangun Anthropic menampilkan nama yang dapat dibaca, seperti "Knowledge Work," bukan slug repositori yang mendasarinya.

Selain pasar yang dibangun Anthropic, Anda dapat membuat pasar Anda sendiri. Ada dua cara untuk menambahkan plugin ke pasar yang Anda buat:

Anda dapat menggunakan kedua pendekatan secara paralel. Misalnya, jalankan pasar yang disinkronkan GitHub untuk plugin inti Anda dan pasar manual terpisah untuk alat ad-hoc.

Jika Anda mengunggah plugin dengan nama yang sama dengan yang sudah ada, itu menimpa versi sebelumnya secara otomatis. Anda tidak perlu menghapus yang lama terlebih dahulu.

Sinkronisasi GitHub memungkinkan Anda mengelola plugin sebagai kode dalam repositori. Ketika Anda mendorong perubahan, Anda dapat memicu sinkronisasi untuk memperbarui pasar Anda, baik secara manual maupun otomatis.

Siapkan repositori Anda

Repositori Anda harus pribadi atau internal—repo publik tidak diizinkan untuk pasar organisasi. Anda dapat menghubungkan repo yang dihosting di github.com atau di host GitHub Enterprise organisasi Anda.

Pasar yang disinkronkan GitHub mendukung set source yang lebih sempit dalam marketplace.json daripada yang dilakukan Claude Code. Jalur relatif ke folder plugin di dalam repositori pasar (misalnya, "source": "./plugins/my-plugin") sepenuhnya didukung, dan merupakan opsi paling sederhana. Jenis sumber github, url, dan git-subdir juga didukung. Jenis sumber npm, archive, dan command tidak didukung.

Sumber plugin dapat bersifat pribadi dalam dua kasus: sumber github.com yang berbagi pemilik repositori pasar Anda, yang sinkronisasi organisasi ambil melalui Aplikasi GitHub Claude, atau sumber di host GitHub Enterprise organisasi Anda dengan Aplikasi GitHub Enterprise organisasi Anda diinstal di repositori itu. Setiap sumber lainnya diambil tanpa kredensial, jadi repositori github.com di bawah pemilik yang berbeda dan repositori di host lain (seperti GitLab atau Bitbucket) harus bersifat publik.

Jika kode plugin Anda berada di repositori pribadi yang tidak memenuhi kriteria di atas, salin folder plugin tersebut ke dalam repositori pasar dan ubah sumber setiap plugin menjadi jalur relatif (subtree git atau langkah CI yang memvendor file berfungsi dengan baik).

Untuk detail tentang struktur dan pemformatan plugin, lihat dokumentasi referensi plugin.

Sumber daya tambahan:

Hubungkan repositori

Token GitHub pribadi Anda diverifikasi untuk mengonfirmasi akses Anda, kemudian Cowork menggunakan token instalasi GitHub App-nya untuk operasi sinkronisasi.

Tidak bisa melihat repositori Anda? Pastikan Claude GitHub App sudah diinstal di repositori tersebut.

Cara sinkronisasi bekerja

Sinkronisasi awal berjalan secara otomatis saat Anda menghubungkan repositori. Setelah itu, pemilik organisasi dapat memilih untuk melanjutkan pembaruan otomatis per marketplace dengan membuka Pengaturan Organisasi > Plugin, mengklik tombol menu di sudut kanan atas marketplace, lalu mengaktifkan "Sinkronisasi otomatis":

Mengaktifkan sinkronisasi otomatis membuat webhook di repositori yang terhubung. Orang yang mengaktifkan toggle harus memiliki akses tingkat admin ke repositori tersebut di GitHub. Ini diperiksa melalui koneksi GitHub pribadi mereka, yang terpisah dari instalasi Claude GitHub App. Tanpa akses admin, halaman menampilkan "Tidak dapat mengakses repositori. Pastikan repositori ada dan Claude GitHub App sudah diinstal," bahkan ketika App sudah diinstal dengan benar dan pembaruan manual berfungsi.

Izin Webhook (Baca & Tulis) Claude GitHub App juga harus disetujui pada instalasi. Pada instalasi yang dibuat sebelum izin ini diperkenalkan, GitHub menampilkan prompt "Claude meminta izin yang diperbarui" yang perlu disetujui oleh admin repositori atau organisasi.

Setelah diaktifkan, sinkronisasi otomatis berjalan saat pull request yang menyertakan bump versi plugin digabungkan ke cabang default repositori. Push langsung ke cabang default tidak memicu sinkronisasi. Anda selalu dapat memicu sinkronisasi secara manual dengan mengklik "Perbarui" di marketplace.

Selama sinkronisasi, Cowork membandingkan commit terbaru di repo Anda dengan commit terakhir yang disinkronkan. Jika tidak ada yang berubah, sinkronisasi dilewati. Jika ada perubahan, Cowork membaca manifest, memvalidasi setiap plugin, dan mengganti semua plugin di marketplace dengan status terkini repo. Sinkronisasi dapat memakan waktu hingga 30 menit tergantung jumlah plugin.

Setelah marketplace Anda memiliki plugin, Anda mengontrol cara distribusinya menggunakan preferensi instalasi. Untuk setiap plugin, Anda dapat menetapkan salah satu dari empat opsi:

Anggota menjelajahi plugin yang tersedia melalui modal Jelajahi plugin. Plugin yang dipasang otomatis muncul di daftar terinstal mereka secara otomatis. Plugin yang tersedia muncul di katalog untuk instalasi layanan mandiri.

Anggota tidak dapat mengedit plugin yang dikelola organisasi, yang mencegah perubahan yang bertentangan pada alat bersama.

Admin Enterprise dapat mengganti preferensi instalasi plugin di seluruh organisasi untuk grup tertentu. Misalnya, Anda dapat memasang otomatis plugin untuk grup Engineering, membuatnya tersedia untuk Legal agar dapat dipasang sendiri, dan menyembunyikannya dari semua orang lain.

Setiap plugin di marketplace Anda memiliki preferensi instalasi di seluruh organisasi (Dipasang secara default, Tersedia untuk dipasang, Diperlukan, atau Tidak tersedia). Secara default, setiap grup mewarisi pengaturan di seluruh organisasi tersebut.

Ketika Anda menetapkan penggantian tingkat grup untuk plugin, itu menggantikan pengaturan di seluruh organisasi untuk anggota grup tersebut. Urutan resolusi adalah: pengaturan grup, kemudian pengaturan di seluruh organisasi, kemudian default marketplace.

Grup yang dibuat secara manual dan grup yang disediakan SCIM dari penyedia identitas Anda muncul di pemilih grup dan bekerja dengan cara yang sama.

Jika anggota termasuk dalam dua atau lebih grup dengan pengaturan berbeda untuk plugin yang sama, pengaturan paling permisif berlaku. Urutan dari paling hingga paling tidak permisif adalah: Diperlukan > Dipasang secara default > Tersedia untuk dipasang > Tidak tersedia.

Misalnya, jika Grup A menetapkan plugin ke "Tidak tersedia" dan Grup B menetapkannya ke "Dipasang secara default," anggota di kedua grup mendapatkan plugin yang dipasang secara default.

Jika grup dihapus (misalnya, dihapus dari penyedia identitas Anda), penggantian tetap ada di UI admin tetapi ditandai sebagai yatim piatu. Ini tidak berpengaruh pada anggota (karena tidak ada yang termasuk dalam grup yang dihapus) dan tidak dihitung menuju lencana akses kustom. Anda dapat menghapus penggantian yatim piatu dari pengaturan akses kustom plugin.

Ya. Penggantian tingkat grup bertahan ketika Anda menyinkronkan ulang marketplace yang terhubung GitHub. Mereka hanya dihapus jika plugin itu sendiri dihapus dari marketplace.

Untuk memperbarui plugin, unggah file ZIP baru dengan nama plugin yang sama. Versi baru menimpa yang sudah ada secara otomatis. Nama plugin adalah pengenal unik, jadi legal akan selalu menggantikan legal.

Untuk menghapus plugin, hapusnya dari marketplace Anda di Pengaturan Organisasi > Plugin.

Dorong perubahan Anda ke repositori yang terhubung, kemudian buka Pengaturan Organisasi > Plugin, temukan marketplace Anda, dan klik "Perbarui" untuk memicu sinkronisasi. Setiap sinkronisasi menggantikan semua plugin dengan status saat ini dari repo. Jika pemilik telah mengaktifkan "Sinkronisasi otomatis" untuk marketplace, sinkronisasi juga berjalan setiap kali permintaan tarik dengan bump versi plugin digabungkan ke cabang default repositori.

Untuk menghapus plugin, hapusnya dari repositori dan picu sinkronisasi.

Nama plugin harus menggunakan kata-kata huruf kecil yang dipisahkan dengan tanda hubung (misalnya, deployment-tools, bukan Deployment Tools). Nama marketplace berikut dicadangkan dan tidak dapat digunakan:

Nama yang menyamar sebagai marketplace resmi Anthropic juga diblokir.

Penyebab umum: file melebihi 50 MB, bukan file ZIP yang valid, atau marketplace telah mencapai batas 100 plugin. Periksa ukuran dan format file, dan hapus plugin yang tidak digunakan jika Anda sudah penuh. Jika pemindaian skill dan plugin aktif, plugin juga dapat ditolak karena ditandai sebagai konten berbahaya. Tinjau alasannya, perbaiki masalahnya, dan unggah plugin lagi.

Periksa preferensi instalasi plugin di pengaturan marketplace Anda. Jika diatur ke Tidak tersedia, anggota tidak akan melihatnya. Juga konfirmasi bahwa Cowork dan Skills keduanya diaktifkan untuk organisasi Anda.

Perubahan berlaku pada sesi berikutnya atau penyegaran plugin setiap anggota. Jika pembaruan masih tidak ditampilkan, konfirmasi unggahan berhasil dengan memeriksa versi plugin di marketplace Anda.

Satu atau lebih plugin di repo Anda kemungkinan diformat dengan tidak benar. Perbaiki masalah pemformatan, dorong pembaruan ke GitHub, dan picu sinkronisasi lagi. Untuk persyaratan struktur plugin, lihat dokumentasi referensi plugin.

Satu atau lebih entri plugin di marketplace.json Anda menggunakan source yang menunjuk di luar repositori yang terhubung (sumber github, url, atau git-subdir), dan sinkronisasi organisasi tidak dapat mengambilnya. Sumber pribadi hanya berfungsi dalam dua kasus: repositori github.com berbagi pemilik repositori marketplace Anda, atau repositori di host GitHub Enterprise organisasi Anda dengan GitHub Enterprise App Anda terinstal di dalamnya.

Untuk sumber pribadi lainnya, pindahkan folder plugin ke repositori marketplace dan ubah source setiap entri ke jalur relatif (misalnya, "./plugins/my-plugin"), kemudian dorong dan sinkronisasi ulang. Atau, unggah plugin yang terpengaruh secara individual melalui Pengaturan Organisasi > Plugin > Tambah plugin > Unggah file, lalu pilih "Tambahkan ke marketplace yang ada." Plugin yang diunggah melalui menu Kustomisasi anggota mereka sendiri hanya diinstal untuk anggota itu dan tidak didistribusikan ke organisasi Anda.

Sinkronisasi GitHub yang gagal dapat sementara menghapus plugin dari marketplace Anda. Perbaiki masalah yang mendasar, sinkronisasi ulang dengan berhasil, kemudian verifikasi bahwa preferensi instalasi diatur dengan benar, karena mungkin telah direset.

Pastikan Claude GitHub App terinstal di repositori itu. Token GitHub pribadi Anda diperiksa terlebih dahulu untuk mengonfirmasi akses, tetapi sinkronisasi itu sendiri menggunakan token instalasi GitHub App.

Jika pembaruan manual berfungsi tetapi mengaktifkan "Sinkronisasi otomatis" menampilkan "Tidak dapat mengakses repositori. Pastikan repositori ada dan Claude GitHub App terinstal," ada dua kemungkinan penyebab: