I marketplace dei plugin consentono ai proprietari dei piani Team ed Enterprise di distribuire plugin curati a tutti gli utenti della loro organizzazione tramite Cowork. Crei un marketplace, aggiungi plugin ad esso e controlli esattamente quali plugin i tuoi membri del team possono vedere e utilizzare.
I proprietari e i proprietari principali dei piani Team ed Enterprise possono gestire i plugin dell'organizzazione su Claude Desktop.
Requisiti: Cowork e Skills devono essere entrambi abilitati per la tua organizzazione prima di poter utilizzare i marketplace dei plugin.
Esistono due modi per aggiungere plugin a un marketplace:
Caricamento manuale—Carica singoli file ZIP di plugin tramite l'interfaccia di amministrazione. Ideale per l'iterazione rapida, strumenti una tantum o team che non utilizzano GitHub per lo sviluppo di plugin.
Sincronizzazione GitHub—Connetti un repository GitHub privato e Cowork sincronizza automaticamente i plugin da esso. Ideale quando più sviluppatori collaborano su plugin o desideri aggiornamenti controllati dalla versione.
Puoi utilizzare entrambi gli approcci in parallelo, ad esempio un marketplace sincronizzato con GitHub per i tuoi plugin principali e un marketplace manuale separato per strumenti ad hoc.
Configurare un marketplace manuale
Apri Claude Desktop e vai a Impostazioni organizzazione > Plugin.
Fai clic su "Aggiungi plugin" e seleziona "Carica un file" come fonte.
Se è la prima volta che configuri un marketplace, "Carica in un nuovo marketplace" sarà selezionato automaticamente.
Potrai scegliere "Aggiungi a un marketplace esistente" quando caricherai plugin in futuro.
Inserisci un nome per il tuo marketplace.
Trascina i tuoi file oppure fai clic sul prompt di caricamento e seleziona il tuo file.
Nota: Il file deve essere un .zip valido inferiore a 50 MB.
Ripeti per ogni plugin che desideri aggiungere.
Fai clic su "Carica" per aggiungere i tuoi plugin a un nuovo marketplace.
Se carichi un plugin con lo stesso nome di uno esistente, sovrascrive automaticamente la versione precedente, senza necessità di eliminare prima quella vecchia.
Configurare un marketplace sincronizzato con GitHub
La sincronizzazione GitHub ti consente di gestire i plugin come codice in un repository. Quando esegui il push delle modifiche, puoi attivare una sincronizzazione per aggiornare il tuo marketplace.
Preparare il repository
Il tuo repository deve essere privato o interno—i repository pubblici non sono consentiti per i marketplace dell'organizzazione. I repository ospitati su istanze personalizzate di GitHub Enterprise Server non sono supportati. Il tuo repository deve essere ospitato su github.com.
Per i dettagli sulla struttura e la formattazione dei plugin, consulta la documentazione di riferimento dei plugin.
Risorse aggiuntive:
Connettere il repository
Assicurati che sia Cowork che Skills siano abilitati per la tua organizzazione.
Vai a Impostazioni organizzazione > Plugin.
Fai clic su "Aggiungi plugin" e seleziona "GitHub" come fonte.
Inserisci il repository nel formato
proprietario/repository(ad esempio,acme-corp/claude-plugins).
Il tuo token GitHub personale viene verificato per confermare che hai accesso, quindi Cowork utilizza il token di installazione dell'app GitHub per le operazioni di sincronizzazione.
Non riesci a vedere il tuo repository? Assicurati che l'app GitHub di Cowork sia installata in quel repository.
Come funziona la sincronizzazione
Una sincronizzazione iniziale viene eseguita automaticamente quando connetti un repository. Successivamente, puoi attivare le sincronizzazioni manualmente facendo clic su "Verifica aggiornamenti" sul tuo marketplace in Impostazioni organizzazione > Plugin.
Durante una sincronizzazione, Cowork confronta il commit più recente nel tuo repository con il commit sincronizzato per ultimo. Se non è cambiato nulla, la sincronizzazione viene saltata. Se ci sono modifiche, Cowork legge il manifest, convalida ogni plugin e sostituisce tutti i plugin nel marketplace con lo stato attuale del repository. Le sincronizzazioni possono richiedere fino a 30 minuti a seconda del numero di plugin.
Importante: Se una sincronizzazione non riesce, i plugin potrebbero essere temporaneamente rimossi per i tuoi membri del team. Se ciò accade, controlla il messaggio di errore, correggi il problema nel tuo repository, esegui il push dell'aggiornamento e attiva di nuovo la sincronizzazione. Una volta che la sincronizzazione ha esito positivo, verifica che le tue preferenze di installazione siano ancora impostate correttamente, poiché potrebbero essere state ripristinate durante l'errore.
Controllare la distribuzione dei plugin
Una volta che il tuo marketplace ha plugin, controlli come vengono distribuiti utilizzando le preferenze di installazione. Per ogni plugin, puoi impostare una di tre opzioni:
Preferenza
|
Cosa fa
|
Cosa vedono i membri
|
Installazione automatica
|
Installato automaticamente per tutti i membri dell'organizzazione
|
Il plugin appare nel loro elenco installato senza alcuna azione. I membri possono disinstallarlo se lo desiderano.
|
Disponibile
|
Elencato nel catalogo dei plugin
|
I membri lo vedono quando sfogliano i plugin e possono installarlo da soli.
|
Non disponibile
|
Nascosto dal catalogo completamente
|
I membri non possono vedere o installare il plugin. Utile per la gestione temporanea o l'obsolescenza dei plugin.
|
Impostare le preferenze
In Impostazioni organizzazione > Plugin, accedi al tuo marketplace.
Seleziona la preferenza di installazione per ogni plugin.
Le modifiche hanno effetto nella sessione successiva di ogni membro o nell'aggiornamento del plugin.
Cosa sperimentano i membri
I membri sfogliano i plugin disponibili tramite la finestra modale Sfoglia plugin in Cowork. I plugin installati automaticamente appaiono nel loro elenco installato automaticamente. I plugin disponibili vengono visualizzati nel catalogo per l'installazione self-service.
I membri non possono modificare i plugin gestiti dall'organizzazione, il che impedisce modifiche conflittuali agli strumenti condivisi.
Aggiornare e rimuovere plugin
Marketplace manuali
Per aggiornare un plugin, carica un nuovo file ZIP con lo stesso nome del plugin. La nuova versione sovrascrive automaticamente quella esistente. I nomi dei plugin sono l'identificatore univoco—legal sostituirà sempre legal.
Per rimuovere un plugin, eliminalo dal tuo marketplace in Impostazioni organizzazione > Plugin.
Marketplace sincronizzati con GitHub
Esegui il push delle tue modifiche al repository connesso, quindi vai a Impostazioni organizzazione > Plugin, trova il tuo marketplace e fai clic su "Verifica aggiornamenti" per attivare una sincronizzazione. Ogni sincronizzazione sostituisce tutti i plugin con lo stato attuale del repository.
Per rimuovere un plugin, eliminalo dal repository e attiva una sincronizzazione.
Limiti
Limite
|
Valore
|
Note
|
Dimensione massima ZIP del plugin (caricamento)
|
50 MB
|
Applicato sia lato client che lato server
|
Massimo plugin per marketplace (manuale)
|
100
|
Per marketplace
|
Massimo plugin per marketplace (sincronizzazione GitHub)
|
500
|
Per marketplace
|
Lunghezza massima del nome del plugin
|
64 caratteri
|
Deve utilizzare parole minuscole separate da trattini
|
Timeout di sincronizzazione
|
30 minuti
|
Per operazione di sincronizzazione
|
Visibilità del repository GitHub
|
Solo privato o interno
|
Deve essere ospitato su github.com. I repository pubblici e le istanze di GitHub Enterprise Server non sono supportati.
|
Regole di denominazione
I nomi dei plugin devono utilizzare parole minuscole separate da trattini (ad esempio, deployment-tools, non Deployment Tools). I seguenti nomi di marketplace sono riservati e non possono essere utilizzati:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Anche i nomi che impersonano i marketplace ufficiali di Anthropic sono bloccati.
Scegliere tra caricamento manuale e sincronizzazione GitHub
Scenario
|
Approccio consigliato
|
I plugin sono mantenuti nel controllo della versione con CI/CD
|
Sincronizzazione GitHub
|
Più sviluppatori collaborano sui plugin
|
Sincronizzazione GitHub
|
Desideri la propagazione automatica degli aggiornamenti
|
Sincronizzazione GitHub
|
Hai bisogno di più di 100 plugin in un marketplace
|
Sincronizzazione GitHub
|
Prototipazione rapida o strumenti una tantum
|
Caricamento manuale
|
Plugin creati da team non tecnici
|
Caricamento manuale
|
Ambienti senza accesso a GitHub
|
Caricamento manuale
|
Test di un plugin prima di aggiungerlo a un repository sincronizzato
|
Caricamento manuale
|
Risoluzione dei problemi
Caricamento rifiutato
Cause comuni: il file supera 50 MB, non è un file ZIP valido o il marketplace ha raggiunto il limite di 100 plugin. Controlla la dimensione e il formato del file e rimuovi i plugin inutilizzati se sei al limite di capacità.
Plugin non visualizzato per i membri
Controlla la preferenza di installazione del plugin nelle impostazioni del tuo marketplace. Se è impostata su Non disponibile, i membri non lo vedranno. Inoltre, conferma che sia Cowork che Skills siano entrambi abilitati per la tua organizzazione.
Plugin aggiornato non riflesso per i membri
Le modifiche hanno effetto nella sessione successiva di ogni membro o nell'aggiornamento del plugin. Se l'aggiornamento non viene ancora visualizzato, conferma che il caricamento sia riuscito controllando la versione del plugin nel tuo marketplace.
La sincronizzazione GitHub non riesce con un errore di contenuto
Uno o più plugin nel tuo repository probabilmente sono formattati in modo non corretto. Correggi il problema di formattazione, esegui il push dell'aggiornamento su GitHub e attiva di nuovo la sincronizzazione. Per i requisiti di struttura dei plugin, consulta la documentazione di riferimento dei plugin.
I plugin sono scomparsi dopo una sincronizzazione non riuscita
Una sincronizzazione GitHub non riuscita può rimuovere temporaneamente i plugin dal tuo marketplace. Correggi il problema sottostante, risincronizza con successo, quindi verifica che le preferenze di installazione siano impostate correttamente, poiché potrebbero essere state ripristinate.
Impossibile visualizzare un repository GitHub durante la connessione
Assicurati che l'app GitHub di Cowork sia installata in quel repository. Il tuo token GitHub personale viene controllato per primo per confermare l'accesso, ma la sincronizzazione stessa utilizza il token di installazione dell'app GitHub.
