Articoli su: Ricercare e usare i lead

Connettere Leadscraper al tuo AI tramite MCP

Puoi collegare Leadscraper direttamente al tuo client AI – ad esempio Claude (Desktop e Web), ChatGPT (Custom GPT), Cursor o un agente personalizzato. Da lì puoi avviare ricerche di lead, controllarne lo stato, recuperare i lead e verificare il saldo crediti senza mai aprire Leadscraper – semplicemente parlando con la tua AI.


Tutto questo è reso possibile da MCP (Model Context Protocol) – uno standard aperto che consente ai client AI di comunicare in modo sicuro con strumenti esterni. Leadscraper mette a disposizione un proprio server MCP.


Cosa ci guadagni


  • Ricerca direttamente dal tuo flusso di lavoro AI. „Trovami 10 falegnamerie in Baviera" – e la tua AI avvia l'esecuzione in Leadscraper e ti riporta i risultati.
  • Nessun cambio di strumento. Ricerca, stato e lead avvengono dove già lavori.
  • Il tuo account, le tue regole. I crediti vengono conteggiati normalmente (1 credito per lead consegnato).


Requisiti


  • Un account Leadscraper.
  • Un client AI compatibile con MCP (ad es. Claude.ai, Claude Desktop, ChatGPT o Cursor).


Percorso 1 – Collegare Claude.ai (Web) via OAuth (il più veloce)


Per Claude.ai nel browser non serve alcun token. L'intero processo richiede meno di un minuto.


Passo 1 – Apri la scheda Integrazioni


  1. Accedi su my.leadscraper.de.
  2. Clicca in alto a destra sul tuo profilo → Impostazioni account (Account settings) → Integrazioni (Integrations).
  3. Sulla scheda Leadscraper as MCP server, clicca su Connetti a Claude (Connect to Claude).


Tramite "Connect to Claude" avvii il collegamento OAuth – per Claude.ai non serve alcun token.


Passo 2 – Copia l'URL del server e aggiungi il connettore in Claude


Una finestra mostra l'URL del tuo server MCP (https://mcp.leadscraper.eu/mcp) con un pulsante per copiarlo. Poi:


  1. Clicca su Apri i connettori di Claude ↗ (Open Claude connectors) – oppure apri direttamente in Claude Impostazioni → Connettori → Aggiungi connettore personalizzato (Settings → Connectors → Add custom connector).
  2. Incolla l'URL del server e conferma.
  3. Claude ti reindirizza a una schermata di consenso (Allow-Screen) di Leadscraper – clicca su Allow.


Sei già loggato in Leadscraper? Allora sulla schermata di consenso basta un solo clic – nessuna password separata necessaria. Se Claude non ti reindirizza automaticamente indietro, passa semplicemente alla tua scheda Claude – il connettore risulterà già connesso nella maggior parte dei casi.


Passo 3 – Verifica la connessione


Chiedi a Claude ad esempio:


  • „List my leadscraper profiles"
  • „What's my leadscraper credit balance?"


Se Claude risponde con i tuoi dati account reali, la connessione è attiva.


Percorso 2 – Token manuale (Claude Desktop, Cursor, agente personalizzato)


Usa questo percorso se preferisci un bearer token oppure se il tuo client non supporta (ancora) OAuth – ad es. Claude Desktop, Cursor o SDK di agenti personalizzati.


  1. Sulla pagina Integrazioni, accanto a Connetti a Claude, clicca su Genera token (Generate token).
  2. Nella finestra Connect an AI client (Collega un client AI) inserisci un nome (ad es. „Claude Desktop") e clicca su Genera token.


Tramite "Generate token" crei un token con nome (ad es. "Claude Desktop") – viene mostrato una sola volta.


  1. Copia subito il token e conservalo in modo sicuro. Per motivi di sicurezza viene mostrato una sola volta.
  2. Inseriscilo insieme all'URL del server nella configurazione del tuo client.


{
  "mcpServers": {
    "leadscraper": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.leadscraper.eu/mcp",
        "--header",
        "Authorization: Bearer <IL_TUO_TOKEN>"
      ]
    }
  }
}


Riavvia poi il tuo client e verifica che compaia l'icona degli strumenti – allora la connessione è attiva.


