Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Invia e pubblica nella directory

Lezione 12 di 14 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Come funziona
  2. 1. Carica il ZIP
  3. 2. Gestisci i risultati automatizzati
  4. 3. Invia per la revisione
  5. 4. Pubblica
  6. Aggiornamento
  7. Punti chiave

Lezione riscritta il 3 novembre 2026 sulla base della pagina Upload and submit your plugin della documentazione dei plugin OpenAI. La lezione precedente descriveva la pubblicazione in un “ChatGPT Store” con una fase di “prezzi”. Oggi invii un file ZIP del tuo plugin dal portale dei plugin della piattaforma OpenAI e il plugin viene pubblicato nella directory condivisa da ChatGPT e Codex. Fonte: Upload and submit your plugin.

Come funziona

Invii il pacchetto già costruito (Lezione 10) come file ZIP, risolvi eventuali problemi rilevati dai controlli automatizzati e lo invii quindi per la revisione. Una volta approvato il tuo plugin, decidi tu quando pubblicarlo. Successivamente, le modifiche al tuo server MCP vengono rilevate automaticamente dopo la convalida; solo le modifiche ai metadati o alle competenze richiedono un nuovo ZIP. Un server remoto viene inviato tramite il percorso With MCP, utilizzando un endpoint HTTPS pubblico e stabile. Un plugin che esegue un server MCP locale segue il flusso di lavoro dei plugin desktop.

1. Carica il ZIP

Seleziona l’organizzazione e il progetto a cui appartiene il plugin. I proprietari dell’organizzazione possono effettuare l’invio; gli altri membri necessitano dell’autorizzazione Apps Management Write. Verifica la tua identità (individuale o aziendale) nelle impostazioni della tua organizzazione: il nome associato a questa identità è quello che verrà visualizzato nella directory.

Se il plugin utilizza un server MCP, includilo nel ZIP iniziale: non è attualmente possibile aggiungere un server MCP a un plugin esistente che contiene solo competenze. Successivamente, apri Plugins, seleziona Upload new or existing plugin, scegli la tua identità di sviluppatore, quindi clicca su Upload plugin e seleziona il tuo ZIP. Dopo la convalida, si apre la pagina di bozza. Non includere mai credenziali o segreti nel ZIP.

2. Gestisci i risultati automatizzati

La pagina del plugin separa due pannelli perché evolvono in modo diverso: Metadata & Skills, che traccia la versione del pacchetto caricato, e MCPs, che mostra il server connesso e i suoi strumenti analizzati.

  • Metadati. Attendi il completamento dei controlli, esamina la sezione Issues, correggi il tuo pacchetto sorgente e carica un ZIP corretto. Gli URL pubblici devono essere accessibili e identificare lo stesso editore dell’invio. Il pulsante Copy issues ti permette di incollare i risultati in ChatGPT o Codex per suggerire correzioni.
  • Competenze. Le competenze vengono analizzate automaticamente; correggi le loro istruzioni o i file in base ai risultati. Le analisi obbligatorie devono superare i controlli prima di qualsiasi invio.
  • Server MCP. Un pacchetto può dichiarare più server, ma solo uno può essere connesso per plugin. Apri MCPs, seleziona il server, quindi clicca su Connect; verifica l’URL e l’autenticazione, completa la sfida di verifica del dominio, accedi se richiesto, attendi l’analisi degli strumenti ed esamina i risultati.

La verifica del dominio consiste nel servire il token della sfida, come testo semplice e nient’altro, all’indirizzo specificato dal portale:

https://<challenge-host>/.well-known/openai-apps-challenge

L’host deve essere un’origine HTTPS sull’hostname del server MCP o su un dominio padre idoneo.

3. Invia per la revisione

I revisori necessitano di elementi specifici per testare l’integrazione. Alcuni di questi possono essere inclusi in plugin.json per essere importati con il ZIP:

  • Credenziali di test, se è richiesto l’accesso: un account dedicato con dati di esempio, mai l’account di un utente reale, utilizzabile immediatamente, senza MFA, codici email/SMS, link magici o accesso a reti private. Inserisci queste credenziali separatamente, al di fuori del pacchetto pubblico;
  • Cinque casi di test positivi: scenario, prompt, strumenti previsti, risultato previsto, ciascuno già eseguito con l’account di test;
  • Tre casi di test negativi: una richiesta che il plugin non dovrebbe soddisfare, il motivo e il rifiuto, chiarimento o fallback previsto;
  • Un video che dimostri i casi di test e la funzionalità del plugin;
  • Note di rilascio per il pacchetto inviato.

Successivamente, seleziona la bozza, clicca su Submit for review e conferma le attestazioni di conformità richieste. Può essere attiva solo una revisione per plugin. Il feedback arriva via email; se respinto, correggi i problemi e invia un ZIP corretto, oppure fai appello rispondendo all’email.

4. Pubblica

Una volta approvato il plugin, apri la versione approvata e seleziona Publish plugin. Gli utenti potranno quindi trovarlo nella directory condivisa da ChatGPT e Codex, sia tramite un link diretto alla sua scheda sia cercando il suo nome.

Aggiornamento

Coesistono due flussi di lavoro. Per metadati, elementi visivi o competenze, carica un nuovo ZIP completo con un numero di versione incrementato nel plugin esistente: la nuova versione sottostà ai propri controlli e alla propria revisione e la sua pubblicazione sostituisce quella precedente. Per i tuoi strumenti server, nulla da caricare: dopo la pubblicazione iniziale, OpenAI analizza il tuo server quotidianamente e rende disponibili gli aggiornamenti idonei non appena superano i controlli automatizzati; puoi anche richiedere un’analisi immediatamente dopo un deployment. Per modificare l’URL di un server MCP esistente, devi contattare il supporto.

Punti chiave

  • Invia un ZIP del tuo plugin sul portale Plugins sotto un’identità verificata
  • Metadati e competenze da una parte, server MCP e strumenti dall’altra: due pannelli di controllo separati
  • Verifica del dominio tramite un token servito su /.well-known/openai-apps-challenge
  • Requisiti di revisione: account di test senza MFA, 5 casi positivi, 3 casi negativi, un video e note di rilascio
  • Dopo la pubblicazione: nuovo ZIP per metadati e competenze, analisi giornaliera per gli strumenti