Le serveur MCP de lemlist permet aux clients IA (comme Claude, Claude Code, Cursor, ChatGPT ou Codex) d’interagir en toute sécurité avec votre espace de travail lemlist via MCP (JSON-RPC sur HTTP). Selon votre environnement et vos préférences de sécurité, vous pouvez vous authentifier avec OAuth (recommandé, sans clé API) ou avec une clé API.

Ce que vous allez apprendre

À la fin de ce tutoriel, vous saurez connecter le serveur MCP de lemlist à Claude, Claude Code, Cursor, ChatGPT ou Codex avec OAuth (recommandé lorsque cette option est disponible) ou une clé API, puis vérifier que la connexion fonctionne.

Pourquoi c’est important

Une fois le serveur MCP de lemlist connecté, votre client IA peut vous aider à auditer vos campagnes, à créer ou à modifier vos séquences et à gérer vos prospects, sans passer d’un outil à l’autre. OAuth simplifie la gestion des secrets d’authentification, tandis que les clés API offrent une solution simple pour les environnements qui ne prennent pas en charge les flux OAuth.

Avant de commencer

Vous avez un compte lemlist et accès à l’équipe ou à l’espace de travail que vous souhaitez connecter.
Vous utilisez l’un des clients compatibles : Claude (web, application de bureau ou Cowork), Claude Code, Cursor, ChatGPT sur le web ou l’application de bureau ChatGPT / Codex.
Si vous avez un plan Claude Team ou Enterprise ou utilisez ChatGPT sur le web, un administrateur devra peut-être approuver le connecteur avant que vous puissiez l’utiliser. Consultez les étapes propres à chaque client ci-dessous.
Si vous choisissez l’authentification par clé API, vous pouvez générer une clé dans lemlist.

Partie 1 : choisir votre mode de connexion

La plupart des clients prennent désormais en charge les serveurs MCP distants nativement. OAuth est donc le moyen le plus rapide de se connecter dans presque tous les cas. Retrouvez votre client ci-dessous.

Client	Méthode recommandée	Où configurer la connexion
Claude (web, application de bureau, Cowork)	OAuth	Dans l’application : Customize > Connectors
Claude Code	OAuth	Dans le terminal : `claude mcp add`
Cursor	OAuth (une clé API fonctionne aussi)	`~/.cursor/mcp.json`
ChatGPT sur le web	OAuth	Dans l’application : Settings > Apps (mode développeur)
ChatGPT (application de bureau), Codex CLI, extension Codex pour IDE	OAuth (une clé API fonctionne aussi)	`~/.codex/config.toml`

Important : ChatGPT propose deux modes de connexion MCP distincts. Dans ChatGPT sur le web, les serveurs MCP personnalisés s’ajoutent en tant qu’applications en mode développeur. L’application de bureau ChatGPT partage sa configuration MCP avec Codex CLI et l’extension Codex pour IDE : il suffit de la définir une fois dans ~/.codex/config.toml pour que les trois outils accèdent aux mêmes serveurs. Ces deux méthodes ne sont pas interchangeables : les instructions de l’une ne fonctionneront pas pour l’autre.

Option A (recommandée) : OAuth, sans clé API

Avec OAuth, vous n’avez pas besoin de créer ni de conserver une clé API. Votre client LLM gère l’authentification via votre navigateur : consentement, échange de jetons (PKCE) et renouvellement des jetons.

Lors de la première utilisation : à la première connexion ou au premier appel à un outil lemlist, votre navigateur ouvre une page de consentement. Vous y sélectionnez votre équipe et autorisez l’accès.
Gestion des jetons : les jetons sont gérés automatiquement (jeton d’accès : environ 1 heure ; jeton de renouvellement : environ 30 jours).

Option B : clé API

Si votre environnement l’exige, vous pouvez vous authentifier avec une clé API transmise dans un en-tête HTTP (X-API-Key). Choisissez cette méthode si votre client ne peut pas s’authentifier via OAuth ou si vous avez besoin d’un identifiant fixe pour une configuration partagée ou automatisée.

