Gestisci i plugin per la tua organizzazione

I marketplace dei plugin consentono ai proprietari dei piani Team ed Enterprise di distribuire plugin curati a tutti gli utenti della loro organizzazione. Crei un marketplace, aggiungi plugin ad esso e controlli esattamente quali plugin i tuoi colleghi possono vedere e utilizzare. I plugin che distribuisci vengono visualizzati sia nella chat (sul web e nella scheda Chat in Claude Desktop) che in Claude Cowork.

Requisiti: Cowork e Skills devono essere entrambi abilitati per la tua organizzazione prima di poter utilizzare i marketplace dei plugin.

Anthropic fornisce marketplace integrati di plugin per diverse funzioni, come legale e finanza. Un marketplace Knowledge Work viene aggiunto alla tua organizzazione per impostazione predefinita.

Per aggiungere un marketplace creato da Anthropic:

Per rimuovere il marketplace Knowledge Work se non è rilevante per i tuoi team:

I marketplace creati da Anthropic mostrano nomi leggibili, come "Knowledge Work", invece dello slug del repository sottostante.

Oltre ai marketplace creati da Anthropic, puoi crearne uno tuo. Esistono due modi per aggiungere plugin a un marketplace che crei:

Puoi utilizzare entrambi gli approcci in parallelo. Ad esempio, esegui un marketplace sincronizzato con GitHub per i tuoi plugin principali e un marketplace manuale separato per strumenti ad hoc.

Se carichi un plugin con lo stesso nome di uno esistente, sovrascrive automaticamente la versione precedente. Non è necessario eliminare prima quello vecchio.

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, manualmente o automaticamente.

Prepara il tuo repository

Il tuo repository deve essere privato o interno: i repository pubblici non sono consentiti per i marketplace dell'organizzazione. Puoi connettere un repository ospitato su github.com o sull'host GitHub Enterprise della tua organizzazione.

I marketplace sincronizzati con GitHub supportano un set più ristretto di tipi di source in marketplace.json rispetto a Claude Code. I percorsi relativi alle cartelle dei plugin all'interno del repository del marketplace (ad esempio, "source": "./plugins/my-plugin") sono completamente supportati e rappresentano l'opzione più semplice. Sono supportati anche i tipi di source github, url e git-subdir. I tipi di source npm, archive e command non sono supportati.

Un'origine plugin può essere privata in due casi: un'origine github.com che condivide il proprietario del repository del tuo marketplace, che la sincronizzazione dell'organizzazione recupera tramite l'app GitHub di Claude, oppure un'origine sull'host GitHub Enterprise della tua organizzazione con l'app GitHub Enterprise della tua organizzazione installata su quel repository. Ogni altra origine viene recuperata senza credenziali, quindi i repository github.com sotto un proprietario diverso e i repository su altri host (come GitLab o Bitbucket) devono essere pubblici.

Se il codice del tuo plugin si trova in un repository privato che non soddisfa i criteri di cui sopra, copia quelle cartelle dei plugin nel repository del marketplace e modifica l'origine di ogni plugin in un percorso relativo (un git subtree o un passaggio CI che fornisce i file funziona bene).

Per i dettagli sulla struttura e la formattazione dei plugin, consulta la documentazione di riferimento dei plugin.

Risorse aggiuntive:

Connetti il repository

Il tuo token GitHub personale viene verificato per confermare che hai accesso, quindi Cowork utilizza il token dell'app GitHub per le operazioni di sincronizzazione.

Non riesci a vedere il tuo repository? Assicurati che l'app Claude GitHub sia installata in quel repository.

Come funziona la sincronizzazione

Una sincronizzazione iniziale viene eseguita automaticamente quando colleghi un repository. Successivamente, i proprietari dell'organizzazione possono scegliere di attivare gli aggiornamenti automatici continui per ogni marketplace accedendo a Impostazioni organizzazione > Plugin, facendo clic sul pulsante menu nell'angolo in alto a destra del marketplace, quindi attivando "Sincronizza automaticamente":

L'abilitazione della sincronizzazione automatica crea un webhook nel repository collegato. La persona che attiva l'interruttore deve avere accesso a livello di amministratore a quel repository su GitHub. Questo viene verificato tramite la loro connessione GitHub personale, che è separata dall'installazione dell'app Claude GitHub. Senza accesso amministratore, la pagina mostra "Impossibile accedere al repository. Assicurati che il repository esista e che l'app Claude GitHub sia installata," anche quando l'app è installata correttamente e gli aggiornamenti manuali funzionano.

Il permesso Webhook (Lettura e Scrittura) dell'app Claude GitHub deve essere approvato anche nell'installazione. Nelle installazioni create prima dell'introduzione di questo permesso, GitHub mostra un prompt "Claude sta richiedendo autorizzazioni aggiornate" che un amministratore del repository o dell'organizzazione deve approvare.

Una volta abilitata, la sincronizzazione automatica viene eseguita quando una pull request che include un aggiornamento della versione del plugin viene unita al ramo predefinito del repository. I push diretti al ramo predefinito non attivano una sincronizzazione. Puoi sempre attivare una sincronizzazione manualmente facendo clic su "Aggiorna" nel marketplace.

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.

Una volta che il tuo marketplace ha plugin, controlli come vengono distribuiti utilizzando le preferenze di installazione. Per ogni plugin, puoi impostare una di quattro opzioni:

I membri sfogliano i plugin disponibili tramite la finestra modale Sfoglia plugin. I plugin installati automaticamente vengono visualizzati nel loro elenco di installazioni 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.

