Rémi Kokabi12 de marzo de 20269 min de lecturaActualizado: 7 oct 2026

Cómo configurar lemlist MCP en 2 minutos (Claude, Cursor y más)

La semana pasada le pedí a Claude que extrajera las tasas de respuesta de tres campañas, encontrara la que estaba fallando y redactara dos nuevos emails de seguimiento. No abrí lemlist en ningún momento. Todo tomó cuatro minutos, y dos de esos fueron para releer los borradores porque aún no me los terminaba de creer. Eso es lo que pasa cuando tu cliente de IA puede hablar directamente con tu stack de outbound, a través del Model Context Protocol que Anthropic anunció en noviembre de 2024. Sin exportaciones. Sin copiar y pegar. Sin cambiar de pestaña.

Construimos el lemlist servidor MCP de lemlist para que nunca más tengas que pegar una lista de leads en un chat de IA. En esta guía, te muestro exactamente cómo conectarlo (OAuth o API key) en menos de 2 minutos. Después te enseño las categorías de herramientas que desbloqueas, cómo limitar el conector cuando quieres un agente enfocado, y el prompt exacto que usamos para convertir Claude Code en un operador dedicado de lemlist.

Hay 2 métodos de autenticación

El servidor MCP de lemlist soporta dos formas de autenticarte.

OAuth (recomendado). Es la opción más simple. Tu cliente de IA gestiona todo el proceso de autenticación de forma automática: abre una ventana del navegador, inicias sesión y das acceso a tu equipo de lemlist, y listo. Sin gestionar claves, sin copiar y pegar credenciales. Los tokens de acceso son válidos por 1 hora y se renuevan automáticamente hasta por 30 días. (Sí, la renovación del token ocurre en segundo plano, sin volver a pegar claves cada hora.)

API key. Si tu cliente no soporta flujos OAuth, o prefieres gestionar las credenciales manualmente, puedes autenticarte con una API key de lemlist. La clave se genera una vez dentro de lemlist y se pega en el archivo de configuración de tu cliente. Ideal para Cursor, entornos CI o integraciones personalizadas.

Recomendamos OAuth para la mayoría de los equipos, porque la forma en que te autenticas es algo en lo que dejas de pensar a los cinco minutos, y OAuth es la opción que desaparece más rápido. El outbound se está volviendo prompt-driven. Cuanta menos fricción haya entre una pregunta en tu cabeza y una respuesta de los datos de tu campaña, más tiempo dedicas a pensar en vez de hacer clics.

⚠ Nota importante: el servidor MCP usa el header X-API-Key para la autenticación, que es diferente al método Basic Auth de la API REST.

Configuración con OAuth

Claude Desktop

Abre la barra lateral, haz clic en el ícono + junto a Connectors y elige "Add custom connector".

Completa:

Haz clic en "Add". La primera vez que uses una herramienta de lemlist, se abrirá una pestaña del navegador para que selecciones tu equipo y des acceso.

Después de eso, Claude gestiona los tokens en segundo plano.

También puedes agregar la configuración manualmente. Abre claude_desktop_config.json y agrega:

{ "mcpServers": { "lemlist": { "command": "npx", "args": ["mcp-remote", "https://app.lemlist.com/mcp"] } } }

El paquete mcp-remote gestiona todo el flujo OAuth: descubrimiento del cliente, consentimiento en el navegador, intercambio de tokens PKCE y renovación automática. Si quieres saber exactamente qué hace cada uno de esos pasos, la especificación MCP publicada por modelcontextprotocol.io es la referencia oficial, definida contra el esquema TypeScript en schema.ts.

Claude Code

Ejecuta este único comando en tu terminal:

claude mcp add --transport http lemlist https://app.lemlist.com/mcp

No necesitas el flag --header. En el primer uso, tu navegador abrirá una página de consentimiento. Una vez que autorices, ya estás conectado.