Partie 2 : connecter le serveur MCP de lemlist avec OAuth

Quel que soit le client, l’URL du serveur MCP à entrer est la suivante :

https://app.lemlist.com/mcp

Claude (web, application de bureau et Cowork)

Claude prend en charge les serveurs MCP distants nativement. Vous n’avez pas besoin de Node.js, de npx, de mcp-remote ni de fichier de configuration.

Avec un plan Free, Pro ou Max :

Ouvrez Customize > Connectors.
Cliquez sur +, puis sur Add custom connector.
Entrez l’URL du serveur MCP distant : https://app.lemlist.com/mcp
Cliquez sur Add. Laissez les champs de la section Advanced settings (identifiant et secret du client OAuth) vides : lemlist enregistre automatiquement votre client.
Cliquez sur Connect, puis suivez les étapes d’autorisation dans votre navigateur : sélectionnez votre équipe ou votre espace de travail lemlist et autorisez l’accès.

Avec un plan Team ou Enterprise :

Un utilisateur ayant le rôle Owner ouvre Organization settings > Connectors, clique sur Add, passe la souris sur Custom, puis sélectionne Web.
Il entre https://app.lemlist.com/mcp, puis clique sur Add.
Chaque membre ouvre ensuite Customize > Connectors, repère lemlist dans la liste et clique sur Connect pour s’authentifier avec son propre compte lemlist.

À noter : avec le plan Free, vous ne pouvez ajouter qu’un seul connecteur personnalisé. Avec Team et Enterprise, seuls les utilisateurs ayant le rôle Owner peuvent en ajouter : les membres peuvent s’y connecter, mais pas les créer.

Claude Code (OAuth)

Exécutez la commande suivante :
```
claude mcp add --transport http lemlist https://app.lemlist.com/mcp
```
L’option --header n’est pas nécessaire : OAuth gère automatiquement l’authentification.
Lancez Claude Code, puis exécutez /mcp.
Sélectionnez lemlist, puis Authenticate. La page de consentement s’ouvre dans votre navigateur : sélectionnez votre équipe et autorisez l’accès.

Choisir la portée. Par défaut, le serveur n’est ajouté que pour le projet en cours. Ajoutez l’option --scope pour modifier cette portée :

Option	Effet
`--scope local` (par défaut)	Ce projet uniquement, pour vous seul.
`--scope user`	Tous vos projets, pour vous seul.
`--scope project`	Partagé avec votre équipe via le fichier `.mcp.json` du dépôt. Chaque membre doit tout de même s’authentifier individuellement.

Cursor (OAuth)

Ouvrez ~/.cursor/mcp.json (pour tous les projets) ou .cursor/mcp.json à la racine de votre projet (pour ce projet uniquement). Créez le fichier s’il n’existe pas.

Ajoutez un bloc lemlist :

{"mcpServers": {"lemlist": {"url": "https://app.lemlist.com/mcp"}}}

Enregistrez le fichier. Cursor détecte le serveur et vous invite à vous connecter : suivez les étapes d’autorisation dans le navigateur.
Vous pouvez activer ou désactiver le serveur à tout moment depuis Customize dans Cursor.

À noter : si votre équipe utilise le plan Enterprise de Cursor, un administrateur devra peut-être d’abord ajouter le serveur à la liste d’autorisation dans Paramètres de l'équipe > MCP Configuration.

ChatGPT sur le web (applications en mode développeur)

Dans la version web de ChatGPT, les serveurs MCP personnalisés s’ajoutent en tant qu’applications en mode développeur, et non depuis l’ancien écran Connectors.

