Ceci est un guide complet pour soumettre votre serveur local (MCPB) au répertoire public d'Anthropic pour une distribution et une découverte plus larges.
Prérequis
Avant de lire ce guide, vous devez avoir :
Un MCPB fonctionnel
Un code portable utilisant la substitution de variables
De bons messages d'erreur et une bonne expérience utilisateur
Des dépendances propres et regroupées
Nouveau dans le développement MCPB ? Consultez d'abord Building MCPB Extensions. Pour les meilleures pratiques techniques (tests, messages d'erreur, portabilité), consultez MCPB Repository.
Remarque : Ce guide couvre les serveurs MCP locaux. Pour les extensions de bureau distantes, consultez Remote MCP Server Submission Guide.
1. Aperçu du répertoire
Quels sont les avantages de l'inclusion dans le répertoire ?
Découverte et confiance :
Listé dans le répertoire officiel d'Anthropic dans Claude Desktop
Consultable par les utilisateurs individuels de Claude Desktop
Visible pour les utilisateurs Teams/Enterprise lorsqu'il est ajouté à la liste d'autorisation par les administrateurs
L'examen par Anthropic renforce la confiance des utilisateurs
Expérience utilisateur :
Installation en un clic à partir du répertoire
Intégré à l'interface utilisateur des paramètres de Claude Desktop
Présentation standardisée
Support et crédibilité :
Examen par Anthropic de la qualité et de la sécurité
Listé aux côtés d'autres extensions examinées
Visibilité communautaire et retours d'information
Canal de distribution professionnel
2. Exigences obligatoires
Toutes les exigences de cette section sont obligatoires pour l'approbation du répertoire. L'absence de l'une d'entre elles entraînera un rejet ou une demande de révision.
Remarque : Ce sont des exigences spécifiques au répertoire d'Anthropic.
Pour les meilleures pratiques générales du développement MCPB (tests, gestion des erreurs, portabilité), consultez MCPB Repository README.
Les annotations d'outils sont-elles obligatoires ?
OUI. Chaque outil DOIT avoir et maintenir des annotations de sécurité précises.
Obligatoire sur chaque outil :
readOnlyHint: true - Pour les outils qui lisent uniquement les données
destructiveHint: true - Pour les outils qui modifient les données ou ont des effets secondaires
Consultez MCP Protocol - Tool Annotations pour le schéma complet et les détails de mise en œuvre.
Pas optionnel. C'est une exigence stricte dérivée de la MCP Directory Policy.
Comment décider quelle annotation utiliser :
Comportement de l'outil | Annotation | Exemples |
Lit uniquement les données | readOnlyHint: true | search, get, list, fetch, read |
Écrit/modifie les données | destructiveHint: true | create, update, delete, send, write |
Crée des fichiers temporaires | destructiveHint: true | Même les écritures temporaires comptent |
Envoie des demandes externes | destructiveHint: true | E-mails, notifications, webhooks |
Met en cache en interne uniquement | readOnlyHint: true | L'optimisation interne est OK |
Détails de mise en œuvre : Consultez MCP Protocol - Tools pour :
Schéma d'outil complet avec annotations
Structure de définition d'outil
Spécifications de schéma d'entrée/sortie
Propriétés d'outil supplémentaires (y compris le champ titre optionnel)
Validation avant la soumission :
# Vérifier que tous les outils ont des annotations
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# Vérifier que chaque outil a exactement une annotation
Impact : La première chose que nous vérifions et la raison la plus courante d'une demande de révision.
Annotation recommandée supplémentaire :
title - Nom d'outil lisible par l'homme pour l'affichage dans l'interface utilisateur (améliore l'expérience utilisateur)
Les politiques de confidentialité sont-elles obligatoires ?
Oui, les politiques de confidentialité sont obligatoires dans deux emplacements :
Emplacement 1 : README.md
Ajoutez une section « Politique de confidentialité » à votre README avec un lien vers votre politique de confidentialité complète afin que les utilisateurs soient conscients de vos pratiques :
## Politique de confidentialité
Cette extension collecte [décrire les types de données]. Pour des informations complètes sur la confidentialité, consultez notre politique de confidentialité : https://your-domain.com/privacy-policy
### Collecte de données
- [Lister les données collectées]
- [Comment elles sont utilisées]
- [Si elles sont partagées avec des tiers]
- [Période de rétention]
Emplacement 2 : manifest.json
Ajoutez un tableau privacy_policies avec des URL HTTPS accessibles publiquement :
Mise en œuvre complète : Consultez MCPB Manifest Spec - Privacy Policies pour :
Structure du champ de politique de confidentialité
Exigences de version du manifeste (0.3+)
Support d'URL de politique multiple
Exigences de validation
La politique de confidentialité doit couvrir :
Quelles données votre MCPB collecte
Comment les données sont utilisées et stockées
Si les données sont partagées avec des tiers
Politiques de rétention des données utilisateur
Informations de contact pour les questions de confidentialité
Exigences :
Doit être une URL HTTPS accessible publiquement
Doit provenir de votre domaine (pas d'hébergement tiers)
Doit être actuelle et exacte
Doit être dans README ET manifest.json
Doit utiliser manifest_version « 0.3 » ou supérieure
Erreurs courantes :
Politique de confidentialité dans le manifeste mais pas dans le README
Politique de confidentialité dans le README mais pas dans le manifeste
Utilisation de manifest_version « 0.2 » ou antérieure
URL invalides ou inaccessibles
Politique de confidentialité hébergée sur un site tiers
Impact : L'une des causes les plus courantes de rejet - simple à corriger mais souvent oubliée.
Combien d'exemples sont obligatoires ?
MINIMUM de trois exemples fonctionnels démontrant les fonctionnalités principales.
Ce qui constitue un bon exemple :
Montre un cas d'usage réaliste
Inclut l'entrée/l'invite utilisateur attendue
Montre la sortie/le comportement attendu
Démontre l'utilisation réelle de l'outil
Flux de travail clair et compréhensible
Format d'exemple (dans README.md) :
## Exemples
### Exemple 1 : Rechercher des fichiers
**Invite utilisateur :** « Trouvez tous les fichiers JavaScript dans mon projet »
**Comportement attendu :**
- L'extension recherche le répertoire de l'espace de travail
- Retourne une liste de fichiers .js avec les chemins
- Affiche le nombre de fichiers dans le résumé
### Exemple 2 : Lire le contenu du fichier
**Invite utilisateur :** « Montrez-moi le contenu de config.json »
**Comportement attendu :**
- L'extension lit config.json
- Retourne le contenu JSON formaté
- Gère gracieusement le fichier non trouvé
### Exemple 3 : Créer un nouveau fichier
**Invite utilisateur :** « Créez un nouveau fichier appelé notes.txt avec 'Hello World' »
**Comportement attendu :**
- L'extension crée notes.txt
- Écrit le contenu dans le fichier
- Confirme la création avec le chemin du fichier
Ce qu'il faut inclure :
Invites utilisateur réalistes (comment les utilisateurs interagiront)
Appels d'outils attendus (ce qui se passe en arrière-plan)
Sorties attendues (ce que les utilisateurs verront)
Exemples de gestion des erreurs (optionnel mais recommandé)
Exigences :
Minimum 3 exemples (pas de maximum)
Couvrir les fonctionnalités principales
Montrer différents outils/capacités
Démontrer la proposition de valeur
Inclure dans README.md
Impact : Une source fréquente de retards ou de rejets - les examinateurs ont besoin d'une documentation complète pour évaluer correctement les soumissions.
Dois-je fournir des identifiants de test ?
Si votre MCPB nécessite une authentification ou un accès à un service externe, alors OUI.
Obligatoire quand :
Votre MCPB se connecte à des API externes
L'authentification est nécessaire pour la fonctionnalité
L'utilisateur MCPB doit avoir un compte pour utiliser les fonctionnalités
L'intégration de service externe est autrement présente
Non obligatoire quand :
MCPB purement local (opérations du système de fichiers uniquement)
Pas de connexions externes
Pas d'authentification nécessaire
Complètement autonome
Ce qu'il faut fournir :
Identifiants de compte de test (nom d'utilisateur/mot de passe ou clés API)
Données d'exemple dans le compte (utile pour les tests fonctionnels)
Instructions de configuration (comment configurer et utiliser le compte de test)
Limitations ou restrictions d'accès (le cas échéant)
Date d'expiration du compte (si temporaire)
Comment fournir :
Inclure dans le formulaire de soumission
Envoyer via une méthode sécurisée si très sensible
S'assurer que le compte reste actif pendant la période d'examen
Fournir un niveau d'accès suffisant pour les tests complets
Meilleure pratique : Créez un compte de test dédié séparé de la production pour :
Éviter d'exposer les données de production
Contrôler ce que les examinateurs peuvent accéder
Révoquer facilement l'accès après approbation
Suivre l'utilisation du compte de test
Impact : Retarde le processus d'examen s'il manque quand nécessaire
Quelle documentation est obligatoire ?
Documentation complète dans README.md avec sections minimales obligatoires.
Sections minimales obligatoires :
Description - Explication claire de ce que fait votre MCPB
Fonctionnalités - Capacités clés et cas d'usage
Installation - Comment installer (généralement : « Installer à partir du répertoire Anthropic »)
Configuration - Paramètres obligatoires et étapes de configuration
Exemples d'utilisation - Minimum 3 exemples (voir la section ci-dessus)
Politique de confidentialité - Lien vers la politique de confidentialité complète
Support - Comment les utilisateurs peuvent obtenir de l'aide ou signaler des problèmes
Exemple de structure README.md :
# Mon extension MCPB
## Description
Brève description de ce que fait cette extension et pourquoi c'est utile.
## Fonctionnalités
- Fonctionnalité 1 : [description]
- Fonctionnalité 2 : [description]
- Fonctionnalité 3 : [description]
## Installation
Installez à partir du répertoire Anthropic dans Claude Desktop Paramètres → Extensions.
## Configuration
1. Ouvrez Paramètres → Extensions → [Nom de l'extension]
2. Ajoutez la clé API (si nécessaire)
3. Sélectionnez le répertoire de l'espace de travail
4. Configurez les paramètres optionnels
## Exemples
[Voir la section minimum 3 exemples ci-dessus]
## Politique de confidentialité
Consultez notre politique de confidentialité : https://your-domain.com/privacy
## Support
Pour les problèmes ou les questions : [email protected]
Problèmes GitHub : https://github.com/your-username/your-extension/issues
Sections supplémentaires recommandées :
Dépannage - Problèmes courants et solutions
Compatibilité des versions - Quelles versions de Claude Desktop sont supportées
Journal des modifications - Historique des versions et modifications
Contribution - Comment d'autres peuvent contribuer (pour l'open source)
Meilleures pratiques :
Écriture claire et concise
Captures d'écran (optionnel mais très utile)
Instructions étape par étape
Liens vers des ressources supplémentaires
3. Processus de soumission
Comment soumettre au répertoire ?
Avant de soumettre au répertoire, complétez ce processus de soumission étape par étape :
1. Liste de contrôle pré-soumission :
Testez votre MCPB :
Passe les 4 phases de test (développement, environnement propre, multiplateforme, Claude Desktop)
Fonctionne dans un environnement propre sans outils de développement
Portable sur macOS et Windows
Dépendances actuelles et regroupées
Les messages d'erreur sont utiles et exploitables
Les performances sont acceptables
Vérifiez les exigences obligatoires :
Tous les outils ont des annotations readOnlyHint OU destructiveHint
Politique de confidentialité présente dans README.md
Politique de confidentialité présente dans le tableau privacy_policies de manifest.json
Utilisez la dernière version du manifeste pour la meilleure compatibilité
Minimum 3 exemples fonctionnels documentés dans le README
Identifiants de test fournis (le cas échéant)
Préparez la documentation :
README.md complet avec toutes les sections obligatoires
Fichier LICENSE inclus
Icône incluse (recommandée, PNG 512×512px)
CHANGELOG.md (optionnel mais recommandé)
2. Empaquetez la version finale :
# Nettoyage de la compilation
rm -rf node_modules/.cache
npm install --production
# Empaquetage
mcpb pack
# Vérifiez le paquet
mcpb info your-extension.mcpb
3. Soumettez via le formulaire officiel :
Formulaire de soumission : https://forms.gle/tyiAZvch1kDADKoP9
Informations obligatoires : Détails du serveur, liens de documentation, identifiants de test, exemples (minimum 3) et informations de contact. Le formulaire fournit une liste complète.
Bien que nous nous efforcions d'examiner chaque soumission aussi rapidement que possible, en raison du volume d'intérêt, nous ne pouvons pas promettre que nous accepterons votre soumission ou que nous y répondrons individuellement.
4. Problèmes courants
Quelles sont les raisons les plus courantes des demandes de révision ?
Ce sont les principaux problèmes basés sur les données de soumission :
1. Annotations d'outils manquantes
Problème : Les outils manquent des annotations readOnlyHint ou destructiveHint obligatoires
Correction : Ajoutez des annotations à TOUS les outils dans votre implémentation de serveur
Impact : Rejet immédiat, nécessite des modifications de code
Prévention : Exécutez la commande de validation avant la soumission