Artikelen over: Zoeken & leads benutten

Leadscraper via MCP koppelen aan je AI

Je kunt Leadscraper direct koppelen aan je AI-client – bijvoorbeeld Claude (Desktop & Web), ChatGPT (Custom GPTs), Cursor of een eigen agent. Daarna start je lead-zoekopdrachten, check je hun status, haal je leads op en bekijk je je creditsaldo, zonder Leadscraper ook maar te openen – gewoon in gesprek met je AI.


Dit is mogelijk dankzij MCP (Model Context Protocol) – een open standaard waarmee AI-clients veilig communiceren met externe tools. Leadscraper stelt hiervoor een eigen MCP-server beschikbaar.


Wat je eraan hebt


  • Onderzoek vanuit je AI-workflow. „Zoek me 10 timmerbedrijven in Beieren" – en je AI start de run in Leadscraper en brengt je de resultaten terug.
  • Geen tool-wisseling. Zoeken, status en leads verlopen waar je toch al werkt.
  • Jouw account, jouw regels. Credits worden gewoon verrekend (1 credit per geleverde lead).


Vereisten


  • Een Leadscraper-account.
  • Een MCP-compatibele AI-client (bijv. Claude.ai, Claude Desktop, ChatGPT of Cursor).


Weg 1 – Claude.ai (Web) via OAuth koppelen (snelste weg)


Voor Claude.ai in de browser heb je geen token nodig. Het hele proces duurt minder dan een minuut.


Stap 1 – Integratiekaart openen


  1. Log in bij my.leadscraper.de.
  2. Klik rechtsboven op je profiel → Accountinstellingen (Account settings) → Integraties (Integrations).
  3. Klik op de kaart Leadscraper as MCP server op Verbinden met Claude (Connect to Claude).


Via "Connect to Claude" start je de OAuth-verbinding – een token is niet nodig voor Claude.ai.


Stap 2 – Server-URL kopiëren en connector toevoegen in Claude