Vérifiez que l’option developer mode est activée pour votre compte.
Ouvrez Settings > Apps > Create. (Les administrateurs de l’espace de travail passent par Workspace settings > Apps > Create.)
Donnez un nom à l’application, puis indiquez https://app.lemlist.com/mcp comme URL du serveur MCP.
Choisissez OAuth comme méthode d’authentification et autorisez l’accès depuis votre compte lemlist. Vous n’avez rien à copier ni à conserver, et vous pouvez révoquer l’accès à tout moment.
Cliquez sur Scan tools, attendez la fin de l’analyse, puis cliquez sur Create.
Pour vérifier la connexion, demandez à ChatGPT d’effectuer une action en lecture seule, par exemple : « Listez mes campagnes lemlist. » Si vos campagnes s’affichent, la connexion fonctionne.

Limites selon le plan et la plateforme : les applications, la prise en charge complète de MCP et le mode développeur sont proposés aux clients ChatGPT Business et Enterprise/Edu uniquement dans la version web de ChatGPT, pas dans les applications de bureau ni sur mobile. Les utilisateurs Pro peuvent créer des applications avec l’Apps SDK, mais la prise en charge complète de MCP reste pour le moment réservée à Business et Enterprise/Edu. Si vous utilisez Plus ou Pro et souhaitez connecter le serveur MCP de lemlist, suivez plutôt la procédure application de bureau ChatGPT / Codex ci-dessous.

À noter : ChatGPT vous demandera confirmation avant toute action qui envoie des messages, consomme des crédits ou modifie des campagnes.

Application de bureau ChatGPT, Codex CLI et extension Codex pour IDE

Ces trois outils partagent une même configuration MCP via l’hôte Codex : il suffit donc de la définir une seule fois.

Option 1 : ajouter le serveur depuis le terminal (le plus simple).

Ajoutez le serveur :

codex mcp add lemlist --url https://app.lemlist.com/mcp

Authentifiez-vous :
```
codex mcp login lemlist
```
Dans votre navigateur, sélectionnez votre équipe ou votre espace de travail lemlist, puis autorisez l’accès.

Option 2 : modifier le fichier de configuration. Ouvrez ~/.codex/config.toml (configuration globale) ou .codex/config.toml dans un projet de confiance (pour ce projet uniquement), puis ajoutez :

[mcp_servers.lemlist]
url = "https://app.lemlist.com/mcp"
auth = "oauth"

Exécutez ensuite codex mcp login lemlist pour vous authentifier.

Option 3 : utiliser l’interface de l’application de bureau ChatGPT.

Ouvrez Settings > serveurs MCP.
Cliquez sur Add server et entrez https://app.lemlist.com/mcp.
Suivez les étapes d’autorisation dans votre navigateur.

Astuce : si les outils lemlist tardent à s’afficher, ajoutez startup_timeout_sec = 20 et tool_timeout_sec = 60 au bloc du serveur.

Partie 3 : connecter le serveur MCP de lemlist avec une clé API

Ne suivez cette méthode que si OAuth n’est pas disponible dans votre environnement.

Étape 1 : générer votre clé API lemlist

Connectez-vous à lemlist : https://app.lemlist.com
Ouvrez Paramètres → Équipe → Intégrations.
Cliquez sur Générer pour créer une clé API.
Conservez cette clé dans un endroit sûr (par exemple, un coffre-fort ou un gestionnaire de mots de passe). Vous ne pourrez peut-être pas l’afficher à nouveau.

Claude Code (clé API)

Exécutez la commande suivante en remplaçant la valeur de la clé API :

claude mcp add --transport http lemlist https://app.lemlist.com/mcp --header "X-API-Key: PUTYOURAPIKEY"

Cursor (clé API)

Ouvrez ~/.cursor/mcp.json ou .cursor/mcp.json.

Ajoutez un bloc lemlist comme dans l’exemple ci-dessous, en remplaçant la clé API :

{"mcpServers": {"lemlist": {"url": "https://app.lemlist.com/mcp","headers": {"X-API-Key": "... YOUR API KEY ..."}}}}

Application de bureau ChatGPT / Codex (clé API)

