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 depuis le répertoire
Intégration avec 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 de 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.