Panoramica

Gli amministratori dell'area di lavoro possono importare un marketplace di plugin da GitHub nel catalogo della propria area di lavoro. Un marketplace è un catalogo JSON che elenca i plugin da importare. Dopo l'importazione, la sincronizzazione giornaliera mantiene i plugin aggiornati con le modifiche del repository.


La sincronizzazione del marketplace importa i contenuti dei plugin, ma non collega gli account dei membri dell'area di lavoro né concede l'accesso alle app incluse in un plugin.


Per un'introduzione ai plugin e alle app incluse, consulta: Plugin in ChatGPT e Codex.

Prima di iniziare

• Usa un account GitHub con accesso in lettura al repository del marketplace e a ogni altro repository a cui fa riferimento. Sono supportati i repository pubblici e privati su github.com.

• Completa le eventuali procedure di approvazione dell'organizzazione GitHub necessarie affinché l'account usato per l'importazione possa accedere a tali repository.

• Esamina i contenuti del repository. L'importazione elabora tutti i plugin validi senza un passaggio di approvazione separato per ciascuno e le sincronizzazioni future possono aggiungere nuovi plugin.

I nuovi plugin hanno inizialmente il criterio di installazione impostato su Disponibile e richiedono l'autenticazione al momento dell'installazione. Nei nuovi marketplace la sincronizzazione automatica giornaliera è abilitata. Dopo l'importazione, esamina le impostazioni dell'area di lavoro e le app richieste per ogni plugin.

Importare un marketplace

1. Vai alla Console di amministrazione, seleziona l'area di lavoro ChatGPT desiderata e apri Plugin. Quindi seleziona Aggiungi e scegli Importa marketplace.

2. In Origine, inserisci l'URL del repository, ad esempio https://github.com/example/team-plugins. Usa solo l'URL del repository, senza l'URL di un branch o di una cartella.

3. Se il marketplace si trova in una sottodirectory, inserisci tale directory in Percorso. Ad esempio, inserisci team-tools per team-tools/.agents/plugins/marketplace.json. Lascia vuoto Percorso per usare la directory principale del repository. Non inserire il nome del file manifesto.

4. Se vuoi, compila il campo Branch, tag o commit. Lascialo vuoto per usare il branch predefinito del repository. Usa un branch per ricevere i commit futuri. Se specifichi un commit, la revisione resta fissa.

5. Seleziona Importa marketplace e autorizza l'accesso a GitHub quando richiesto.

6. Esamina i Risultati dell'importazione, quindi apri ogni plugin importato per configurarne il criterio di installazione e le eventuali app richieste.

Per marketplace molto grandi, l'importazione iniziale può richiedere fino a 1 ora. Le successive sincronizzazioni giornaliere richiedono in genere pochi minuti.

Se non è possibile importare un plugin, il report spiega l'errore. Gli altri plugin validi possono comunque essere importati.

Formati supportati

La directory selezionata deve contenere un manifesto supportato:

• .agents/plugins/marketplace.json per un marketplace Codex.

• .claude-plugin/marketplace.json per un marketplace compatibile con Claude.

• .claude-plugin/plugin.json per un plugin Claude autonomo quando non è presente un manifesto del marketplace.

Le voci del marketplace possono fare riferimento a cartelle di plugin nello stesso repository o a origini supportate su repository GitHub. L'importazione nell'area di lavoro non supporta altri servizi di hosting Git né origini su registri di pacchetti, come npm.

Per i formati supportati, gli esempi JSON e i campi relativi all'origine, consulta: Gestione dei plugin.

Configurare l'accesso nell'area di lavoro

GitHub fornisce i contenuti dei plugin, mentre le impostazioni dell'area di lavoro controllano l'installazione e l'autenticazione. L'importazione e la sincronizzazione non applicano i valori dei criteri del repository, come AVAILABLE o ON_USE. Configura queste impostazioni per ogni plugin nella tua area di lavoro.


Usa Criterio di installazione per scegliere Disponibile o Installato per ogni ruolo idoneo. Anche le app richieste devono essere abilitate e i membri devono avere accesso al servizio collegato e completare l'eventuale autenticazione richiesta.


La sincronizzazione di un aggiornamento del plugin o il passaggio di un plugin esistente alla gestione tramite GitHub ne mantiene i criteri dell'area di lavoro. L'importazione di un plugin non concede l'accesso alle app né collega gli account dei membri.


Per informazioni sulla navigazione nell'area di lavoro, sull'accesso alle app e sui controlli dell'area di lavoro, consulta: Controlli amministrativi, sicurezza e conformità per plugin e app.

Mantenere aggiornati i plugin

I nuovi marketplace verificano ogni giorno la disponibilità di aggiornamenti. Per richiedere un aggiornamento senza attendere la sincronizzazione automatica:

1. Vai alla Console di amministrazione, seleziona l'area di lavoro ChatGPT desiderata e apri Plugin.

2. Apri Marketplace e seleziona il marketplace.

3. Seleziona Sincronizza ora.

