Passer au contenu principal

Guide de soumission de serveur MCP local

Mis à jour cette semaine

Ceci est un guide complet pour soumettre votre serveur local (MCPB) au répertoire public d'Anthropic pour une distribution et une découvrabilité plus larges.

Prérequis

Avant de lire ce guide, vous devriez avoir :

  • Un MCPB fonctionnel

  • Du 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 Créer des extensions MCPB. Pour les meilleures pratiques techniques (tests, messages d'erreur, portabilité), consultez le dépôt MCPB.

Remarque : Ce guide couvre les serveurs MCP locaux. Pour les extensions de bureau distantes, consultez le Guide de soumission de serveur MCP distant.


1. Aperçu du répertoire

Quels sont les avantages de l'inclusion dans le répertoire ?

Découvrabilité et confiance :

  • Répertorié dans le répertoire officiel d'Anthropic dans Claude Desktop

  • Recherchable par les utilisateurs individuels de Claude Desktop

  • Visible pour les utilisateurs Teams/Enterprise lorsqu'il est ajouté à la liste autorisée par les administrateurs

  • L'examen d'Anthropic renforce la confiance des utilisateurs

Expérience utilisateur :

  • Installation en un clic depuis le répertoire

  • Intégré à l'interface utilisateur des paramètres de Claude Desktop

  • Présentation standardisée

Support et crédibilité :

  • Examen de la qualité et de la sécurité par Anthropic

  • Répertorié aux côtés d'autres extensions examinées

  • Visibilité et retours de la communauté

  • 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 le README du dépôt MCPB.


Les annotations d'outils sont-elles obligatoires ?

OUI. Chaque outil DOIT avoir et maintenir des annotations de sécurité précises.

Requis sur chaque outil :

  • readOnlyHint: true - Pour les outils qui ne font que lire des données

  • destructiveHint: true - Pour les outils qui modifient des données ou ont des effets secondaires

Consultez Protocole MCP - Annotations d'outils pour le schéma complet et les détails d'implémentation.

Ce n'est pas optionnel. Il s'agit d'une exigence stricte dérivée de la Politique du répertoire MCP.

Comment décider quelle annotation utiliser :

Comportement de l'outil

Annotation

Exemples

Ne fait que lire des données

readOnlyHint: true

search, get, list, fetch, read

Écrit/modifie des données

destructiveHint: true

create, update, delete, send, write

Crée des fichiers temporaires

destructiveHint: true

Même les écritures temporaires comptent

Envoie des requêtes externes

destructiveHint: true

E-mails, notifications, webhooks

Met en cache en interne uniquement

readOnlyHint: true

Optimisation interne OK

Détails d'implémentation : Consultez Protocole MCP - Outils pour :

  • Schéma complet des outils avec annotations

  • Structure de définition des outils

  • Spécifications du schéma d'entrée/sortie

  • Propriétés d'outils supplémentaires (y compris le champ title optionnel)

Validation avant 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 :

Avez-vous trouvé la réponse à votre question ?