Gli amministratori Enterprise possono ignorare la preferenza di installazione a livello di organizzazione di un plugin per gruppi specifici. Ad esempio, puoi installare automaticamente un plugin per il gruppo Engineering, renderlo disponibile per Legal per l'installazione autonoma e nasconderlo a tutti gli altri.

Ogni plugin nel tuo marketplace ha una preferenza di installazione a livello di organizzazione (Installato per impostazione predefinita, Disponibile per l'installazione, Obbligatorio o Non disponibile). Per impostazione predefinita, ogni gruppo eredita tale impostazione a livello di organizzazione.

Quando imposti un override a livello di gruppo per un plugin, sostituisce l'impostazione a livello di organizzazione per i membri di quel gruppo. L'ordine di risoluzione è: impostazione del gruppo, quindi impostazione a livello di organizzazione, quindi impostazione predefinita del marketplace.

Sia i gruppi creati manualmente che i gruppi forniti da SCIM dal tuo provider di identità vengono visualizzati nel selettore di gruppi e funzionano allo stesso modo.

Se un membro appartiene a due o più gruppi con impostazioni diverse per lo stesso plugin, si applica l'impostazione più permissiva. L'ordine da più a meno permissivo è: Obbligatorio > Installato per impostazione predefinita > Disponibile per l'installazione > Non disponibile.

Ad esempio, se il Gruppo A imposta un plugin su "Non disponibile" e il Gruppo B lo imposta su "Installato per impostazione predefinita", un membro in entrambi i gruppi ottiene il plugin installato per impostazione predefinita.

Se un gruppo viene rimosso (ad esempio, eliminato dal tuo provider di identità), l'override rimane nell'interfaccia utente di amministrazione ma è contrassegnato come orfano. Non ha alcun effetto sui membri (poiché nessuno appartiene a un gruppo eliminato) e non conta verso il badge di accesso personalizzato. Puoi cancellare gli override orfani dalle impostazioni di accesso personalizzato del plugin.

Sì. Gli override a livello di gruppo persistono quando risincronizzi un marketplace connesso a GitHub. Vengono rimossi solo se il plugin stesso viene eliminato dal marketplace.

Per aggiornare un plugin, carica un nuovo file ZIP con lo stesso nome di plugin. La nuova versione sovrascrive automaticamente quella esistente. I nomi dei plugin sono l'identificatore univoco, quindi legal sostituirà sempre legal.

Per rimuovere un plugin, eliminalo dal tuo marketplace in Impostazioni organizzazione > Plugin.

Invia le tue modifiche al repository connesso, quindi vai a Impostazioni organizzazione > Plugin, trova il tuo marketplace e fai clic su "Aggiorna" per attivare una sincronizzazione. Ogni sincronizzazione sostituisce tutti i plugin con lo stato attuale del repository. Se un proprietario ha abilitato "Sincronizza automaticamente" per il marketplace, una sincronizzazione viene eseguita anche ogni volta che una pull request con un bump di versione del plugin viene unita al ramo predefinito del repository.

Per rimuovere un plugin, eliminalo dal repository e attiva una sincronizzazione.

I nomi dei plugin devono usare parole minuscole separate da trattini (ad esempio, deployment-tools, non Deployment Tools). I seguenti nomi del marketplace sono riservati e non possono essere utilizzati:

Sono bloccati anche i nomi che si fingono marketplace ufficiali di Anthropic.

Cause comuni: il file supera 50 MB, non è un file ZIP valido, oppure il marketplace ha raggiunto il limite di 100 plugin. Controlla le dimensioni e il formato del file e rimuovi i plugin inutilizzati se sei al limite. Se la scansione di skill e plugin è attiva, un plugin può essere rifiutato anche perché è stato segnalato per contenuto dannoso. Rivedi il motivo, risolvi il problema e carica di nuovo il plugin.

Controlla la preferenza di installazione del plugin nelle impostazioni del marketplace. Se è impostata su Non disponibile, i membri non lo vedranno. Inoltre, conferma che Cowork e Skills siano entrambi abilitati per la tua organizzazione.

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.

Uno o più plugin nel tuo repository probabilmente non sono formattati correttamente. Correggi il problema di formattazione, esegui il push dell'aggiornamento su GitHub e attiva di nuovo la sincronizzazione. Per i requisiti della struttura del plugin, consulta la documentazione di riferimento del plugin.

Uno o più voci di plugin nel tuo marketplace.json utilizzano una source che punta al di fuori del repository connesso (una source github, url, o git-subdir), e la sincronizzazione dell'organizzazione non può recuperarla. Una source privata funziona solo in due casi: un repository github.com condivide il proprietario del tuo repository del marketplace, oppure un repository sul tuo host GitHub Enterprise dell'organizzazione con la tua GitHub Enterprise App installata su di esso.

Per qualsiasi altra source privata, sposta le cartelle dei plugin nel repository del marketplace e cambia la source di ogni voce in un percorso relativo (ad esempio, "./plugins/my-plugin"), quindi esegui il push e risincronizza. In alternativa, carica i plugin interessati singolarmente tramite Impostazioni organizzazione > Plugin > Aggiungi plugin > Carica un file, quindi seleziona "Aggiungi a un marketplace esistente." I plugin caricati tramite il menu Personalizza di un membro vengono installati solo per quel membro e non vengono distribuiti alla tua organizzazione.

Una sincronizzazione GitHub non riuscita può rimuovere temporaneamente i plugin dal tuo marketplace. Risolvi il problema sottostante, risincronizza con successo, quindi verifica che le preferenze di installazione siano impostate correttamente, poiché potrebbero essere state ripristinate.

Assicurati che la Claude GitHub App 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 della GitHub App.

Se gli aggiornamenti manuali funzionano ma l'attivazione di "Sync automatically" mostra "Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed," ci sono due probabili cause: