Dall'SDK delle App ai Plugin di ChatGPT
In questa pagina
Corso riscritto il 3 novembre 2026 sulla base della documentazione ufficiale sui Plugin di OpenAI. La versione precedente si basava su un pacchetto
@openai/apps-sdkinesistente (che includevadefineAction,defineWidgete un manifestchatgpt-app.json). Ora costruisci le app per ChatGPT utilizzando il protocollo MCP, i suoi SDK ufficiali e lo standard di interfaccia MCP Apps. Abbiamo riscritto tutte e quattordici le lezioni e rimosso gli elenchi di compatibilità dei modelli non supportati, le strutture di commissione e le procedure di pubblicazione della vecchia versione. Fonti: Guida rapida · Architettura dei plugin.
Cos’è un plugin?
Un plugin è il pacchetto che scopri, installi, condividi e pubblichi all’interno di ChatGPT e Codex. Estende le capacità dell’assistente fornendo nuove conoscenze, nuovi strumenti o entrambi. La documentazione di OpenAI identifica quattro mattoni fondamentali:
- Competenze (Skills), che forniscono al modello istruzioni e risorse per gestire flussi di lavoro ricorrenti;
- Un server MCP, che espone strumenti e collega l’assistente a sistemi esterni: la tua API, il tuo database o il tuo servizio;
- Entrambi, quando il modello ha bisogno sia di un manuale operativo sia delle capacità fornite dalla tua infrastruttura;
- Hook del ciclo di vita, comandi eseguiti in momenti specifici nell’ambiente di runtime di Codex, incluso all’interno di ChatGPT Work.
ChatGPT e Codex condividono un’unica directory di plugin: un plugin pubblico viene pubblicato una sola volta e diventa visibile su tutte le superfici compatibili in entrambi i prodotti. Alcune capacità rimangono specifiche della superficie: ad esempio, uno script hook deve esistere nell’ambiente di runtime, quindi installare il plugin sul web non lo distribuisce automaticamente lì.
E l‘“Apps SDK”?
Questo termine si riferisce al toolkit di OpenAI per costruire applicazioni all’interno di ChatGPT: il protocollo MCP e i suoi SDK ufficiali, lo standard aperto MCP Apps che ChatGPT implementa per il rendering delle interfacce, le estensioni specifiche per ChatGPT, un sistema di design (@openai/apps-sdk-ui) e un repository di esempi. La documentazione ora raggruppa questi elementi sotto la voce “Plugin di ChatGPT e Apps SDK”: un’app si concentra su un server MCP, include un’interfaccia opzionale e viene distribuita come parte di un plugin.
La scelta di MCP è deliberata. Il Model Context Protocol è una specifica aperta per collegare i client AI a strumenti e dati. Il server che scrivi per ChatGPT parla un protocollo comprensibile anche ad altri host, e un’interfaccia conforme a MCP Apps funziona in qualsiasi host che supporti tale standard.
Quattro forme possibili
Parti dalla forma più piccola che copra i tuoi casi d’uso; potrai aggiungere un server o un’interfaccia in seguito senza cambiare lo scopo principale del plugin.
| Forma | Scegli questa quando |
|---|---|
| Solo Competenze | Le istruzioni e gli strumenti esistenti sono sufficienti per gestire il flusso di lavoro |
| Solo server MCP | Il plugin ha bisogno di strumenti MCP ma non di ulteriori istruzioni sul flusso di lavoro |
| Competenze e server MCP | Le competenze devono guidare il modello attraverso flussi di lavoro che utilizzano i tuoi strumenti |
| Server MCP con interfaccia | L’interazione visiva migliora significativamente una parte del flusso di lavoro |
Un plugin che redige i verbali delle riunioni secondo le regole della tua azienda potrebbe aver bisogno solo di competenze. Non appena deve leggere dati in tempo reale, autenticare un utente o agire all’interno di un sistema che gestisci, richiede un server MCP. Infine, un’interfaccia non è mai obbligatoria: uno strumento deve rimanere utile anche senza di essa.
Dove viene eseguito il plugin
In ChatGPT, invochi un plugin installato direttamente digitando @ nel campo di input e selezionandolo. Il modello può anche chiamarlo automaticamente quando una richiesta corrisponde ai suoi strumenti o alle sue competenze. La guida rapida di OpenAI consiglia di testare il tuo primo plugin in ChatGPT Work, la scheda Work nella homepage web di ChatGPT. Gli stessi plugin appaiono in Codex, limitati dalle capacità specifiche di ciascuna superficie.
Cosa costruirai
Questo corso segue il percorso delineato nella documentazione. Inizierai definendo i tuoi strumenti in base alle esigenze degli utenti, collegherai un primo server MCP a ChatGPT e poi ne costruirai uno tuo: strumenti ben documentati, un’interfaccia MCP Apps dove aggiunge valore, autenticazione OAuth per i dati privati e, se il tuo modello di business lo consente, un flusso di acquisto utilizzando le API di Checkout. Concluderai con il confezionamento, le regole di pubblicazione e l’invio alla directory.
Punti chiave
- Un plugin combina competenze, un server MCP o entrambi; l’interfaccia è opzionale
- ChatGPT e Codex condividono un’unica directory di plugin
- “Apps SDK” si riferisce agli strumenti di OpenAI per costruire app: MCP, lo standard MCP Apps, le estensioni per ChatGPT e il sistema di design
- Non esiste alcun pacchetto
@openai/apps-sdk: inizia con gli SDK MCP ufficiali - Scegli la forma di plugin più piccola che copra i tuoi casi d’uso