Publier un serveur MCP sur le store de Claude : le playbook complet, de zéro à « Approved »
Benjamin Joseph Benoudis
15 novembre 2026 · 16 min de lecture
Salut, c'est Benou.
Cette semaine, mon serveur MCP est entré dans l'annuaire officiel des connecteurs Claude. Celui de Viewlify, mon outil d'analyse TikTok.
Soumis le soir. Approuvé dans la nuit par la revue automatique. Publié le lendemain matin.
Il m'a fallu deux jours pour y arriver, parce que je me suis pris tous les murs un par un. Avec ce playbook, tu peux le faire en une soirée.
Je te donne tout : ce qu'est un MCP, comment on le construit, comment on le teste, les 10 étapes du formulaire, les 7 engagements à signer, les pièges, et ce qu'il faut faire après pour être vu.
Ce qu'il faut retenir en 30 secondes
| Étape | Ce qui compte vraiment |
|---|---|
| Construire | Un serveur distant en HTTP, quelques outils bien nommés |
| Décrire | Chaque outil dit ce qu'il renvoie, rien d'autre. Aucune consigne au modèle |
| Annoter | 5 annotations sur chaque outil, sinon la revue bloque |
| Tester | En prod, avec un vrai client MCP, et dans Claude lui-même |
| Préparer | 3 URL publiques : documentation, support, confidentialité |
| Soumettre | 10 étapes, dans un seul onglet, sans jamais le recharger |
| Signer | 7 engagements, tous obligatoires, tous vrais |
| Après | Publier toi-même, soigner l'icône, te faire lister ailleurs |
C'est quoi un MCP, en une image
MCP, c'est le Model Context Protocol. Une prise standard entre une IA et ton produit.
Avant, pour que Claude parle à ton outil, il fallait que toi, tu lui copies tes données dans la conversation. Avec un MCP, Claude branche la prise et va chercher lui-même ce dont il a besoin.
Concrètement, ton serveur MCP expose des outils. Un outil, c'est une fonction avec un nom, une description et des paramètres. Chez moi, get_outliers renvoie les vidéos TikTok qui font beaucoup plus de vues que d'habitude pour leur créateur.
L'utilisateur demande à Claude « qu'est-ce qui décolle en fitness ce mois-ci ? ». Claude voit qu'il a un outil pour ça, l'appelle, lit la réponse et la commente.
Et le store, c'est l'annuaire officiel : claude.ai/directory. Les utilisateurs de Claude y trouvent les connecteurs et les ajoutent en un clic. Pour un SaaS, c'est un canal d'acquisition : tes futurs clients te trouvent là où ils travaillent déjà.
Étape 1 : choisir ce que ton MCP fait (et ce qu'il ne fait pas)
Avant d'écrire une ligne de code, réponds à trois questions.
Quels outils ? Peu, et bien découpés. Trois à six outils pour commencer. Chaque outil répond à une question que ton utilisateur pose vraiment. Pas un outil par route de ton API.
Lecture seule ou écriture ? Un serveur qui ne fait que lire est le chemin le plus simple. Pas d'action risquée, presque rien à justifier dans le formulaire. Mon serveur public ne fait que lire. Le seul outil qui « crée » quelque chose génère un lien de paiement, et rien n'est débité tant que l'utilisateur ne paie pas.
Avec ou sans connexion ? Trois options :
| Mode | Ce que ça demande | Pour la revue |
|---|---|---|
| Sans authentification | Rien | Le plus simple |
Clé API (en-tête Authorization: Bearer) | Une page où l'utilisateur crée sa clé | Simple |
| OAuth 2.1 | Un vrai flux de connexion | Il faut fournir un compte de test qui marche |
J'ai pris un mélange malin : sans clé, les outils publics répondent avec un aperçu de 5 résultats (20 appels par jour et par IP). Avec une clé, on a tout. Résultat : n'importe qui peut essayer dans Claude en dix secondes, et la revue n'a besoin d'aucun compte de test.
Si ton produit exige une connexion, garde quand même un ou deux outils publics en aperçu. C'est ta vitrine.
Étape 2 : construire le serveur
Le store veut un serveur distant : une URL publique en HTTPS que Claude appelle. Pas un programme que l'utilisateur installe sur sa machine.
Le transport s'appelle Streamable HTTP. Derrière le nom, c'est simple : Claude envoie des requêtes POST en JSON-RPC sur une seule URL (chez moi https://viewlify.app/api/mcp), ton serveur répond en JSON.
Tu as deux chemins :
- Le SDK officiel
@modelcontextprotocol/sdk(TypeScript) ou son équivalent Python. Il gère le protocole pour toi. - À la main, dans une route de ton app existante. C'est ce que j'ai fait : une seule route dans mon app TanStack Start sur Cloudflare Workers, à côté du reste du site. Pas de serveur en plus à maintenir.
Voici le squelette, réduit à l'essentiel :
const TOOLS = [
{
name: "get_outliers",
description:
"TikTok videos beating their own creator's usual views by the widest margin, optionally for a niche. Each result includes the outlier multiple and the creator's baseline.",
inputSchema: {
type: "object",
properties: {
niche: { type: "string", description: "Niche slug, e.g. fitness" },
limit: { type: "number", description: "Max results (1-50)" },
},
},
annotations: {
title: "TikTok breakout videos",
readOnlyHint: true,
destructiveHint: false,
idempotentHint: true,
openWorldHint: false,
},
},
];
const json = (body: unknown) =>
new Response(JSON.stringify(body), { headers: { "content-type": "application/json" } });
export async function handleMcp(request: Request) {
// Pas de flux serveur : la spec demande alors un 405 sur GET.
if (request.method === "GET") return new Response(null, { status: 405 });
const { id, method, params } = await request.json();
const result = (r: unknown) => json({ jsonrpc: "2.0", id, result: r });
switch (method) {
case "initialize":
return result({
protocolVersion: "2024-11-05",
capabilities: { tools: {} },
serverInfo: { name: "Mon serveur MCP", version: "1.0.0" },
});
case "notifications/initialized":
return new Response(null, { status: 202 }); // une notification n'attend pas de réponse
case "ping":
return result({});
case "tools/list":
return result({ tools: TOOLS });
case "tools/call": {
const data = await callTool(params.name, params.arguments ?? {});
return result({ content: [{ type: "text", text: JSON.stringify(data) }] });
}
default:
return json({ jsonrpc: "2.0", id, error: { code: -32601, message: `Method not found: ${method}` } });
}
}
Quatre méthodes et tu as un serveur MCP qui marche : initialize, tools/list, tools/call, et la notification notifications/initialized.
Ajoute les en-têtes CORS et une réponse à OPTIONS si des clients web doivent t'appeler. Et mets une limite d'appels par IP sur tout ce qui est public, sinon le premier robot venu vide ta base.
Étape 3 : les descriptions d'outils, ton vrai texte de vente
C'est là que la plupart des serveurs se plantent sans le savoir.
Claude choisit ses outils en lisant leurs descriptions. Elles doivent donc être claires. Mais l'annuaire les lit aussi comme une règle, et l'un des 7 engagements du formulaire est très strict :
Les descriptions d'outils ne contiennent aucune consigne sur le comportement du modèle, aucune référence à d'autres outils, aucune source d'instructions externe, et aucun texte caché ou encodé.
Donc, interdit dans une description :
- « Always call
get_balancefirst » - « Never tell the user the internal price »
- « Ask the user before doing X »
- « Use this tool instead of
searchwhen… »
Ce genre de consigne, tu le mets dans la réponse de l'outil. Par exemple, mon aperçu sans clé renvoie un champ note qui explique comment obtenir les résultats complets. La description, elle, dit seulement ce que l'outil fait et ce qu'il renvoie.
Une bonne description, c'est :
- Ce que l'outil renvoie, concrètement (les champs qui comptent).
- Les filtres possibles.
- Les limites (taille de l'aperçu sans clé, plafond de résultats).
Et deux outils ne doivent jamais se ressembler. Glama, un autre annuaire, m'a mis 3 sur 5 en « Disambiguation » parce que get_trending et get_trending_hashtags renvoyaient tous les deux des hashtags. J'ai réécrit : le premier est « a full snapshot » (vidéos, hashtags et sons), le second commence par « Hashtags only, no videos or sounds ». Plus d'hésitation possible.
Étape 4 : annoter chaque outil
C'est le premier truc que la revue m'a reproché. Chaque outil doit porter des annotations MCP :
| Annotation | Ce qu'elle dit |
|---|---|
title | Un nom lisible par un humain (« TikTok breakout videos ») |
readOnlyHint | true si l'outil ne modifie rien |
destructiveHint | true s'il peut supprimer ou écraser quelque chose |
idempotentHint | true si l'appeler deux fois donne le même effet |
openWorldHint | true s'il touche au monde extérieur (envoyer un mail, publier) |
Les miennes n'en avaient aucune. Pour ne plus jamais en oublier, j'ai écrit une petite fonction qui les ajoute à tous les outils au moment de les lister :
function annotate(tool) {
const writes = tool.name === "top_up"; // le seul outil qui crée quelque chose
return {
...tool,
annotations: {
title: TITLES[tool.name] ?? tool.name,
readOnlyHint: !writes,
destructiveHint: false,
idempotentHint: !writes,
openWorldHint: false,
},
};
}
Un nouvel outil ajouté demain passe forcément par là.
Étape 5 : tester pour de vrai
Trois tests, dans cet ordre.
1. Avec un vrai client MCP, sur la prod. Pas en local, pas avec un curl approximatif. J'utilise le client du SDK officiel (@modelcontextprotocol/sdk) dans un petit script : il se connecte à l'URL de prod, liste les outils et en appelle chacun. Si ça marche là, ça marchera chez Claude.
2. Avec l'inspecteur officiel. npx @modelcontextprotocol/inspector, tu colles ton URL, tu vois tes outils, tu les lances un par un avec des paramètres. Parfait pour voir exactement ce que Claude recevra.
3. Dans Claude lui-même. Paramètres, Connecteurs, « Ajouter un connecteur personnalisé », ton URL. Puis tu poses de vraies questions et tu regardes si Claude choisit le bon outil.
Ce troisième test compte double : dans le formulaire, il y a une case « Self-tested » qui dit que tu as lancé chaque outil, par l'inspecteur ou en connecteur personnalisé. Ne la coche que si c'est vrai. Je l'avais oubliée la première fois : le récapitulatif affichait « Not tested ».
Étape 6 : préparer ce que le formulaire va te demander
Avant d'ouvrir le formulaire, prépare tout dans un fichier texte. Tu vas comprendre pourquoi juste après.
- Nom et slug (l'identifiant dans l'URL). Le slug est définitif après soumission.
- Une phrase d'accroche : 200 caractères maximum.
- Une description : 2 000 caractères maximum. Ce que fait le serveur, pour qui, avec quelles données.
- Jusqu'à 5 catégories.
- Des cas d'usage : des exemples de questions qu'on pose à Claude avec ton connecteur.
- Le nom de l'entreprise et un e-mail de contact. La réponse d'Anthropic arrive sur cet e-mail : prends une adresse que tu lis vraiment.
- Trois URL publiques, obligatoires : la documentation, le support (une page ou un e-mail) et la politique de confidentialité.
- La gestion des données : ce que tu stockes, combien de temps, ce que tu ne gardes pas.
- Les instructions de test : de quoi permettre à un relecteur d'entrer seul. Si ton serveur demande une connexion, fournis un compte de test rempli et toutes les étapes pour y arriver.
Ma documentation, c'est le README de mon dépôt GitHub public viewlify-mcp plus une page sur le site. Ça suffit.
Étape 7 : les 10 étapes du formulaire
Le portail est sur claude.ai/directory/manage, bouton « Submit an MCP connector ». Il faut un compte Claude rattaché à une organisation.
Les 10 étapes, dans l'ordre :
- Connection : l'URL de ton serveur.
- Connection & authentication : le mode (aucun, clé, OAuth).
- Listing : nom, slug, accroche, description, catégories.
- Use cases : tes exemples.
- Company : entreprise et contact.
- Authentication : le détail de la connexion si tu en as une.
- Data handling : ce que tu fais des données.
- Test & launch : les instructions pour le relecteur et la case « Self-tested ».
- Compliance : les 7 engagements.
- Review and submit : le récapitulatif, puis « Submit for review ».
Trois pièges qui m'ont coûté des heures.
Le brouillon vit seulement dans ton onglet. Pas sur un serveur, dans la mémoire de l'onglet. Tu le recharges, tu navigues ailleurs dedans, et tes 10 étapes sont parties. D'où le fichier texte préparé à l'avance.
L'ajout du serveur peut répondre « 429 Rate limited » pendant des heures. J'ai perdu un après-midi à réessayer. Ne martèle pas le bouton : reviens plus tard.
Lis les « advisory notes » au récapitulatif. Ce sont des remarques, pas des blocages. Par exemple, un e-mail de contact sur un autre domaine que ton compte Claude : ça passe.
Étape 8 : les 7 engagements
Tous obligatoires. Tu certifies que :
- Tu as lu les règles de l'annuaire (les « MCP Directory developer guidelines »). Lis-les vraiment.
- Ton serveur appelle tes propres API, ou des API que tu relaies avec autorisation.
- Il ne transfère ni argent, ni crypto, ni autre actif financier pour l'utilisateur.
- Il n'utilise pas de modèle d'IA pour générer des images, de la vidéo ou du son.
- Les descriptions d'outils ne contiennent aucune consigne au modèle (voir l'étape 3).
- Il ne collecte pas de données de conversation au-delà de ce qu'exige sa fonction.
- La documentation publique sera en ligne le jour de la publication.
Ne coche jamais une case fausse pour faire passer ta soumission.
J'ai voulu soumettre un deuxième serveur, celui de BeReach, mon SaaS de prospection LinkedIn. Deux engagements bloquaient. Ses descriptions d'outils étaient pleines de consignes au modèle (« demande à l'utilisateur avant de… »). Et ses outils d'envoi agissent sur LinkedIn sans autorisation de LinkedIn, donc l'engagement numéro 2 n'est pas vrai pour eux. Avant de soumettre, il faut soit nettoyer, soit sortir ces outils de la version store. Mieux vaut le savoir avant qu'après.
Étape 9 : la revue
J'ai soumis le soir. Quelques heures plus tard, un e-mail : approuvé comme « community connector » par une revue automatique.
Ce que la revue regarde, d'après ce qu'elle m'a reproché et ce qui est passé :
- les annotations sur chaque outil ;
- des descriptions propres, sans consignes ;
- un serveur qui répond, avec les outils annoncés ;
- les trois URL publiques en ligne ;
- des engagements cohérents avec ce que fait vraiment le serveur.
Étape 10 : publier, c'est toi qui le fais
« Approved » ne veut pas dire « en ligne ».
L'e-mail contient un lien vers ton espace de soumission (claude.ai/admin-settings/directory/submissions/<ton-slug>). Tu cliques sur « Publish ». La fiche publique apparaît ensuite, avec le badge « Community ». La mienne : claude.ai/directory/viewlify.
Elle peut mettre un moment à s'afficher après la publication. Pas de panique.
Le piège de l'icône floue
Ma fiche est sortie avec une icône pixelisée. Pourquoi ? Sans icône fournie, l'annuaire va chercher le favicon de ton domaine par le service de favicons de Google. Mon site n'avait qu'un favicon en SVG, et Google n'en avait gardé qu'une version de 32 pixels, agrandie et donc floue.
La correction, en deux temps :
- Ajouter de vraies icônes PNG au site :
favicon.ico(16, 32 et 48 pixels), une 192, une 512 et uneapple-touch-iconde 180, déclarées dans le<head>. - Dans la fiche, section « Description and icon », mettre l'URL de l'icône 512 dans le champ « Icon ».
Attention : toute modification de la fiche publiée repart en relecture. L'ancienne version reste en ligne jusqu'à l'approbation. Fais-le donc avant de soumettre.
Bonus : le plugin Claude Code
Si tu veux aussi être dans Claude Code, tu peux publier un plugin : ton serveur MCP plus des « skills » (des recettes en Markdown qui apprennent à Claude à enchaîner tes outils).
La revue des plugins est plus stricte que celle des connecteurs. Deux leçons :
Pour une organisation non vérifiée, le dépôt ne contient que du texte. Markdown, texte, JSON, YAML et images. Mon dossier avec du code JavaScript a été bloqué. Le dépôt du plugin est devenu skills et manifestes uniquement.
Jamais de clé dans une variable d'environnement en en-tête. Mon .mcp.json envoyait Authorization: Bearer ${VIEWLIFY_API_KEY}. Résultat : quatre blocages. La bonne méthode, c'est userConfig dans plugin.json, avec sensitive: true :
"userConfig": {
"api_key": {
"type": "string",
"sensitive": true
}
}
Et ${user_config.api_key} dans l'en-tête. Claude Code demande alors la clé à l'installation, et elle peut rester optionnelle.
Après le store : te faire lister partout
L'annuaire Claude n'est pas le seul endroit où les gens cherchent des MCP. Trois réflexes.
Le registre officiel MCP. Un fichier server.json dans ton dépôt, puis mcp-publisher login github et mcp-publisher publish. Beaucoup d'annuaires se servent de ce registre. À chaque nouvelle version de ton serveur, monte le numéro et republie.
Glama. Il m'a indexé tout seul à partir du registre et de GitHub, avec une note de qualité par outil (j'ai eu A). Pour revendiquer ta fiche et voir tes statistiques, ajoute un fichier glama.json à la racine du dépôt, avec ton pseudo GitHub dans maintainers.
Les listes « awesome » sur GitHub, comme awesome-remote-mcp-servers. Une pull request d'une ligne. Un robot vérifie que ton marqueur d'authentification correspond à ce que ton serveur répond vraiment (cadenas ouvert sans authentification, clé pour une clé API, cadenas fermé pour OAuth). Le mien affichait une clé alors que le serveur répond sans : corrigé, puis on attend que le mainteneur fusionne. Il fusionne par vagues, ça peut prendre des semaines.
Comment Claude m'a aidé
Claude Code a fait l'essentiel : la fonction d'annotations, le nettoyage du plugin, le passage à userConfig, la publication dans le registre, les icônes, et même le remplissage du formulaire dans mon navigateur.
J'ai gardé pour moi deux choses : cocher les 7 engagements, et cliquer sur « Publish ». Parce que c'est moi qui signe.
La checklist à copier
| ✓ | À faire |
|---|---|
| ☐ | 3 à 6 outils, chacun répond à une vraie question |
| ☐ | Descriptions : ce que l'outil renvoie, aucune consigne au modèle, aucun renvoi vers un autre outil |
| ☐ | Deux outils ne se ressemblent jamais |
| ☐ | Les 5 annotations sur chaque outil |
| ☐ | Limite d'appels sur les outils publics |
| ☐ | Testé en prod avec un vrai client MCP |
| ☐ | Chaque outil lancé dans l'inspecteur ou dans Claude |
| ☐ | Documentation, support et confidentialité en ligne |
| ☐ | Icônes PNG sur ton site, icône 512 prête |
| ☐ | Toutes les réponses du formulaire dans un fichier texte |
| ☐ | Un seul onglet, jamais rechargé |
| ☐ | 7 engagements lus, tous vrais |
| ☐ | Après l'approbation : Publish |
| ☐ | Registre officiel, Glama, listes awesome |
Si tu as un SaaS avec des données utiles, fais-le. Ça prend une soirée, et tu deviens un outil que Claude peut appeler pour tes futurs clients.
Tu veux voir à quoi ressemble un petit serveur MCP en lecture seule, utilisable sans clé ? Le mien est sur viewlify.app, l'URL du connecteur est https://viewlify.app/api/mcp.
Ce genre de retour d'expérience, je le partage dans ma newsletter : ce que je construis, avec les vrais chiffres et les vrais murs.
À toute, Benou