AIREITERPer inviare un plugin Claude devi passare dal portale per sviluppatori di Anthropic: claude.ai/directory/manage. Il percorso attuale è Submit new → Plugin bundle, ma per vedere la scheda online servono anche un repository GitHub pubblico, un piano e un ruolo abilitati all’invio, oltre al superamento della revisione.
Come si invia oggi un plugin Claude
La procedura ufficiale parte dalla documentazione Anthropic sull’invio dei plugin, non dal repository GitHub pubblico del marketplace. Ogni cartella plugin va inviata separatamente, anche quando più plugin si trovano nello stesso repository.
| Cosa serve | Requisito attuale |
|---|---|
| Pagina per l’invio | claude.ai/directory/manage |
| Tipo di invio | Plugin bundle |
| Sorgente | Un repository GitHub pubblico prima della pubblicazione della scheda |
| Accesso | Un piano e un ruolo che consentano di inviare elementi alla directory |
| Revisione | Validazione e scansione di sicurezza; alcune versioni vengono sottoposte a revisione manuale |
| Pubblicazione | Anche una versione che supera i controlli deve essere pubblicata |
Questa guida riguarda la distribuzione nella directory pubblica, non la condivisione privata con un team né l’installazione locale di un plugin.
Prima di aprire il portale
Prepara il repository prima di iniziare la procedura.
1. Inserisci il plugin su GitHub
La directory legge i plugin da github.com e Anthropic specifica che il repository deve essere pubblico prima che la scheda venga pubblicata. Se il plugin non si trova nella radice del repository, annota il percorso della cartella.
Un plugin Claude Code standard include spesso:
plugin-name/
├── .claude-plugin/
│ └── plugin.json
├── .mcp.json # optional
├── commands/ # optional
├── agents/ # optional
├── skills/ # optional
└── README.mdManifest e README forniscono gran parte delle informazioni mostrate nella directory. Prima dell’invio, verifica anche la licenza del plugin e i servizi esterni utilizzati.
2. Esegui la validazione in locale
Dalla directory che contiene la cartella del plugin, esegui:
claude plugin validate ./<plugin-folder>Il comando individua i problemi di struttura e formattazione, ma il passaggio Validate del portale esegue controlli aggiuntivi. Considera quindi la validazione locale come una prima verifica, non come un’approvazione.
3. Invia separatamente il connettore MCP, se necessario
Se il plugin fa riferimento a un server MCP remoto che gestisci tu e che non è già stato inviato, la guida Anthropic indica di inviare il server separatamente come MCP connector. Il bundle del plugin e il connettore sono due schede distinte nella directory.
Come inviare un singolo plugin bundle
1. Scegli Plugin bundle
Apri il portale per sviluppatori e seleziona Submit new. Quando ti viene chiesto cosa vuoi inviare, scegli Plugin bundle. Seleziona MCP connector solo quando devi pubblicare un server MCP remoto come scheda autonoma.
2. Inserisci repository, percorso e branch
Nella sezione Source indica:
- L’URL GitHub oppure
owner/repo. - Plugin path, se
.claude-plugin/plugin.jsonnon si trova nella radice del repository. - Branch or tag, se la directory deve seguire qualcosa di diverso dal branch predefinito.
Un tag rimane ancorato al commit a cui punta finché non modifichi il tag. Se il nome del branch contiene una barra, inseriscilo esplicitamente oppure usa la forma owner/repo@branch descritta nella guida ufficiale all’invio.
Seleziona Validate. Se un problema impedisce di proseguire, correggi il repository, invia la modifica e ripeti la validazione. Il risultato della validazione si applica a un singolo commit.
3. Controlla la scheda generata
Il passaggio Listing details mostra come apparirà il plugin nella directory. Anthropic ricava queste informazioni da plugin.json e dal README.
Se devi correggere il nome o la descrizione breve, modifica i file sorgente. Anche la directory ufficiale dei plugin Anthropic avverte che lo slug usato per l’installazione dovrebbe rimanere stabile, perché gli utenti potrebbero imbattersi nell’errore plugin-not-found. Per le normali modifiche al testo mostrato usa un’etichetta visualizzata; riserva la mappatura di rinomina alle migrazioni necessarie.
4. Rispondi alle domande sulla gestione dei dati
La sezione Data handling chiede se il plugin:
- Legge o archivia dati personali.
- Invia dati a servizi diversi dai connettori dichiarati.
- Conserva i dati e per quanto tempo.
- È rivolto a persone di età inferiore ai 18 anni.
Rispondi in base all’implementazione effettiva. Includi servizi remoti, accesso ai file, telemetria e modalità di conservazione dei dati.
5. Completa le dichiarazioni di conformità
Nella sezione Compliance, conferma un indirizzo email al quale Anthropic possa contattarti e seleziona le dichiarazioni richieste. Il plugin deve rispettare la policy della Software Directory di Anthropic.
6. Invia il plugin e scegli come distribuire gli aggiornamenti
Nella sezione Review and submit, verifica i dati e scegli come devono arrivare le nuove versioni:
- GitHub push webhook, selezionato per impostazione predefinita nella guida attuale; se configurato, può avviare i controlli dopo ogni push.
- Scheduled check only, che si basa sui controlli del branch o del tag seguito.
Seleziona Submit for review. Per configurare il webhook servono i permessi di amministratore su GitHub. Attualmente Anthropic limita ogni organizzazione a 10 invii nell’arco di 24 ore; nel conteggio rientrano anche le bozze salvate e gli invii ritirati. Questi limiti e le impostazioni per gli aggiornamenti sono descritti nel flusso di invio.
Cosa succede dopo l’invio
Anthropic analizza il commit più recente del branch o del tag seguito, ripete la validazione della directory ed esegue una scansione di sicurezza. La guida ufficiale descrive questi stati:
| Stato | Significato | Cosa fare |
|---|---|---|
| Supera tutti i controlli | La versione è pronta per la pubblicazione | Seleziona Publish |
| In attesa di revisione | Un revisore deve risolvere i problemi rilevati | Applica le modifiche richieste o attendi la revisione |
| Non supera i controlli | Il portale mostra le regole non rispettate o una categoria di sicurezza | Correggi il repository e controlla il nuovo commit |
| Rifiutato | L’invio non è stato approvato | Leggi le modifiche richieste e usa Resubmit for review |
Una versione che supera i controlli non è necessariamente già online. L’impostazione predefinita può richiedere una richiesta di pubblicazione e l’intervento di un revisore; per alcune versioni successive che superano i controlli il portale supporta anche la pubblicazione automatica.
Per seguire l’avanzamento, apri il plugin nella sezione Submissions e controlla Versions. Dopo una correzione, usa Check for new commits quando disponibile. Per gli aggiornamenti basta effettuare il push sul branch seguito oppure spostare il tag seguito: non devi compilare di nuovo il modulo. L’ultima versione pubblicata rimane online mentre una nuova versione non supera i controlli o attende la revisione.
Controlli di sicurezza da non saltare
La directory ufficiale Anthropic avverte che i plugin possono includere server MCP, file e altro software al di fuori del controllo di Anthropic. Prima dell’invio, documenta ogni servizio esterno, permesso, periodo di conservazione e attività eseguita in background.
«Voglio dire, gli avevo chiesto di verificare perché i miei invii di plugin fallivano e di risolvere il problema.» — @tarasshyn, X, a proposito di un invio non riuscito e del relativo flusso di analisi.
Usa questa checklist prima dell’invio:
- Dichiara e documenta ogni servizio verso il quale vengono inviati dati.
- Spiega nel README permessi, configurazione, flusso dei dati e conservazione.
- Verifica che il riferimento seguito contenga il codice che intendi pubblicare.
- Ripeti la validazione dopo ogni commit correttivo.
- Indica chiaramente indicizzazione in background, telemetria o comportamenti automatizzati che possono generare costi.
FAQ: invio dei plugin Claude
Il repository GitHub deve essere pubblico?
Sì. La documentazione attuale di Anthropic specifica che il repository deve essere pubblico prima che la scheda venga pubblicata.
Posso inviare più plugin dallo stesso repository?
Sì, ma ogni cartella plugin costituisce un invio separato. Nel portale devi indicare ogni percorso interessato singolarmente.
Posso inviare il plugin tramite pull request al repository della community?
No. Il README del marketplace della community Anthropic descrive quel repository come uno specchio in sola lettura e specifica che le pull request dirette vengono chiuse automaticamente. Usa il portale per sviluppatori.
Devo inviare separatamente un server MCP remoto?
Se il plugin fa riferimento a un server MCP remoto che gestisci tu e il server non è già presente nella directory, invialo separatamente come MCP connector.
Cosa succede quando la validazione fallisce?
Correggi il repository, invia la modifica e ripeti la validazione. La validazione riguarda un commit specifico. Dopo l’invio, usa il controllo dei nuovi commit del portale quando disponibile.
Una scansione superata pubblica automaticamente il plugin?
Non sempre. Una versione che supera i controlli può richiedere comunque Publish e la pubblicazione da parte di un revisore. L’impostazione di pubblicazione automatica del portale determina come vengono gestite le versioni successive che superano i controlli.
Posso rimuovere dalla directory un plugin già pubblicato?
Sì. Apri il plugin online nel portale per sviluppatori e richiedi Delist plugin. Anthropic specifica che la modifica può richiedere tempo prima di raggiungere tutte le app Claude e che gli utenti esistenti potrebbero smettere di ricevere aggiornamenti.
Per una pubblicazione nella directory, il percorso più rapido è questo: rendi pubblico il repository, esegui la validazione locale, invia un Plugin bundle, correggi i problemi legati al commit, completa le sezioni su dati e conformità e pubblica la versione che supera i controlli. Se la visibilità nella directory non giustifica revisione e manutenzione pubbliche, mantieni privato il pacchetto destinato al solo team.