Een venster toont je MCP-server-URL (https://mcp.leadscraper.eu/mcp) met een kopieerknop. Daarna:


  1. Klik op Claude-connectors openen ↗ (Open Claude connectors) – of open in Claude direct Instellingen → Connectors → Eigen connector toevoegen (Settings → Connectors → Add custom connector).
  2. Plak de server-URL en bevestig.
  3. Claude leidt je door naar een Leadscraper-toestemmingspagina (Allow-scherm) – klik op Allow.


Al ingelogd bij Leadscraper? Dan volstaat op de toestemmingspagina één enkele klik – geen apart wachtwoord nodig. Stuurt Claude je niet automatisch terug, wissel dan gewoon zelf naar je Claude-tab – de connector staat daar meestal al als verbonden vermeld.


Stap 3 – Verbinding controleren


Vraag Claude bijvoorbeeld:


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


Antwoordt Claude met je echte accountgegevens, dan is de verbinding actief.


Weg 2 – Handmatig token (Claude Desktop, Cursor, eigen agent)


Gebruik deze weg als je liever een bearer-token wilt, of als je client (nog) geen OAuth ondersteunt – bijvoorbeeld Claude Desktop, Cursor of eigen agent-SDK's.


  1. Klik op de integratiepagina naast Verbinden met Claude op Token genereren (Generate token).
  2. Vul in het venster Verbind een AI-client (Connect an AI client) een naam in (bijv. „Claude Desktop") en klik op Token genereren (Generate token).


Via "Generate token" maak je een benoemd token aan (bijv. "Claude Desktop") – het wordt slechts één keer getoond.


  1. Kopieer het token direct en bewaar het veilig. Om veiligheidsredenen wordt het slechts één keer getoond.
  2. Voer het samen met de server-URL in je client-config in.


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


Start je client daarna opnieuw op en controleer of het tools-icoon verschijnt – dan is de verbinding actief.


Server-URL: https://mcp.leadscraper.eu/mcp


Token-geldigheid: Handmatige tokens verlopen automatisch na 90 dagen. Op de integratiepagina zie je naast elk token een link Intrekken (Revoke) om het vroegtijdig in te trekken – bijvoorbeeld als je het niet meer nodig hebt of het gecompromitteerd zou kunnen zijn.


Wat je via de AI kunt doen


Op dit moment staan je zes tools ter beschikking:


Tool

Wat het doet

list_profiles

Lijst je zoekprofielen op.

create_profile

Maakt een nieuw zoekprofiel aan.

create_lead_search

Start een nieuwe lead-zoekopdracht voor een bestaand profiel.

get_search_status

Toont of een lopende run al klaar is.

list_leads

Haalt de leads van een profiel op – met dezelfde gegevens die je ook in het product ziet.

get_credit_balance

Toont je huidige creditsaldo.


In de praktijk praat je gewoon met je AI – bijv. „Start een zoekopdracht naar elektriciens in Hamburg en toon me de resultaten zodra ze er zijn." De AI roept op de achtergrond de juiste tools aan.


Op dit moment lezend + zoekend: acties die extra credits verbruiken voor contactonderzoek of gegevens naar een CRM pushen (bijv. koppeling met Pipedrive/HubSpot, outreach-mails opstellen), zijn bewust nog geblokkeerd totdat er een aparte bevestigingsstap voor uitgaven beschikbaar is. Deze tools worden vrijgegeven zonder dat je de verbinding opnieuw hoeft in te richten.


Credits & beveiliging


  • Credits: een zoekopdracht verbruikt credits zoals gewoonlijk – één credit per geleverde lead. Ongeacht hoe je AI zich gedraagt: per token of verbinding gelden beschermingslimieten, zodat er niets onbedoeld doorloopt.
  • Toegang: de verbinding heeft uitsluitend toegang tot jouw account, wordt versleuteld opgeslagen en is op elk moment intrekbaar (Revoke).
  • Geldigheid: OAuth-verbindingen (Claude.ai) houden ~30 dagen stand en worden door Claude automatisch vernieuwd. Handmatige tokens verlopen na 90 dagen.
  • Foutmeldingen: Mislukt een tool-aanroep, dan toont Claude een concrete reden (bijv. te weinig credits, ongeldige aanvraag) in plaats van een generieke foutmelding.
  • Je normale login blijft onaangetast – de MCP-verbinding loopt volledig parallel daaraan.


Troubleshooting


„Add custom connector" accepteert geen tokenveld?
Dat is normaal – Claudes connector-flow voor eigen connectors verloopt uitsluitend via OAuth. Plak gewoon de server-URL en bevestig via de Allow-pagina, geen token nodig.


Ik mis tools ten opzichte van eerder?
Als je eerder via een token verbonden was, zie je mogelijk alleen de zes hierboven genoemde tools. Credit-intensievere tools en CRM-push-tools zijn bewust uitgeschakeld totdat de bevestigingsstap voor uitgaven live is.


De connector verbreekt na een dag?
Dat was een bekend probleem met kortlevende tokens en is opgelost – OAuth-verbindingen houden inmiddels ~30 dagen stand. Gebeurt het bij jou nog steeds dagelijks, meld je dan gewoon via de in-app chat.


Veelgestelde vragen


Heb ik programmeerkennis nodig?
Voor Claude.ai niet: één klik op „Verbinden met Claude" volstaat, geen token nodig. Voor andere clients maak je een token aan en voer je dat samen met de server-URL in je client-config in.


Wat als ik mijn token kwijt ben?
Geen probleem: trek het oude in via Revoke en maak een nieuwe aan. Om veiligheidsredenen kan een bestaand token niet opnieuw worden getoond.


Verbruikt alleen al het verbinden credits?
Nee. Credits kost alleen een daadwerkelijk gestarte zoekopdracht of contactonderzoek – net als in het product.


Welke AI-clients worden ondersteund?
Claude (Desktop & Web), ChatGPT (Custom GPTs), Cursor en elke andere MCP-compatibele client, onder andere via eigen agent-SDK's.


Kan ik Leadscraper gewoon in de browser blijven gebruiken?
Ja, onbeperkt. MCP is een extra mogelijkheid, geen vervanging.

Bijgewerkt op: 31/07/2026

Was dit artikel nuttig?

Deel uw feedback

Annuleer

Dankuwel!