Conectar Leadscraper con tu IA vía MCP
Puedes conectar Leadscraper directamente con tu cliente de IA — por ejemplo Claude (Desktop y Web), ChatGPT (Custom GPTs), Cursor o tu propio agente. Así puedes iniciar búsquedas de leads, comprobar su estado, obtener tus leads y consultar tu saldo de créditos sin necesidad de abrir Leadscraper — simplemente conversando con tu IA.
Esto es posible gracias a MCP (Model Context Protocol) — un estándar abierto que permite a los clientes de IA comunicarse de forma segura con herramientas externas. Leadscraper pone a tu disposición su propio servidor MCP para ello.
Qué ganas con esto
- Investigación desde tu flujo de trabajo con IA. «Búscame 10 carpinterías en Baviera» — y tu IA inicia la búsqueda en Leadscraper y te trae los resultados.
- Sin cambiar de herramienta. Búsqueda, estado y leads funcionan donde ya trabajas.
- Tu cuenta, tus reglas. Los créditos se cobran como siempre (1 crédito por lead entregado).
Requisitos
- Una cuenta de Leadscraper.
- Un cliente de IA compatible con MCP (p. ej. Claude.ai, Claude Desktop, ChatGPT o Cursor).
Vía 1 – Conectar Claude.ai (Web) por OAuth (la más rápida)
Para Claude.ai en el navegador no necesitas ningún token. Todo el proceso dura menos de un minuto.
Paso 1 – Abrir la tarjeta de integración
- Inicia sesión en my.leadscraper.de.
- Haz clic arriba a la derecha en tu perfil → Configuración de la cuenta (Account settings) → Integraciones (Integrations).
- En la tarjeta Leadscraper as MCP server, haz clic en Conectar con Claude (Connect to Claude).

