Questo articolo spiega come caricare un plugin personalizzato o importarlo da GitHub quando quello che ti serve non è nel catalogo, cosa deve contenere il pacchetto e in cosa differiscono i plugin personali e quelli dell’organizzazione. Un plugin personalizzato riunisce Skill e connettori in un pacchetto che Perplexity Computer può installare in un solo passaggio.
Per aggiungere una singola Skill o un connettore personalizzato, consulta Come usare le Skill di Computer e Aggiungere connettori remoti personalizzati. Per aggiungere uno dei due al tuo account, parti dal menu Add custom.
Per caricare un plugin serve la pagina Plugins. Se non vedi ancora Plugins nella barra laterale, continua a usare Customize → Connectors e Skills per aggiungere Skill e connettori. Lì tutto funziona come prima.
Prima di iniziare
Per i plugin che includono Skill, un piano che includa Perplexity Computer.
Un file
.zipcon un manifestplugin.json(vedi Cosa contiene un pacchetto di plugin), oppure l’URL di un repository GitHub pubblico.Se fai parte di un’organizzazione, l’autorizzazione del tuo amministratore a caricare o creare plugin e Skill personali o dell’organizzazione.
Cosa contiene un pacchetto di plugin
Un pacchetto di plugin è un file .zip con un manifest plugin.json. Il manifest deve includere i campi name e description, e la descrizione può contenere fino a 1.024 caratteri. Inserisci plugin.json nella directory principale dell’archivio oppure carica un plugin di Claude Code o Codex così com’è: se nella directory principale non c’è un plugin.json, Perplexity legge .claude-plugin/plugin.json o .codex-plugin/plugin.json. Se comprimi la cartella stessa del plugin, quell’unica cartella di primo livello va bene. Il pacchetto può contenere:
Skill: cartelle che contengono ciascuna un file
SKILL.mdcon un blocco frontmatter YAML (nome e descrizione) e gli eventuali file di supporto usati dalla Skill.Connettori: server MCP remoti elencati in un file
mcp.jsonnella directory principale del pacchetto (o.mcp.json, il nome usato da Claude Code e Codex), non inplugin.json. Ogni server richiede un indirizzo HTTPS e untypestreamable-http,httposse. Ogni server viene aggiunto come connettore, oppure associato a un connettore già presente nella tua organizzazione, che i membri connettono con il proprio account. I server che il tuo account non è autorizzato ad aggiungere come connettore vengono ignorati.
Un plugin deve includere almeno una Skill o un connettore. Limiti per plugin:
Fino a 32 Skill
Fino a 1.000 file
Fino a 20 MB non compressi
Fino a 15 server MCP
Se il pacchetto elenca più di 15 server, vengono importati solo i primi 15. I server oltre il limite, i server locali stdio, quelli senza type, quelli che richiedono intestazioni fisse, gli URL dei server con segnaposto di variabili non risolti e i server che il tuo account non è autorizzato ad aggiungere come connettore vengono ignorati e il caricamento va comunque a buon fine. Dopo il caricamento, apri la pagina del plugin e verifica che siano elencati tutti i connettori previsti.
Caricare un plugin
Aprire la pagina Plugins
Seleziona Plugins nella barra laterale.
Selezionare Add custom e poi Upload plugin or skill
Se puoi creare plugin per la tua organizzazione, vedrai anche Upload plugin or skill to organization.
Trascinare il file .zip nell’area di caricamento o fare clic per sceglierlo
L’area di caricamento mostra i requisiti dei file.
Verificare che Skill e connettori del plugin siano elencati
Il plugin si apre nella propria pagina. Se hai caricato un plugin personale, viene installato subito per te.
Connettere i connettori che desideri usare
Se il caricamento viene rifiutato, verifica che il manifest includa un nome e una descrizione e che si trovi nella directory principale dell’archivio o nella posizione prevista da Claude Code o Codex.
Importare un plugin da GitHub
Puoi importare un plugin direttamente da un repository GitHub pubblico invece di scaricarlo e comprimerlo tu stesso. Si applicano gli stessi requisiti e limiti dei file .zip caricati.
Aprire la pagina Plugins
Seleziona Plugins nella barra laterale.
Selezionare Add custom e poi Import plugin from GitHub
Incollare l’URL del repository
Si possono importare solo repository pubblici. Per importare un singolo plugin da un repository che ne contiene diversi, incolla l’URL della cartella del plugin.
Verificare che Skill e connettori del plugin siano elencati
Come verificare che abbia funzionato
Il plugin si apre sulla sua pagina con l’elenco di Skills e connettori e compare nella scheda Installed. Se manca un connettore che ti aspettavi, controlla le regole di importazione riportate sopra.
Plugin personali e dell’organizzazione
I plugin personali sono destinati al tuo uso personale.
I plugin dell’organizzazione appaiono nella scheda Organization della pagina Plugins per tutti nella tua organizzazione. Non vengono installati automaticamente per nessuno. Un amministratore può installare un plugin dell’organizzazione per ogni membro. Se hai creato un plugin dell’organizzazione, puoi richiederne l’installazione per tutti dalla sua pagina. La richiesta viene inviata ai tuoi amministratori oppure, se la tua organizzazione consente ai membri di installare i plugin che hanno creato, il plugin viene installato subito per tutti.
Se fai parte di un’organizzazione, l’amministratore controlla se puoi caricare o creare plugin e Skill personali e se puoi creare plugin e Skill dell’organizzazione. Per condividere un plugin personale, aprilo e seleziona Transfer to organization; le tue preferenze personali per il plugin vengono mantenute. Gli amministratori gestiscono i plugin dell’organizzazione da Impostazioni dell’organizzazione → Plugins and skills; consulta Gestire i plugin per la tua organizzazione.
I membri non possono creare connettori dell’organizzazione, nemmeno caricando un plugin che dichiara un nuovo connettore. Un plugin caricato può fare riferimento a connettori già presenti nell’organizzazione. I connettori nel plugin rispettano le impostazioni dei connettori e i permessi dei ruoli dell’organizzazione.
Aggiornare o eliminare un plugin caricato
Per aggiornare un plugin, aprilo, seleziona More actions e poi Replace file per caricare un nuovo .zip. Per rimuoverlo completamente, scegli Delete plugin. L’eliminazione rimuove definitivamente il plugin e il suo pacchetto, senza disconnettere i connettori a cui faceva riferimento. Per smettere di usare un plugin senza eliminarlo, seleziona invece Disinstalla. Consulta Trovare, installare e rimuovere plugin.
Articoli correlati
Hai bisogno di ulteriore aiuto?
Contattaci tramite Help > Contact Support. Includi il link dell’attività se la tua domanda riguarda una specifica attività di Computer.