Vai al contenuto principale

Gestisci i plugin Cowork per la tua organizzazione

Aggiornato oggi

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

  1. Apri Claude Desktop e vai a Impostazioni organizzazione > Plugin.

  2. Fai clic su "Aggiungi plugin" e seleziona "Carica un file" come fonte.

  3. Se è la prima volta che configuri un marketplace, "Carica in un nuovo marketplace" sarà selezionato automaticamente.

    1. Potrai scegliere "Aggiungi a un marketplace esistente" quando caricherai plugin in futuro.

  4. Inserisci un nome per il tuo marketplace.

  5. Trascina i tuoi file oppure fai clic sul prompt di caricamento e seleziona il tuo file.

    1. Nota: Il file deve essere un .zip valido inferiore a 50 MB.

  6. Ripeti per ogni plugin che desideri aggiungere.

  7. 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

  1. Assicurati che sia Cowork che Skills siano abilitati per la tua organizzazione.

  2. Vai a Impostazioni organizzazione > Plugin.

  3. Fai clic su "Aggiungi plugin" e seleziona "GitHub" come fonte.

  4. 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

  1. In Impostazioni organizzazione > Plugin, accedi al tuo marketplace.

  2. Seleziona la preferenza di installazione per ogni plugin.

  3. 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-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-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.

Hai ricevuto la risposta alla tua domanda?