Portail de soumission des plugins Claude : guide pas à pas

Pour soumettre un plugin Claude, rendez-vous sur le portail développeur d’Anthropic à l’adresse claude.ai/directory/manage. Le parcours actuel est Submit new → Plugin bundle. Pour qu’une fiche soit publiée, il faut toutefois disposer d’un dépôt GitHub public, d’un forfait et d’un rôle autorisés, puis passer les contrôles de validation.

Le parcours actuel pour soumettre un plugin Claude

La procédure officielle commence dans la documentation de soumission des plugins d’Anthropic, et non dans le dépôt GitHub public de la marketplace. Chaque dossier de plugin doit être soumis séparément, même si plusieurs plugins se trouvent dans le même dépôt.

Ce guide concerne la distribution dans l’annuaire public, pas le partage privé au sein d’une équipe ni l’installation locale d’un plugin.

À préparer avant d’ouvrir le portail

Préparez le dépôt avant d’ouvrir le portail.

1. Hébergez le plugin sur GitHub

L’annuaire récupère les plugins depuis github.com. Anthropic précise que le dépôt doit être public avant la mise en ligne de la fiche. Si le plugin se trouve dans un sous-dossier, relevez le chemin correspondant.

Un plugin Claude Code standard contient généralement :

plugin-name/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json          # optional
├── commands/          # optional
├── agents/            # optional
├── skills/            # optional
└── README.md

Le manifeste et le README fournissent une grande partie des informations affichées dans l’annuaire. Vérifiez également la licence du plugin et les services externes utilisés avant de lancer la soumission.

2. Lancez une validation en local

Depuis le dossier qui contient le répertoire du plugin, exécutez :

claude plugin validate ./<plugin-folder>

Cette commande repère les problèmes de structure et de format, mais l’étape Validate du portail effectue des contrôles supplémentaires. Considérez donc la validation locale comme un premier filtre, pas comme une approbation.

3. Séparez le connecteur MCP si nécessaire

Si votre plugin utilise un serveur MCP distant que vous gérez et qui n’a pas encore été soumis, le guide d’Anthropic demande de soumettre ce serveur séparément comme MCP connector. Le bundle du plugin et le connecteur correspondent à deux fiches distinctes dans l’annuaire.

Soumettre un bundle de plugin, étape par étape

1. Sélectionnez Plugin bundle

Ouvrez le portail développeur et cliquez sur Submit new. Lorsque le portail vous demande ce que vous souhaitez soumettre, choisissez Plugin bundle. Sélectionnez MCP connector uniquement si vous soumettez un serveur MCP distant comme fiche indépendante.

2. Renseignez le dépôt, le chemin et la branche

Dans la section Source, indiquez :

• L’URL GitHub ou le format owner/repo.
• Plugin path, si .claude-plugin/plugin.json ne se trouve pas à la racine du dépôt.
• Branch or tag, si l’annuaire doit suivre autre chose que la branche par défaut.

Un tag reste associé à son commit tant que vous ne modifiez pas le tag. Si le nom de la branche contient une barre oblique, saisissez-le explicitement ou utilisez le format owner/repo@branch décrit dans le guide officiel de soumission.

Cliquez sur Validate. Si un problème bloque la soumission, corrigez le dépôt, poussez la modification, puis relancez la validation. Le résultat de validation correspond à un commit précis.

3. Vérifiez la fiche générée

L’étape Listing details affiche l’apparence du plugin dans l’annuaire. Anthropic récupère ces informations dans plugin.json et dans le README.

Pour corriger le nom ou la courte description, modifiez les fichiers sources. L’annuaire officiel des plugins d’Anthropic rappelle également que le slug d’installation d’un plugin publié doit rester stable, car les utilisateurs peuvent sinon rencontrer l’erreur plugin-not-found. Utilisez un libellé d’affichage pour les changements de formulation courants et réservez le mapping de renommage aux migrations nécessaires.

4. Répondez aux questions sur le traitement des données

L’étape Data handling vous demande si le plugin :

• Lit ou stocke des données personnelles.
• Envoie des données à des services autres que les connecteurs déclarés.
• Conserve des données, et pendant combien de temps.
• S’adresse à des personnes de moins de 18 ans.

Répondez en fonction du fonctionnement réel du plugin. Mentionnez les services distants, l’accès aux fichiers, la télémétrie et les règles de conservation.

5. Validez les engagements de conformité

Dans Compliance, indiquez une adresse e-mail à laquelle Anthropic peut vous joindre, puis cochez les confirmations demandées. Le plugin doit respecter la politique du Software Directory d’Anthropic.

6. Soumettez le plugin et choisissez le mode de diffusion des mises à jour