💡 Puedes configurar un comando de agente personalizado de lemlist en Claude Code. Guarda el prompt del agente en .claude/commands/lemlist-agent.md y luego llámalo con /lemlist-agent para tener un asistente preconfigurado para gestionar campañas.

Configuración con API key

Paso 1: Genera tu API key de lemlist

  1. Inicia sesión en lemlist y ve a app.lemlist.com

  2. Navega a Settings > Team > Integrations

  3. Haz clic en "Generate" para crear una nueva API key

  4. Copia la clave y guárdala en un lugar seguro. No podrás verla de nuevo después de cerrar la página.

Paso 2: Agrega tu clave a tu cliente

Cursor

Ve a Settings > Tools & MCP > New MCP Server y agrega:

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

Claude Desktop (npm)

Ve a Settings/Developer/Edit Config en tu app.

Agrega un bloque "lemlist" al archivo claude_desktop_config.json, como en este ejemplo:

Para usuarios de 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 ..." } } } }

Para usuarios de 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 ..." } } }

Reinicia Claude y ve a la sección Developer.

Claude Code

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

Cuidado: mantén siempre tu API key fuera del control de versiones. Si trabajas en un repo compartido, usa variables de entorno en vez de escribir la clave directamente en tu archivo de configuración.

Qué puedes hacer una vez conectado

Pregúntale directamente a tu asistente de IA: "¿Qué operaciones de lemlist puedes hacer?" Te devolverá la lista más actualizada. Las herramientas disponibles evolucionan a diario, así que toma lo que lees aquí como una foto del momento.

Las categorías típicas incluyen:

  • Gestión de campañas. Crea, edita, pausa o elimina campañas directamente desde el chat.

  • Gestión de leads. Actualiza, pausa o elimina leads dentro de una campaña activa sin tocar la interfaz.

  • Búsqueda de leads. Busca en lemleads por criterios de ICP (rol, industria, tamaño de empresa, ubicación).

  • Enriquecimiento de emails. Encuentra y verifica emails, y accede a las opciones de enriquecimiento que normalmente activarías a mano.

  • Equipo y estadísticas. Consulta tasas de apertura, tasas de respuesta y embudos de conversión para cualquier periodo, en cualquier equipo que hayas autorizado.

  • Webhooks. Crea e inspecciona suscripciones de webhooks para que los sistemas conectados se mantengan sincronizados.

  • Plantillas de mensajes y snippets. Redacta y reutiliza textos de secuencias multi-paso con variables y tiempos de seguimiento.

El agente de lemlist para Claude Code

Una vez que el MCP está conectado, puedes ir más allá y configurar un comando de agente dedicado de lemlist dentro de Claude Code. Esto te da un asistente experto preconfigurado que sabe cómo auditar campañas, buscar leads y escribir secuencias sin que tengas que explicar el contexto cada vez. Si quieres que el agente se enfoque en una sola tarea, limita su conector con buckets (más sobre eso justo abajo).

Cómo configurarlo

Crea un archivo en .claude/commands/lemlist-agent.md dentro de la carpeta de tu proyecto. Pega el siguiente prompt:

# 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?"

Luego abre Claude Code y escribe /lemlist-agent para activarlo.

💡 Piensa en esto como una capa de contexto persistente. Cada vez que llamas a /lemlist-agent, Claude inicia la conversación ya sabiendo cómo trabajar con campañas de lemlist de principio a fin.

Avanzado: limita tu conector

Por defecto, tu cliente carga todas las herramientas de lemlist. Está bien para explorar. Pero se vuelve ruidoso cuando ya sabes lo que quieres, y es difícil de justificar ante un equipo de seguridad que preferiría que tu agente de prospección nunca vea las herramientas de edición de campañas.

Agrega un ?bucket= parámetro al endpoint para cargar solo los grupos de herramientas que necesitas:

https://app.lemlist.com/mcp?bucket=prospecting,crm