Paso 2 – Copiar la URL del servidor y añadir el conector en Claude
Se abre una ventana que muestra la URL de tu servidor MCP (https://mcp.leadscraper.eu/mcp) con un botón para copiarla con un clic. Después:
- Haz clic en Abrir conectores de Claude ↗ (Open Claude connectors) — o abre directamente en Claude Configuración → Conectores → Añadir conector personalizado (Settings → Connectors → Add custom connector).
- Pega la URL del servidor y confirma.
- Claude te redirige a una página de consentimiento (Allow screen) de Leadscraper — haz clic en Permitir (Allow).
¿Ya tienes sesión iniciada en Leadscraper? Entonces basta con un solo clic en la página de consentimiento — no se necesita ninguna contraseña adicional. Si Claude no te redirige automáticamente, simplemente cambia a tu pestaña de Claude — normalmente el conector ya aparecerá como conectado.
Paso 3 – Comprobar la conexión
Pregúntale a Claude, por ejemplo:
- «List my leadscraper profiles»
- «What's my leadscraper credit balance?»
Si Claude responde con los datos reales de tu cuenta, la conexión está activa.
Vía 2 – Token manual (Claude Desktop, Cursor, agente propio)
Usa esta vía si prefieres un token tipo bearer, o si tu cliente (todavía) no admite OAuth — por ejemplo Claude Desktop, Cursor o tus propios SDKs de agentes.
- En la página de Integraciones, junto a Conectar con Claude, haz clic en Generar token (Generate token).
- En la ventana Connect an AI client (Conectar un cliente de IA), introduce un nombre (p. ej. «Claude Desktop») y haz clic en Generar token (Generate token).

- Copia el token de inmediato y guárdalo en un lugar seguro. Por motivos de seguridad solo se muestra una vez.
- Añádelo, junto con la URL del servidor, a la configuración de tu cliente.
{
"mcpServers": {
"leadscraper": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.leadscraper.eu/mcp",
"--header",
"Authorization: Bearer <TU_TOKEN>"
]
}
}
}Reinicia tu cliente después y comprueba que aparece el icono de herramientas — entonces la conexión está activa.
URL del servidor: https://mcp.leadscraper.eu/mcp
Validez del token: los tokens manuales caducan automáticamente a los 90 días. En la página de Integraciones verás un enlace Revocar (Revoke) junto a cada token para revocarlo antes de tiempo — por ejemplo, si ya no lo necesitas o podría estar comprometido.
Qué puedes hacer a través de la IA
Actualmente tienes seis herramientas disponibles:
Herramienta | Qué hace |
|---|---|
list_profiles | Lista tus perfiles de búsqueda. |
create_profile | Crea un nuevo perfil de búsqueda. |
create_lead_search | Inicia una nueva búsqueda de leads para un perfil existente. |
get_search_status | Muestra si una búsqueda en curso ya ha terminado. |
list_leads | Obtiene los leads de un perfil — con los mismos datos que ves en el producto. |
get_credit_balance | Muestra tu saldo de créditos actual. |
En la práctica, simplemente hablas con tu IA — p. ej. «Inicia una búsqueda de electricistas en Hamburgo y muéstrame los resultados en cuanto estén disponibles.» La IA llama a las herramientas correspondientes en segundo plano.
Por ahora, solo lectura y búsqueda: las acciones que consumen créditos adicionales para la investigación de contactos, o que envían datos a un CRM (p. ej. conexión con Pipedrive/HubSpot, redacción de correos de outreach), están bloqueadas intencionadamente hasta que exista un paso propio de confirmación de gasto. Estas herramientas se habilitarán sin que tengas que volver a configurar la conexión.
Créditos y seguridad
- Créditos: una búsqueda consume créditos como siempre — un crédito por lead entregado. Sea cual sea el comportamiento de tu IA, cada token o conexión tiene límites de protección para que nada se ejecute sin control.
- Acceso: la conexión accede exclusivamente a tu cuenta, se guarda cifrada y puede revocarse en cualquier momento (Revocar / Revoke).
- Validez: las conexiones OAuth (Claude.ai) duran ~30 días y Claude las renueva automáticamente. Los tokens manuales caducan a los 90 días.
- Mensajes de error: si falla una llamada a una herramienta, Claude muestra un motivo concreto (p. ej. créditos insuficientes, solicitud no válida) en lugar de un error genérico.
- Tu inicio de sesión habitual no se ve afectado — la conexión MCP funciona completamente en paralelo.
Solución de problemas
¿"Add custom connector" no acepta ningún campo de token?
Es normal — el flujo de conectores personalizados de Claude funciona exclusivamente por OAuth. Simplemente pega la URL del servidor y confirma en la pantalla Allow; no se necesita ningún token.
¿Me faltan herramientas respecto a antes?
Si antes te conectaste mediante un token, es posible que solo veas las seis herramientas listadas arriba. Las herramientas más intensivas en créditos y las de envío a CRM están desactivadas intencionadamente hasta que el paso de confirmación de gasto esté disponible.
¿El conector se desconecta después de un día?
Era un problema conocido con tokens de corta duración y ya está solucionado — las conexiones OAuth ahora duran ~30 días. Si en tu caso sigue ocurriendo a diario, escríbenos por el chat dentro de la app.
Preguntas frecuentes
¿Necesito saber programar?
Para Claude.ai no: basta con un clic en «Conectar con Claude», sin necesidad de token. Para otros clientes, generas un token y lo añades junto con la URL del servidor a la configuración de tu cliente.
¿Qué pasa si perdí mi token?
No hay problema: revoca el antiguo con Revocar y crea uno nuevo. Por motivos de seguridad, un token existente no puede volver a mostrarse.
¿Conectar por sí solo ya consume créditos?
No. Solo consume créditos una búsqueda o investigación de contacto realmente iniciada — igual que en el producto.
¿Qué clientes de IA son compatibles?
Claude (Desktop y Web), ChatGPT (Custom GPTs), Cursor y cualquier otro cliente compatible con MCP, entre otros mediante SDKs de agentes propios.
¿Puedo seguir usando Leadscraper normalmente en el navegador?
Sí, sin ninguna limitación. MCP es una vía adicional, no un reemplazo.
Actualizado el: 31/07/2026
¡Gracias!
