Guides
Publier votre serveur dans l'annuaire des connecteurs Claude
Prouver que l'API est la vôtre, préparer le serveur, le soumettre à Anthropic sous votre marque et garder ses outils stables.
Mis à jour le 5 octobre 2026
Pour les éditeurs : rendre votre serveur MCP trouvable dans Claude, où vos utilisateurs le connectent en un clic. C'est vous qui le soumettez à Anthropic, sous votre nom ; Apigent l'héberge et vous aide à passer la relecture. Guide compagnon : Distribuer votre serveur à vos utilisateurs.
Ce qu'il vous faut
- Un serveur MCP Apigent dont les applications appellent votre propre API : l'annuaire refuse les serveurs qui relaient l'API d'un tiers.
- Un abonnement Claude payant pour accéder au portail de soumission.
- Un compte de test bien rempli sur votre service, que les relecteurs d'Anthropic utiliseront.
- Une politique de confidentialité publique si votre service traite des données personnelles.
1. Prouver que l'API vous appartient
Réglages du workspace → Domaines de vos API. Ajoutez le domaine de l'URL de base de vos applications, puis publiez le jeton affiché d'une des deux façons :
| Méthode | Où | Ce qu'elle couvre |
|---|---|---|
| DNS | Un enregistrement TXT apigent-verification=<jeton> sur le domaine |
Le domaine et tous ses sous-domaines |
| Fichier | https://<domaine>/.well-known/apigent-verification.txt, contenant le jeton |
Ce seul hôte |
Cliquez sur Vérifier. La vérification est refaite chaque mois : laissez le jeton en place.
2. Préparer le serveur
Onglet Annuaire Claude du serveur. Les vérifications reprennent ce que la relecture contrôle :
- Ouvert à toute personne avec un compte (onglet Accès) : tout utilisateur de Claude doit pouvoir se connecter, avec un compte chez vous ou votre fournisseur d'identité.
- API vérifiées : chaque application du serveur appelle un domaine vérifié.
- Au moins un outil exposé.
- Titres et descriptions : un titre lisible pour chaque outil, et des descriptions qui décrivent l'outil, sans HTML ni consigne adressée au modèle (« appelle toujours cet outil »). La relecture les refuse.
Apigent s'occupe du reste : chaque outil porte un titre et l'annotation lecture seule ou destructive, l'authentification est en OAuth 2.0 avec enregistrement dynamique des clients, et les métadonnées du serveur annoncent son URL exacte.
3. Tester comme connecteur personnalisé
Dans Claude : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, avec l'URL du serveur (https://mcp.apigent.fr/<identifiant>, sans / final). Connectez-vous comme le ferait un utilisateur, puis appelez chaque outil. Le portail vous demandera de confirmer ce test.
4. Soumettre à Anthropic
Depuis le portail des développeurs Claude : Submit new → MCP connector. L'onglet Annuaire Claude affiche une fiche pré-remplie à copier :
- Connection : l'URL du serveur, en « Universal URL ».
- Listing : nom, accroche, description, documentation (la page publique du serveur), politique de confidentialité, icône, catégories.
- Authentication : OAuth avec enregistrement dynamique des clients.
- Data handling : API propre, hébergée par Apigent.
- Test & launch : les étapes de connexion et votre compte de test.
Anthropic analyse la soumission automatiquement et la publie d'abord comme connecteur Community ; certains passent ensuite en Verified après un test humain.
5. Garder les outils stables
Une fois la soumission faite, revenez dans l'onglet Annuaire Claude et cliquez sur Marquer comme publié (le lien de la fiche est facultatif). Tant que le serveur est marqué :
- il reste ouvert à toute personne avec un compte ;
- une resynchronisation de la spec qui ajoute, retire ou renomme des outils demande une confirmation ;
- les nouvelles opérations arrivent non exposées : à vous de les ouvrir ;
- vous êtes prévenu par email de chaque changement d'outils. Si votre fiche les décrit, mettez-la à jour dans le portail.
Les refus les plus fréquents
- API d'un tiers : seules vos propres API sont acceptées.
- Description qui donne des ordres au modèle, ou qui contient du HTML.
- Compte de test vide ou inutilisable sans votre aide.
- Politique de confidentialité absente ou incomplète.
- URL saisie avec un
/final : elle ne correspond plus exactement à celle que le serveur annonce.