> ## 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).

# 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.](https://public.deimann.io/img/help-ls/mcp_connect_step-01.png)

### 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.](https://public.deimann.io/img/help-ls/mcp_connect_step-02.png)

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

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