Buckets disponibles: core, builder, prospecting, crm, engagement, deliverability, insights. Sepáralos con comas, los que necesites.

Dos cosas que esto desbloquea. Superficies de herramientas más pequeñas significan menos llamadas incorrectas por parte del modelo, lo cual importa más de lo que la gente cree en sesiones largas. Y puedes tener varias entradas de conector en paralelo: una limitada a prospecting para tu agente de búsqueda, otra limitada a insights para un agente de reportes de solo lectura que no puede tocar una campaña activa.

Preguntas frecuentes

  1. ¿Necesito pagar algo extra para usar el servidor MCP? No. El servidor MCP de lemlist está disponible para todos los usuarios de lemlist. Solo necesitas una cuenta activa de lemlist y un cliente de IA que soporte MCP.

  2. ¿Cuál es la diferencia entre OAuth y una API key en la práctica? OAuth funciona por sesión. Los tokens expiran y se renuevan automáticamente, así que no hay nada que gestionar. Una API key es permanente hasta que la revoques, lo cual es más conveniente para entornos automatizados pero requiere cuidado para evitar filtraciones de credenciales.

  3. Mi navegador no se abrió durante el flujo OAuth. ¿Qué hago? Verifica que mcp-remote esté instalado y que tu terminal tenga permisos para abrir URLs. También puedes ejecutar npx mcp-remote https://app.lemlist.com/mcp manualmente para ver la URL de consentimiento y abrirla tú mismo.

  4. ¿Puedo conectar varios equipos de lemlist? Sí. Durante el paso de consentimiento OAuth, seleccionas qué equipo autorizar. Para conectar varios equipos, configura entradas de servidor MCP separadas en tu config, una por equipo.

  5. ¿Qué clientes de IA son compatibles? Los clientes documentados oficialmente son Claude Desktop, Claude Code y Cursor. Cualquier cliente que soporte MCP sobre HTTP debería funcionar con el https://app.lemlist.com/mcp endpoint.

  6. ¿Puedo usar lemlist MCP fuera de Claude y Cursor? Sí, y mucha gente ya lo hace. El endpoint es MCP estándar sobre HTTP, así que cualquier cliente que hable el protocolo puede llamarlo. El patrón más interesante que vemos son agentes integrados en CRMs: Attio, por ejemplo, documenta cómo llamar herramientas de lemlist MCP dentro de un paso de flujo de trabajo de Custom agent, para que una actualización de registro en el CRM dispare acciones en lemlist sin intervención humana. También existen integraciones de terceros, incluyendo un Skill de Claude Code para lemlist creado por Composio, que es una vía no oficial pero funcional. El ecosistema MCP en crecimiento en GitHub tiene más de 51.000 seguidores en la página de la organización del protocolo, y nuevos clientes aparecen constantemente. Si prefieres una conexión sin código, nuestra página de integraciones cubre las opciones fuera de MCP.

También puedes consultar la documentación oficial de la API y de MCP aquí.

Conclusión

Conectar el MCP es la parte de dos minutos. El verdadero valor llega después, la primera vez que detectas una secuencia que se está muriendo con una pregunta de una línea en vez de un rastreo de dashboard un lunes por la mañana.

Empieza con OAuth, confirma que una llamada de solo lectura funcione (las estadísticas de campaña son una buena primera prueba), luego agrega el comando /lemlist-agent y limita tus buckets. A partir de ahí puedes gestionar campañas multicanal de principio a fin sin salir de tu ventana de chat.

¿Aún no tienes cuenta en lemlist? Comienza una prueba gratis de 14 días. Sin tarjeta de crédito, acceso completo a todas las funcionalidades, y el servidor MCP está incluido en todos los planes (lemlist tiene una calificación de 4,6/5 en G2).

Lanza campañas outbound con IA

Automatiza tu prospección y personaliza secuencias con IA para conseguir más reuniones.

Rémi Kokabi

Rémi Kokabi

Co-founder @GTM Club

Compartir