Dans ~/.codex/config.toml, transmettez la clé dans un en-tête statique :

[mcp_servers.lemlist]
url = "https://app.lemlist.com/mcp"
http_headers = { "X-API-Key" = "... YOUR API KEY ..." }

Pour éviter d’enregistrer la clé dans le fichier, récupérez-la plutôt depuis une variable d’environnement. Notez que env_http_headers attend le nom de la variable, pas la clé elle-même :

[mcp_servers.lemlist]
url = "https://app.lemlist.com/mcp"
env_http_headers = { "X-API-Key" = "LEMLIST_API_KEY" }

Claude Desktop via mcp-remote (ancienne méthode)

Dans la plupart des cas, vous pouvez ignorer cette section. Claude se connecte désormais nativement aux serveurs MCP distants (voir la partie 2), sans Node.js ni fichier de configuration. N’utilisez la méthode ci-dessous que si vous avez besoin d’exécuter le serveur localement, sur votre ordinateur.

Cette méthode exécute localement la passerelle MCP via npx et transmet la clé API dans une variable d’environnement. Node.js doit être installé pour que npx fonctionne.

Ouvrez les paramètres de Claude Desktop, puis accédez à Developer → Edit Config.

Dans claude_desktop_config.json, ajoutez un bloc de serveur MCP lemlist en remplaçant la clé API :

{"mcpServers": {"lemlist": {"command": "npx","args": ["mcp-remote","https://app.lemlist.com/mcp","--header","X-API-Key: ${API_KEY}"],"env": {"API_KEY": "... YOUR API KEY ..."}}}}

Sous Windows, si npx est introuvable, indiquez directement le chemin vers npx.cmd :