La sincronizzazione può aggiungere nuove voci del marketplace e aggiornare i plugin esistenti. Esamina le modifiche al repository prima di unirle, perché la sincronizzazione automatica può importare nuovi plugin senza un ulteriore passaggio di importazione.

Esaminare i risultati della sincronizzazione

Dopo una sincronizzazione, esaminane lo stato e il report salvato. Completata — N errori significa che la sincronizzazione è terminata, ma non è stato possibile elaborare alcuni plugin.


Se un aggiornamento di un plugin esistente non è valido, viene mantenuta l'ultima versione funzionante. Gli altri aggiornamenti validi possono comunque essere completati. Correggi il problema segnalato in GitHub, quindi seleziona Sincronizza ora per riprovare.


Se nella vista di amministrazione compare Aggiorna per un plugin importato singolarmente, usa questa opzione per aggiornarlo. Aggiorna elenco dei plugin ricarica solo l'elenco visualizzato; non esegue la sincronizzazione da GitHub.

Come funzionano la rimozione e l'eliminazione

La rimozione di una voce dal repository non elimina la copia importata nell'area di lavoro. Il plugin viene contrassegnato come Non più presente nell'origine.


L'eliminazione del marketplace in ChatGPT elimina tutti i plugin importati da quel marketplace. Non eliminare un marketplace per ricollegare GitHub o cambiare proprietario.

Ricollegare o modificare l'accesso a GitHub

La sincronizzazione del marketplace usa la connessione GitHub dell'amministratore che lo ha importato. Tale account deve mantenere l'accesso al repository del marketplace e a tutti i repository a cui fa riferimento.

Ricollegare l'account originale

1. Verifica che l'account GitHub usato per l'importazione abbia ancora accesso a tutti i repository richiesti.

2. Chiedi all'amministratore che ha importato originariamente il marketplace di aprire il plugin GitHub in ChatGPT e ricollegare il proprio account.

Trasferire la gestione a un nuovo amministratore

Il nuovo amministratore dell'area di lavoro può importare lo stesso marketplace usando la propria connessione GitHub:

1. Vai alla Console di amministrazione, seleziona l'area di lavoro ChatGPT desiderata e apri Plugin. Quindi seleziona Aggiungi > Importa marketplace.

2. Inserisci gli stessi valori di Origine, Percorso e Branch, tag o commit usati per il marketplace esistente.

3. Seleziona Importa marketplace e autorizza l'accesso a GitHub quando richiesto.

Le sincronizzazioni future useranno la connessione GitHub del nuovo amministratore. L'account del nuovo amministratore deve avere accesso in lettura al repository del marketplace e a ogni repository a cui fa riferimento.

Passare alla gestione tramite GitHub per un plugin esistente

Puoi usare un marketplace per gestire un plugin già presente nell'area di lavoro, caricato come archivio o non ancora gestito da un'origine GitHub. Il plugin esistente deve trovarsi nella stessa area di lavoro e avere lo stesso nome del plugin. Non è possibile assumere in questo modo la gestione di un plugin gestito da un'altra origine GitHub.


Per identificare il plugin esistente nel tuo marketplace:

1. Vai alla Console di amministrazione, seleziona l'area di lavoro ChatGPT desiderata e apri Plugin. Apri il plugin.

2. Copia l'ID del plugin che compare dopo /admin/plugins/ nel suo URL.

3. Aggiungi l'ID come pluginId accanto a name e source nella voce corrispondente dell'array plugins del marketplace. Non aggiungerlo al file plugin.json del plugin.

Il plugin mantiene il proprio ID, le impostazioni di condivisione e i criteri dell'area di lavoro. GitHub diventa l'origine degli aggiornamenti futuri, quindi i successivi caricamenti di archivi non possono sostituire il plugin.


Per un esempio di migrazione e i relativi requisiti, consulta: Gestione dei plugin.

Fare riferimento a un'app esistente

Un plugin può fare riferimento a un'app esistente nel file .app.json nella directory principale del plugin. Includi il punto iniziale nel nome del file e usa l'ID dell'app anziché l'ID di un plugin. Per un plugin nativo, imposta il campo apps in .codex-plugin/plugin.json su ./.app.json.


Il riferimento non crea un'app né concede autorizzazioni aggiuntive. Continuano ad applicarsi le impostazioni esistenti dell'app relative all'accesso nell'area di lavoro, all'autenticazione, ai controlli sulle azioni e alle autorizzazioni del servizio collegato.


Per il formato JSON, consulta: Gestione dei plugin.

Significato dell'etichetta Solo desktop

Un plugin contrassegnato come Solo desktop non può essere eseguito in ChatGPT sul web. I plugin importati possono ricevere questa etichetta quando dichiarano server MCP, ad esempio in mcp.json o .mcp.json, anche quando un server usa un URL HTTPS remoto.


L'aggiunta di un riferimento in .app.json non rimuove di per sé l'etichetta Solo desktop. Ogni app a cui si fa riferimento deve comunque essere disponibile per il ruolo del membro e restano validi i normali requisiti di accesso e autenticazione dell'app.