Dans Review and submit, vérifiez les informations, puis choisissez la manière dont les nouvelles versions seront récupérées :

• GitHub push webhook, sélectionné par défaut dans le guide actuel ; une fois configuré, il peut déclencher des contrôles après chaque push.
• Scheduled check only, qui s’appuie uniquement sur les vérifications de la branche ou du tag suivi.

Cliquez sur Submit for review. L’accès administrateur à GitHub est nécessaire pour configurer le webhook. Anthropic limite actuellement une organisation à 10 soumissions sur une période de 24 heures ; les brouillons enregistrés et les soumissions retirées sont également comptabilisés. Ces limites et les options de mise à jour sont détaillées dans le workflow de soumission.

Que se passe-t-il après la soumission ?

Anthropic analyse le dernier commit de la branche ou du tag suivi, relance la validation de l’annuaire et effectue une analyse de sécurité. Le guide officiel décrit les états suivants :

Une version validée n’est pas forcément déjà en ligne. Le réglage par défaut peut imposer une demande de publication et une publication par un reviewer ; le portail propose également des options de publication automatique pour certaines versions ultérieures qui passent les contrôles.

Pour suivre l’avancement, ouvrez le plugin dans Submissions, puis consultez Versions. Après une correction, utilisez Check for new commits lorsque l’option est disponible. Pour publier une mise à jour, poussez un commit sur la branche suivie ou déplacez le tag suivi : il n’est pas nécessaire de remplir à nouveau le formulaire. La dernière version publiée reste en ligne tant que la nouvelle version échoue aux contrôles ou attend une revue.

Les contrôles de sécurité à ne pas négliger

L’annuaire officiel d’Anthropic rappelle que les plugins peuvent intégrer des serveurs MCP, des fichiers et d’autres logiciels qui échappent au contrôle d’Anthropic. Avant la soumission, documentez chaque service externe, chaque permission, la durée de conservation des données et les actions exécutées en arrière-plan.

« I mean, I asked it to audit why my plugin submissions failed and fix the issue. » — @tarasshyn, X, à propos d’un échec de soumission et d’un processus d’audit.

Utilisez cette checklist avant l’envoi :

1. Déclarez et documentez tous les services contactés en externe.
2. Expliquez dans le README les permissions, la configuration, les flux de données et leur durée de conservation.
3. Vérifiez que la référence suivie contient bien le code que vous souhaitez publier.
4. Relancez la validation après chaque commit correctif.
5. Signalez l’indexation en arrière-plan, la télémétrie et tout comportement automatisé susceptible d’engendrer des coûts.

FAQ : soumettre un plugin Claude

Le dépôt GitHub doit-il être public ?

Oui. La documentation actuelle d’Anthropic précise que le dépôt doit être public avant la mise en ligne de la fiche.

Puis-je soumettre plusieurs plugins depuis un même dépôt ?

Oui, mais chaque dossier de plugin fait l’objet d’une soumission distincte. Saisissez séparément chaque chemin concerné dans le portail.

Puis-je envoyer une pull request au dépôt communautaire ?

Non. Le README de la marketplace communautaire d’Anthropic présente ce dépôt comme un miroir en lecture seule et précise que les pull requests directes sont automatiquement fermées. Utilisez le portail développeur.

Dois-je soumettre séparément un serveur MCP distant ?

Si votre plugin utilise un serveur MCP distant que vous gérez et que ce serveur n’est pas déjà référencé, soumettez-le séparément comme MCP connector.

Que faire si la validation échoue ?

Corrigez le dépôt, poussez la modification, puis relancez la validation. Celle-ci s’applique à un commit précis. Après la soumission, utilisez le contrôle des nouveaux commits proposé par le portail lorsqu’il est disponible.

Un scan réussi publie-t-il automatiquement le plugin ?

Pas systématiquement. Une version validée peut encore nécessiter l’action Publish et une publication par un reviewer. Le réglage de publication automatique du portail détermine le traitement des versions ultérieures qui passent les contrôles.

Puis-je retirer de l’annuaire un plugin publié ?

Oui. Ouvrez le plugin en ligne dans le portail développeur et demandez Delist plugin. Anthropic précise que le changement peut mettre du temps à apparaître dans toutes les applications Claude et que les utilisateurs existants peuvent ne plus recevoir de mises à jour.

Pour publier un plugin dans l’annuaire public, le chemin le plus court consiste à rendre le dépôt public, effectuer une validation locale, soumettre un Plugin bundle, corriger les problèmes liés au commit concerné, renseigner les volets données et conformité, puis publier la version validée. Si la visibilité publique ne justifie pas les contraintes de revue et de maintenance, mieux vaut conserver le package en privé pour l’équipe.