Brancher MesLeads sur votre assistant IA

Ce que ça donne. Votre assistant, Claude par exemple, interroge MesLeads directement : il découvre les 225 métiers du catalogue, évalue un ciblage, liste des entreprises, et déverrouille une fiche contre un crédit. Point d'entrée : https://mesleads.com/api/mcp

Ce que vous pouvez lui demander, outil par outil, avec les prix : la liste des outils. Cette page est engendrée par le catalogue que le serveur sert vraiment, donc elle ne peut pas vieillir.

Les guides écran par écran, par outil : Claude · Zapier · HubSpot · Pipedrive · Lemlist · Slack

---

Choisissez votre client

Les deux voies donnent le même accès, déverrouillage compris. Ce qui change, c'est l'endroit où vous décidez : sur l'écran d'autorisation pour OAuth, sur l'écran des clés pour une clé.

---

🔴 À LIRE AVANT TOUT : pourquoi « ça ne marche pas » n'est pas une panne

Une clé neuve ne peut RIEN déverrouiller. C'est le réglage par défaut, et c'est délibéré : un agent qui se trompe de requête dépenserait vos crédits sans que personne l'ait voulu.

Concrètement, votre assistant va :

• ✅ lister les métiers, compter, chercher, dire ce qu'une fiche contient ;
• ❌ refuser debloquer_fiche avec un message du type

*« Le déverrouillage est désactivé sur cette clé. Relevez son plafond depuis votre espace pour l'autoriser, il vaut 0 par défaut. »*

Ce refus est le fonctionnement normal, pas un bug. Pour l'autoriser il faut deux gestes explicites, décrits à l'étape 1 : cocher *Déverrouiller une fiche*, et renseigner un plafond quotidien supérieur à 0. Ni l'un ni l'autre n'est proposé par défaut.

Si vous ne faites rien d'autre que brancher le serveur, tout marchera sauf le déverrouillage. C'est voulu.

---

Étape 1 · Émettre une clé : mesleads.com/compte/cles

1. Connectez-vous, puis ouvrez Compte → Clés d'API (https://mesleads.com/compte/cles). 2. Dans le bloc « Créer une clé », cliquez l'onglet « Assistant IA (MCP) ». Les portées se recochent toutes seules pour cet usage. 3. Donnez-lui un nom dans le champ **« Nom : par exemple *Assistant IA (MCP) production* ». Ce nom est ce que vous verrez plus tard pour la révoquer : un nom par machine ou par assistant vaut mieux qu'un nom générique. 4. Sous « Ce que cette clé pourra faire »**, quatre cases :

5. Pour autoriser la dépense, et seulement si vous le voulez : cochez « Déverrouiller une fiche ». Un nouveau bloc apparaît alors : « Combien de fiches cette clé peut-elle déverrouiller par jour ? ». Il vaut 0, ce qui signifie *aucun déverrouillage*. Mettez le nombre que vous acceptez de voir dépenser dans une journée par un automate.

⚠️ Le champ n'existe pas tant que la case n'est pas cochée. Si vous ne voyez pas de plafond, c'est que la clé ne peut pas dépenser, et c'est bien.

6. « Créer la clé », puis « Votre clé, copiez-la maintenant ».

🔴 Elle ne sera plus jamais affichée. Nous n'en gardons qu'une empreinte, pas la clé : on doit pouvoir la *reconnaître*, jamais la *relire*. Perdue, elle se révoque et se remplace, elle ne se retrouve pas.

---

Étape 2 · Brancher : choisissez votre client

⚠️ Tous les clients ne se valent pas, et la différence porte exactement sur la clé. Le tableau ci-dessous est mesuré, pas supposé : voir « Ce qui ne marche pas encore » à la fin.

A · Claude Code : une commande

claude mcp add --transport http mesleads https://mesleads.com/api/mcp --header "Authorization: Bearer ml_VOTRE_CLE"

Puis, dans une session : /mcp liste les serveurs branchés et leurs outils.

B · Claude Desktop : le fichier de configuration

1. Menu Claude de la barre système (pas les réglages dans la fenêtre) → « Settings… ». 2. Onglet « Developer » dans la colonne de gauche → bouton « Edit Config ». Le fichier est :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

3. Ajoutez l'entrée mesleads :

{
  "mcpServers": {
    "mesleads": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mesleads.com/api/mcp",
        "--header", "Authorization:${CLE_MESLEADS}"
      ],
      "env": { "CLE_MESLEADS": "Bearer ml_VOTRE_CLE" }
    }
  }
}

⚠️ Pas d'espace autour du : dans --header. C'est une exigence de mcp-remote lui-même : l'espace casse le découpage de l'argument. L'espace après Bearer, lui, est normal : il vit dans la variable d'environnement.

⚠️ Pourquoi la clé passe par env et pas en clair dans args : les arguments d'un processus sont lisibles par tout autre utilisateur de la machine (ps). mcp-remote accepte aussi --header-file, un fichier Nom: valeur par ligne, si vous préférez.