{"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 Desktop. Le serveur MCP de lemlist devrait maintenant apparaître dans les paramètres.

Partie 4 : vérifier la configuration

Ouvrez votre client IA et démarrez une nouvelle conversation.
Demandez à l’assistant quels outils lemlist sont disponibles (la liste peut évoluer au fil du temps).
Commencez par une action simple en lecture seule, comme afficher la liste des campagnes, avant de tenter toute modification.

Astuce : avec OAuth, la connexion ou le premier appel à un outil devrait ouvrir une page de consentement dans votre navigateur. Si elle ne s’affiche pas, consultez la section de dépannage ci-dessous.

Exemple concret : créer un « agent lemlist » spécialisé dans Claude Code

Si vous utilisez Claude Code, vous pouvez créer une compétence personnalisée qui charge un prompt d’agent spécialisé dans lemlist. C’est utile si vous utilisez régulièrement lemlist pour auditer vos campagnes, rechercher des prospects et optimiser vos séquences.

Créez le fichier .claude/skills/lemlist-agent/SKILL.md.
Ajoutez un en-tête de métadonnées avec les champs name et description, puis collez les instructions de votre agent en dessous.
Dans Claude Code, tapez /lemlist-agent pour l’activer. Vous pouvez aussi simplement décrire une tâche liée à lemlist : Claude chargera alors la compétence automatiquement.

Astuce : l’ancien format, avec un seul fichier .claude/commands/lemlist-agent.md, fonctionne toujours et crée la même commande /lemlist-agent. Les compétences sont à privilégier, car elles peuvent contenir des fichiers complémentaires (templates, listes de contrôle) et se déclencher automatiquement.

Scénarios courants à inclure :

Audit de campagne : lister les campagnes → récupérer les statistiques (30/90 jours) → identifier les points de blocage → proposer des corrections.
Création d’une nouvelle campagne : définir l’ICP → rédiger une séquence de 3 à 4 emails → configurer le planning d’envoi → guider l’import des prospects.
Recherche de prospects : définir les filtres de l’ICP → rechercher dans lemleads → vérifier un échantillon de résultats → enrichir avec précaution → dédoublonner et importer.

Problèmes courants et solutions

Problème : le serveur MCP de lemlist ne fonctionne plus dans ChatGPT depuis peu

Cause : vous l’avez très probablement configuré dans une interface qui a changé. Dans ChatGPT sur le web, les serveurs MCP personnalisés ne s’ajoutent plus depuis l’ancien écran Settings > Connectors, mais via les applications en mode développeur. La prise en charge complète de MCP y est désormais réservée à Business et Enterprise/Edu. De son côté, l’application de bureau ChatGPT ne passe pas du tout par les applications de la version web : elle lit la configuration de Codex.
Solution :
- Identifiez la version que vous utilisez, puis suivez la procédure correspondante dans la partie 2. Un connecteur ajouté sur le web n’apparaîtra pas dans l’application de bureau, et inversement.
- Avec Plus ou Pro, la prise en charge complète de MCP n’est pas disponible dans la version web de ChatGPT. Utilisez plutôt la méthode application de bureau ChatGPT / Codex : elle n’impose aucune restriction de plan.
- Avec Business, Enterprise ou Edu, recréez l’application lemlist dans Settings > Apps > Create, après avoir activé le mode développeur.

Problème : lemlist apparaît dans Codex, mais aucun outil n’est disponible

Cause : l’authentification n’a pas abouti, le délai de démarrage du serveur a été dépassé ou vous utilisez une ancienne version de Codex qui ne prend pas entièrement en charge le transport Streamable HTTP.
Solution :
- Exécutez codex mcp login lemlist et vérifiez que la procédure d’authentification va jusqu’au bout dans le navigateur.
- Installez la dernière version de Codex : la gestion des connexions distantes en Streamable HTTP a fait l’objet de plusieurs correctifs.
- Augmentez les valeurs de startup_timeout_sec et tool_timeout_sec dans le bloc du serveur.
- Vérifiez que vous avez modifié le bon fichier : ~/.codex/config.toml pour la configuration globale ou .codex/config.toml dans un projet de confiance.

Problème : la page de consentement OAuth ne s’ouvre pas

Cause : la connexion n’a pas déclenché de flux OAuth, les fenêtres contextuelles sont bloquées ou l’URL du serveur MCP est incorrecte.
Solution :
- Claude : ouvrez Customize > Connectors et cliquez sur Connect à côté de lemlist.
- Claude Code : exécutez /mcp, sélectionnez lemlist, puis Authenticate.
- Cursor : enregistrez à nouveau mcp.json, ou désactivez puis réactivez le serveur depuis Customize.
- ChatGPT sur le web : rouvrez l’application dans Settings > Apps et autorisez à nouveau l’accès.
- Application de bureau ChatGPT / Codex : exécutez codex mcp login lemlist pour lancer manuellement l’authentification.
- Autorisez temporairement les fenêtres contextuelles pour votre client IA ou votre navigateur.
- Vérifiez à nouveau l’URL du serveur MCP : https://app.lemlist.com/mcp.

Problème : vous ne pouvez pas ajouter le connecteur

Cause : une limite de votre plan ou une restriction définie par un administrateur bloque l’ajout.
Solution :
- Claude Free : vous ne pouvez ajouter qu’un seul connecteur personnalisé. Supprimez d’abord un connecteur existant.
- Claude Team/Enterprise : demandez à un utilisateur ayant le rôle Owner d’ajouter lemlist dans Organization settings > Connectors, puis connectez-vous depuis Customize > Connectors.
- Cursor Enterprise : demandez à un administrateur d’ajouter le serveur à la liste d’autorisation dans Paramètres de l'équipe > MCP Configuration.
- ChatGPT sur le web : vérifiez que le mode développeur est activé, que vous disposez d’un plan Business/Enterprise/Edu et que l’administrateur de votre espace de travail autorise les applications personnalisées.

Problème : les outils lemlist ne fonctionnent plus ou vous demandent de vous reconnecter

Cause : votre jeton de renouvellement a expiré (après environ 30 jours d’inactivité), l’accès a été révoqué ou vous avez été retiré de l’équipe lemlist pour laquelle vous aviez initialement autorisé l’accès.
Solution :
- Autorisez à nouveau l’accès plutôt que d’ajouter le serveur une seconde fois. Dans Claude, cliquez de nouveau sur Connect dans Customize > Connectors. Dans Claude Code, exécutez /mcp et choisissez Authenticate. Dans Codex, exécutez codex mcp login lemlist.
- Si vous faites partie de plusieurs équipes lemlist, vérifiez que vous avez sélectionné la bonne sur la page de consentement.

Problème : l’authentification avec une clé API échoue

Cause : l’en-tête X-API-Key est absent ou incorrect, ou la clé a expiré ou a été révoquée.
Solution :
- Vérifiez que le nom de l’en-tête est exactement X-API-Key (respectez les majuscules, les minuscules et la ponctuation).
- Si nécessaire, générez une nouvelle clé API dans lemlist et mettez à jour votre configuration.
- Dans Codex, http_headers attend la clé elle-même, tandis que env_http_headers attend le nom d’une variable d’environnement. Les confondre est une erreur fréquente.
- Si vous utilisez l’ancienne méthode avec mcp-remote, vérifiez que le nom de variable défini dans env correspond bien à celui utilisé (API_KEY).

Problème : le serveur lemlist n’apparaît pas dans votre client

Cause : tout dépend de la méthode de connexion utilisée. Vérifiez les points correspondants ci-dessous.
Solution :
- Claude : aucun fichier de configuration à vérifier. Assurez-vous que lemlist est listé dans Customize > Connectors et, avec Team/Enterprise, qu’un utilisateur ayant le rôle Owner l’a bien ajouté.
- Claude Code : exécutez claude mcp list pour vérifier que le serveur a été ajouté. Si vous avez utilisé la portée par défaut --scope local, il n’est disponible que dans le projet où vous avez exécuté la commande.
- Cursor : vérifiez la validité du JSON (les accolades ou les virgules manquantes sont fréquentes), puis le chemin du fichier : ~/.cursor/mcp.json ou .cursor/mcp.json.
- ChatGPT sur le web : si Scan tools n’a rien renvoyé, la connexion au point d’accès ou l’autorisation n’a pas abouti. Vérifiez les deux, puis relancez l’analyse.
- Application de bureau ChatGPT / Codex : exécutez codex mcp list, vérifiez la validité du TOML et assurez-vous que l’en-tête de la table est exactement [mcp_servers.lemlist]. Redémarrez l’application de bureau après avoir modifié le fichier.
- Avec l’ancienne méthode mcp-remote uniquement : vérifiez que Node.js est installé et que npx fonctionne (ou utilisez le chemin Windows vers npx.cmd), puis redémarrez complètement Claude Desktop.

Problème : la connexion fonctionne, mais les outils ne fonctionnent pas comme prévu

Cause : des restrictions réseau, un incident temporaire du service ou un point d’accès incorrect.
Solution :
- Vérifiez que le point d’accès de contrôle d’état du serveur MCP est joignable : GET /mcp/health sur https://app.lemlist.com.
- Patientez un court instant, puis réessayez.
- Vérifiez si votre environnement bloque les requêtes HTTPS sortantes.

Référence technique (utilisateurs avancés)

Point d’accès : https://app.lemlist.com/mcp
Environnement technique : Node.js (MeteorJS)
Protocole : MCP (JSON-RPC 2.0 sur HTTP/POST, transport Streamable HTTP)
Authentification : OAuth 2.1 avec PKCE et enregistrement dynamique des clients, ou clé API dans l’en-tête X-API-Key
Durée de validité des jetons : jeton d’accès : environ 1 heure ; jeton de renouvellement : environ 30 jours
Validation : schémas Zod pour les données d’entrée
Contrôle d’état : GET /mcp/health

Configurer le serveur MCP de lemlist dans votre client LLM (OAuth ou clé API)