Rémi Kokabi12 mars 202610 min de lectureMis à jour: 7 oct. 2026
Comment configurer lemlist MCP en 2 minutes (Claude, Cursor et plus)
La semaine dernière, j'ai demandé à Claude de récupérer les taux de réponse sur trois campagnes, de trouver celle qui fuyait, et de rédiger deux nouvelles relances. Je n'ai jamais ouvert lemlist. Le tout a pris quatre minutes, dont deux à relire les brouillons parce que je ne leur faisais pas encore confiance. Voilà ce qui se passe quand votre client IA peut parler directement à votre stack outbound, via le Model Context Protocol qu'Anthropic a annoncé en novembre 2024. Pas d'exports. Pas de copier-coller. Pas de changement d'onglet.
Nous avons conçu le lemlist serveur MCP pour que vous n'ayez plus jamais à coller une liste de leads dans un chat IA. Dans ce guide, je vous montre exactement comment le connecter, OAuth ou clé API, en moins de 2 minutes. Ensuite, je vous présente les catégories d'outils que vous débloquez, comment restreindre le connecteur quand vous voulez un agent ciblé, et le prompt exact que nous utilisons pour transformer Claude Code en opérateur lemlist dédié.
Il y a 2 méthodes d'authentification
Le serveur MCP de lemlist supporte deux façons de s'authentifier.
OAuth (recommandé). C'est le chemin le plus simple. Votre client IA gère tout le processus d'authentification automatiquement : il ouvre une fenêtre de navigateur, vous vous connectez et accordez l'accès à votre équipe lemlist, et c'est tout. Pas de gestion de clés, pas de copier-coller d'identifiants. Les tokens d'accès sont valides 1 heure et se rafraîchissent automatiquement pendant 30 jours. (Oui, le rafraîchissement du token se fait en arrière-plan, fini le re-collage de clés toutes les heures.)
Clé API. Si votre client ne supporte pas les flux OAuth, ou si vous préférez gérer les identifiants manuellement, vous pouvez vous authentifier avec une clé API lemlist. La clé est générée une seule fois dans lemlist et collée dans le fichier de configuration de votre client. Idéal pour Cursor, les environnements CI ou les intégrations custom.
Nous recommandons OAuth pour la plupart des équipes, parce que la méthode d'authentification est le truc auquel vous arrêterez de penser dans cinq minutes, et OAuth est l'option qui s'efface le plus vite. L'outbound devient piloté par les prompts. Moins il y a de friction entre une question dans votre tête et une réponse de vos données de campagne, plus votre journée est consacrée au jugement plutôt qu'aux clics.
⚠ Note importante : le serveur MCP utilise le header X-API-Key pour l'authentification, ce qui diffère de la méthode Basic Auth de l'API REST.
Configuration avec OAuth
Claude Desktop
Ouvrez la barre latérale, cliquez sur l'icône + à côté de Connectors, puis choisissez « Add custom connector ».
Renseignez :
Name : lemlist
Cliquez sur « Add ». La première fois que vous utilisez un outil lemlist, un onglet s'ouvre dans votre navigateur pour sélectionner votre équipe et accorder l'accès.
Ensuite, Claude gère les tokens en arrière-plan.
Vous pouvez aussi ajouter la configuration manuellement. Ouvrez claude_desktop_config.json et ajoutez :
{ "mcpServers": { "lemlist": { "command": "npx", "args": ["mcp-remote", "https://app.lemlist.com/mcp"] } } }
Le package mcp-remote gère tout le flux OAuth : découverte du client, consentement dans le navigateur, échange de tokens PKCE et rafraîchissement automatique. Si vous voulez savoir exactement ce que fait chaque étape, la spécification MCP publiée par modelcontextprotocol.io est la référence officielle, définie à partir du schéma TypeScript dans schema.ts.
Claude Code
Exécutez cette commande dans votre terminal :
claude mcp add --transport http lemlist https://app.lemlist.com/mcp
Pas besoin du flag --header. Au premier lancement, votre navigateur ouvrira une page de consentement. Une fois l'autorisation donnée, vous êtes connecté.
💡 Vous pouvez configurer une commande d'agent lemlist personnalisée dans Claude Code. Enregistrez le prompt de l'agent dans .claude/commands/lemlist-agent.md, puis appelez-le avec /lemlist-agent pour obtenir un assistant préconfiguré pour la gestion de campagnes.
Configuration avec une clé API
Étape 1 - Générez votre clé API lemlist
Connectez-vous à lemlist et allez sur app.lemlist.com
Allez dans Settings > Team > Integrations
Cliquez sur « Generate » pour créer une nouvelle clé API
Copiez la clé et conservez-la en lieu sûr. Vous ne pourrez plus la voir après avoir quitté la page.
Étape 2 - Ajoutez votre clé à votre client
Cursor
Allez dans Settings > Tools & MCP > New MCP Server, puis ajoutez :
{ "mcpServers": { "lemlist": { "url": "https://app.lemlist.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } }
Claude Desktop (npm)
Allez dans Settings/Developer/Edit Config dans votre application.
Ajoutez un bloc « lemlist » au fichier claude_desktop_config.json, comme dans cet exemple :
Pour les utilisateurs Mac
{ "mcpServers": { "lemlist": { "command": "npx", "args": [ "mcp-remote", "https://app.lemlist.com/mcp", "--header", "X-API-Key: ${API_KEY}" ], "env": {"API_KEY": "... YOUR API KEY ..." } } } }
Pour les utilisateurs Windows
{ "lemlist": { "command": "C:\\PROGRA~1\\nodejs\\npx.cmd", "args": [ "mcp-remote", "https://app.lemlist.com/mcp", "--header", "X-API-Key: ${API_KEY}" ], "env": { "API_KEY": "... YOUR API KEY ..." } } }
Redémarrez Claude, puis allez dans la section Developer.
Claude Code
claude mcp add --transport http lemlist https://app.lemlist.com/mcp --header "X-API-Key:YOUR_API_KEY"
Attention : gardez toujours votre clé API hors du contrôle de version. Si vous travaillez sur un repo partagé, utilisez des variables d'environnement plutôt que de coder la clé en dur dans votre fichier de configuration.
Ce que vous pouvez faire une fois connecté
Demandez directement à votre assistant IA : « Quelles opérations lemlist peux-tu effectuer ? » Il renverra la liste la plus à jour. Les outils disponibles évoluent chaque jour, considérez donc tout ce qui est écrit ici comme un instantané.
Les catégories principales incluent :
Gestion de campagnes. Créez, modifiez, mettez en pause ou supprimez des campagnes directement depuis le chat.
Gestion des leads. Mettez à jour, mettez en pause ou supprimez des leads dans une campagne active sans toucher à l'interface.
Sourcing de leads. Recherchez dans lemleads par critères ICP (poste, secteur, taille d'entreprise, localisation).
Enrichissement email. Trouvez et vérifiez des emails, et accédez aux options d'enrichissement que vous déclencheriez normalement à la main.
Équipe et statistiques. Récupérez les taux d'ouverture, les taux de réponse et les funnels de conversion pour n'importe quelle période, sur toutes les équipes que vous avez autorisées.
Webhooks. Créez et inspectez les abonnements webhook pour que vos systèmes en aval restent synchronisés.
Templates de messages et snippets. Rédigez et réutilisez des séquences multi-étapes avec des variables et un timing de relances.
L'agent lemlist pour Claude Code
Une fois le MCP connecté, vous pouvez aller plus loin et configurer une commande d'agent lemlist dédiée dans Claude Code. Vous obtenez un assistant expert préconfiguré qui sait auditer des campagnes, sourcer des leads et rédiger des séquences sans que vous ayez à réexpliquer le contexte à chaque fois. Si vous voulez que cet agent se concentre sur une seule tâche, limitez son connecteur avec des buckets (détails juste en dessous).
Comment le configurer
Créez un fichier .claude/commands/lemlist-agent.md dans le dossier de votre projet. Collez-y le prompt suivant :
# Lemlist Expert Agent You are now an expert Lemlist automation specialist. Your role is to help users maximize their cold outreach campaigns using the lemlist platform through the MCP lemlist tools available to you. ## Your Core Identity You are a seasoned growth hacker specializing in: - B2B cold email outreach strategies - Lemlist campaign optimization - Lead generation and qualification - Email copywriting and A/B testing - Sales automation workflows ## Your Approach When a user asks for help, follow this systematic methodology: ### 1. Discovery Phase - Start by auditing existing campaigns using `get_campaigns` - Understand the user's business context, target audience, and goals - Analyze current performance metrics with `get_campaign_stats` ### 2. Strategy Phase - Identify opportunities for improvement - Propose data-driven recommendations - Suggest lead sources using `lemleads_search` for the user's ICP (Ideal Customer Profile) ### 3. Execution Phase - Create or optimize campaigns with best practices - Write compelling email sequences following proven copywriting frameworks (AIDA, PAS, BAB) - Set up proper follow-up sequences with strategic timing ### 4. Optimization Phase - Monitor performance metrics - Suggest A/B testing opportunities - Iterate based on data ## Key Best Practices ### Email Copywriting - Personalization beyond {{firstName}} (mention company, industry, recent news) - Keep emails under 100 words - One clear CTA per email - Avoid salesy language, focus on value ### Campaign Strategy - Test sending times (Tuesday-Thursday, 8-10am or 2-4pm in recipient timezone) - Space follow-ups (Day 3, 7, 14 pattern) - Mix question-based and value-based emails ### Lead Quality - Quality > Quantity: Better 50 targeted leads than 500 generic ones - Verify emails before campaigns to protect sender reputation - Segment by persona for tailored messaging ## Safety Protocols - Always warn about credit costs before using: findEmail, verifyEmail, linkedinEnrichment, findPhone - Always preview before updating live campaigns - Require confirmation before modifying running campaigns - Check campaign status before making changes Now, ask the user: "What would you like to accomplish with lemlist today?"
Ensuite, ouvrez Claude Code et tapez /lemlist-agent pour l'activer.
💡 Voyez-le comme une couche de contexte persistante. À chaque appel de /lemlist-agent, Claude démarre la conversation en sachant déjà comment gérer les campagnes lemlist de bout en bout.
Avancé : limitez la portée de votre connecteur
Par défaut, votre client charge tous les outils lemlist. C'est bien pour explorer. C'est bruyant quand vous savez ce que vous voulez, et c'est difficile à défendre auprès d'une équipe sécurité qui préférerait que votre agent de prospection ne voie jamais les outils d'édition de campagnes.
Ajoutez un paramètre ?bucket= à l'endpoint pour ne charger que les groupes d'outils dont vous avez besoin :
https://app.lemlist.com/mcp?bucket=prospecting,crm
Buckets disponibles : core, builder, prospecting, crm, engagement, deliverability, insights. Séparez-les par des virgules, autant que nécessaire.
Deux avantages concrets. Moins d'outils exposés signifie moins d'appels erronés de la part du modèle, ce qui compte plus qu'on ne le pense sur les sessions longues. Et vous pouvez faire tourner plusieurs entrées de connecteur en parallèle : une limitée à prospecting pour votre agent de sourcing, une autre limitée à insights pour un agent de reporting en lecture seule qui ne peut pas toucher à une campagne active.
Questions fréquentes
Faut-il payer un supplément pour utiliser le serveur MCP ? Non. Le serveur MCP de lemlist est accessible à tous les utilisateurs lemlist. Il vous suffit d'avoir un compte lemlist actif et un client IA compatible MCP.
Quelle est la différence concrète entre OAuth et une clé API ? OAuth fonctionne par session. Les tokens expirent et se rafraîchissent automatiquement, donc rien à gérer. Une clé API est permanente tant que vous ne la révoquez pas, ce qui est plus pratique pour les environnements automatisés mais demande de la vigilance pour éviter les fuites d'identifiants.
Mon navigateur ne s'est pas ouvert pendant le flux OAuth. Que faire ? Vérifiez que mcp-remote est installé et que votre terminal a les permissions pour ouvrir des URL. Vous pouvez aussi lancer npx mcp-remote https://app.lemlist.com/mcp manuellement pour voir l'URL de consentement et l'ouvrir vous-même.
Puis-je connecter plusieurs équipes lemlist ? Oui. Lors de l'étape de consentement OAuth, vous sélectionnez l'équipe à autoriser. Pour connecter plusieurs équipes, créez des entrées de serveur MCP séparées dans votre configuration, une par équipe.
Quels clients IA sont supportés ? Les clients officiellement documentés sont Claude Desktop, Claude Code et Cursor. Tout client supportant MCP via HTTP devrait fonctionner avec l'endpoint https://app.lemlist.com/mcp.
Puis-je utiliser lemlist MCP en dehors de Claude et Cursor ? Oui, et beaucoup le font déjà. L'endpoint est du MCP standard via HTTP, donc tout client qui parle le protocole peut l'appeler. Le pattern le plus intéressant que l'on observe, ce sont les agents embarqués dans un CRM : Attio, par exemple, documente l'appel aux outils MCP de lemlist dans une étape de workflow Custom agent, pour qu'une mise à jour de fiche CRM déclenche des actions lemlist sans intervention humaine. Des intégrations tierces existent aussi, dont un Claude Code Skill pour lemlist développé par Composio, un chemin non officiel mais fonctionnel. L'écosystème MCP grandissant sur GitHub compte plus de 51 000 followers sur la page de l'organisation du protocole, et de nouveaux clients sortent en permanence. Si vous préférez une connexion no-code, notre page intégrations couvre les options hors MCP.
Vous pouvez aussi consulter la documentation officielle de l'API et du MCP ici.
Pour conclure
Connecter le MCP prend deux minutes. Le vrai gain arrive plus tard, la première fois que vous détectez une séquence qui s'essouffle avec une simple question au lieu de fouiller un dashboard un lundi matin.
Commencez par OAuth, confirmez qu'un appel en lecture seule fonctionne (les stats de campagne sont un bon premier test), puis ajoutez la commande /lemlist-agent et limitez vos buckets. À partir de là, vous pouvez lancer des campagnes multicanales de bout en bout sans quitter votre fenêtre de chat.
Vous n'avez pas encore de compte lemlist ? Démarrez l'essai gratuit de 14 jours. Pas de carte bancaire requise, accès complet à toutes les fonctionnalités, et le serveur MCP est inclus dans tous les plans (lemlist est noté 4,6/5 sur G2).
Lancez vos campagnes outbound IA
Automatisez votre prospection et personnalisez vos séquences IA pour décrocher plus de rendez-vous.