4. Quittez complètement Claude Desktop et relancez-le. Il ne recharge pas la configuration à chaud. 5. Cliquez l'indicateur « Add files, connectors, and more » en bas à gauche de la zone de saisie → « Connectors » → « Manage connectors » → mesleads doit y figurer avec ses outils (la liste à jour est sur la page des outils).

C · claude.ai : connecteur personnalisé

1. Dans une conversation, menu « + » → « Connectors » → « Add custom connector ». 2. Nom : MesLeads. URL : https://mesleads.com/api/mcp. 3. Laissez « Advanced settings » vide : votre assistant s'enregistre tout seul auprès de MesLeads. 4. Validez, puis utilisez le connecteur une première fois. Un écran MesLeads s'ouvre et vous demande d'autoriser.

⚠️ C'est sur cet écran que tout se décide, et il n'y en aura pas d'autre :

• il nomme l'assistant qui demande et l'adresse où vous serez renvoyé.

Lisez-les : n'importe quel logiciel peut se déclarer sous le nom qu'il veut, mais l'adresse de retour est celle où vos données partiront vraiment ;

• vous cochez ce qu'il pourra faire ;
• 🔴 **si vous cochez « Déverrouiller une fiche », un plafond apparaît et il

vaut 0.** Tant qu'il vaut 0, l'assistant ne peut rien dépenser.

---

Étape 3 · Vérifier que c'est branché

Demandez simplement à votre assistant :

« Avec MesLeads, combien y a-t-il de couvreurs dans le Rhône ? »

Un assistant correctement branché appelle lister_metiers d'abord, le serveur le lui dit dans ses instructions d'accueil, puis compter_entreprises.

Pour vérifier la clé et le plafond, demandez :

« Combien de crédits MesLeads me reste-t-il ? »

mes_credits répond le solde du compte, le plafond du jour, et, si le plafond vaut 0, la phrase qui dit quoi faire.

---

Le tableau de sélection, et ce qui se passe sans lui

Quand vous demandez une recherche, certains clients affichent un tableau triable avec des cases à cocher : vous cochez les fiches qui vous intéressent, le bouton annonce le coût (« Déverrouiller 7 fiches, 7 crédits ») avant le clic, et chaque fiche part dans son propre appel.

C'est une extension du protocole (*MCP Apps*). Elle demande un client qui sache la rendre. Au 12 septembre 2026, les clients qui l'annoncent sont Claude et Claude Desktop, VS Code GitHub Copilot, Microsoft 365 Copilot, Goose, Postman, MCPJam et Archestra.AI, la liste à jour est tenue sur modelcontextprotocol.io/extensions/apps/overview.

⚠️ Un client qui ne sait pas l'afficher reste pleinement utilisable. Ce n'est pas une version dégradée du produit : c'est le produit, sans le tableau. La réponse texte porte déjà tout : nom, ville, secteur, tranche d'effectif, identifiant de chaque fiche, le total du marché, et la phrase qui dit quoi faire ensuite. Vous désignez les fiches à l'assistant en langage ordinaire (« déverrouille les trois de Villeurbanne »), et le résultat est identique, y compris le plafond et le crédit par fiche.

Vérifié : cette page a été écrite depuis un client sans rendu d'interface, en appelant le serveur en réel.

---

🔴 Ce que vous verrez dépend de votre assistant, pas de nous

MesLeads propose trois choses en plus des outils : des commandes toutes faites, une icône pour reconnaître le connecteur, et un tableau de résultats où cocher les fiches à déverrouiller. Les trois sont servies par notre serveur, et vérifiées à chaque livraison.

Chaque application choisit ce qu'elle en affiche, et aucune n'affiche tout aujourd'hui. Le 13 septembre 2026, trois clients nous ont signalé la même chose : pas de commandes, pas d'icône, pas de tableau, et dans les trois cas la mesure a donné le même verdict : notre serveur répond correctement, leur application ne le montre pas. Pour l'icône, c'est une limitation connue et ouverte chez Anthropic.

Ce qui décide que le branchement est bon, ce sont les OUTILS. Si votre assistant trouve des entreprises et déverrouille des fiches, tout fonctionne : le reste est de la présentation, et elle viendra de leur côté.

⚠️ Cherchez donc le défaut chez nous seulement si un outil ne répond pas. Une commande absente ou un tableau qui ne s'affiche pas n'est pas un signe que votre connexion est mauvaise.

---

Dépannage

---

Révoquer un accès

Clés et autorisations vivent au même endroit : mesleads.com/compte/cles. Une autorisation OAuth y apparaît au nom de l'assistant, marquée « Autorisé · OAuth ». Révoquer coupe les appels à venir immédiatement : cela ne rappelle pas ce qui est déjà parti.

Une limite, nommée

Le déverrouillage demande deux gestes, quelle que soit la voie : accorder la portée, et poser un plafond supérieur à 0. C'est délibéré : un agent qui se trompe de requête dépenserait vos crédits sans que personne l'ait voulu.