> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.leadscraper.eu/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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

1. Inicia sesión en my.leadscraper.de.
2. Haz clic arriba a la derecha en tu perfil → **Configuración de la cuenta** (Account settings) → **Integraciones** (Integrations).
3. En la tarjeta **Leadscraper as MCP server**, haz clic en **Conectar con Claude** (Connect to Claude).

![A través de "Connect to Claude" inicias la conexión OAuth – no se necesita ningún token para Claude.ai.](https://public.deimann.io/img/help-ls/mcp_connect_step-01.png)

### 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:

1. 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).
2. Pega la URL del servidor y confirma.
3. 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.

1. En la página de Integraciones, junto a **Conectar con Claude**, haz clic en **Generar token** (Generate token).
2. 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).

![A través de "Generate token" creas un token con nombre (p. ej. "Claude Desktop") – solo se muestra una vez.](https://public.deimann.io/img/help-ls/mcp_connect_step-02.png)

3. **Copia el token de inmediato y guárdalo en un lugar seguro.** Por motivos de seguridad solo se muestra **una vez**.
4. Añádelo, junto con la URL del servidor, a la configuración de tu cliente.

```json
{
  "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.