URL del server: https://mcp.leadscraper.eu/mcp


Validità del token: i token manuali scadono automaticamente dopo 90 giorni. Sulla pagina Integrazioni trovi accanto a ogni token un link Revoke, per revocarlo in anticipo – ad esempio se non ti serve più o potrebbe essere compromesso.


Cosa puoi fare tramite l'AI


Attualmente sono disponibili sei strumenti:


Strumento

Cosa fa

list_profiles

Elenca i tuoi profili di ricerca.

create_profile

Crea un nuovo profilo di ricerca.

create_lead_search

Avvia una nuova ricerca di lead per un profilo esistente.

get_search_status

Mostra se un'esecuzione in corso è già terminata.

list_leads

Recupera i lead di un profilo – con gli stessi dati che vedi anche nel prodotto.

get_credit_balance

Mostra il tuo saldo crediti attuale.


In pratica, parli semplicemente con la tua AI – ad es. „Avvia una ricerca di elettricisti ad Amburgo e mostrami i risultati non appena sono pronti." L'AI richiama in background gli strumenti giusti.


Attualmente solo lettura + ricerca: le azioni che consumano crediti aggiuntivi per la ricerca di contatti o che inviano dati a un CRM (ad es. collegamento a Pipedrive/HubSpot, bozze di email di outreach) sono volutamente ancora disattivate, finché non sarà disponibile un passaggio di conferma dedicato per la spesa. Questi strumenti verranno abilitati senza che tu debba riconfigurare la connessione.


Crediti e sicurezza


  • Crediti: una ricerca consuma crediti come di consueto – un credito per lead consegnato. Indipendentemente da come si comporta la tua AI: per ogni token/connessione esistono limiti di protezione, così che nulla venga eseguito involontariamente.
  • Accesso: la connessione accede esclusivamente al tuo account, viene salvata in modo crittografato ed è revocabile in qualsiasi momento (Revoke).
  • Validità: le connessioni OAuth (Claude.ai) durano ~30 giorni e vengono rinnovate automaticamente da Claude. I token manuali scadono dopo 90 giorni.
  • Messaggi di errore: se una chiamata a uno strumento fallisce, Claude mostra un motivo concreto (ad es. crediti insufficienti, richiesta non valida) invece di un errore generico.
  • Il tuo login normale resta inalterato – la connessione MCP funziona completamente in parallelo.


Risoluzione dei problemi


"Add custom connector" non accetta un campo token?
È normale – il flusso di Claude per i connettori personalizzati funziona esclusivamente via OAuth. Incolla semplicemente l'URL del server e conferma tramite la schermata Allow, nessun token necessario.


Mi mancano strumenti rispetto a prima?
Se in precedenza ti eri collegato tramite token, potresti vedere solo i sei strumenti elencati sopra. Gli strumenti a maggiore consumo di crediti e quelli di push verso CRM sono volutamente disattivati finché il passaggio di conferma per la spesa non sarà live.


Il connettore si disconnette dopo un giorno?
Era un problema noto legato a token di breve durata ed è stato risolto – le connessioni OAuth durano ora circa 30 giorni. Se ti capita ancora ogni giorno, scrivici tramite la chat in-app.


Domande frequenti


Servono competenze di programmazione?
Per Claude.ai no: basta un clic su „Connetti a Claude", nessun token necessario. Per altri client, generi un token e lo inserisci insieme all'URL del server nella configurazione del tuo client.


Cosa succede se ho perso il mio token?
Nessun problema: revoca quello vecchio con Revoke e creane uno nuovo. Per motivi di sicurezza un token esistente non può essere mostrato di nuovo.


Il solo collegamento consuma già crediti?
No. Solo una ricerca o una ricerca di contatti effettivamente avviata costa crediti – esattamente come nel prodotto.


Quali client AI sono supportati?
Claude (Desktop e Web), ChatGPT (Custom GPT), Cursor e qualsiasi altro client compatibile con MCP, anche tramite SDK di agenti personalizzati.


Posso continuare a usare Leadscraper normalmente nel browser?
Sì, senza limitazioni. MCP è un percorso aggiuntivo, non una sostituzione.

Aggiornato il: 31/07/2026

È stato utile questo articolo?

Condividi il tuo feedback

Annulla

Grazie!