> ## 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 über MCP mit deiner KI verbinden

Du kannst Leadscraper direkt mit deinem KI-Client verbinden – zum Beispiel **Claude** (Desktop & Web), **ChatGPT** (Custom GPTs), **Cursor** oder einem eigenen Agent. Dann startest du Lead-Suchen, prüfst ihren Status, holst dir Leads und checkst deinen Credit-Stand, ohne Leadscraper überhaupt zu öffnen – einfach im Gespräch mit deiner KI.

Möglich macht das **MCP** (Model Context Protocol) – ein offener Standard, über den KI-Clients sicher mit externen Werkzeugen sprechen. Leadscraper stellt dafür einen eigenen MCP-Server bereit.

## Was du davon hast

- **Recherche aus deinem KI-Workflow heraus.** „Such mir 10 Schreinereien in Bayern" – und deine KI startet den Run in Leadscraper und bringt dir die Ergebnisse zurück.
- **Kein Tool-Wechsel.** Suche, Status und Leads laufen dort, wo du ohnehin arbeitest.
- **Dein Account, deine Regeln.** Credits werden ganz normal verrechnet (1 Credit pro geliefertem Lead).

## Voraussetzungen

- Ein Leadscraper-Account.
- Ein MCP-fähiger KI-Client (z. B. Claude.ai, Claude Desktop, ChatGPT oder Cursor).

## Weg 1 – Claude.ai (Web) per OAuth verbinden (schnellster Weg)

Für Claude.ai im Browser brauchst du **kein Token**. Der ganze Vorgang dauert unter einer Minute.

### Schritt 1 – Integrations-Karte öffnen

1. Logge dich bei my.leadscraper.de ein.
2. Klicke oben rechts auf dein Profil → **Kontoeinstellungen** (Account settings) → **Integrationen** (Integrations).
3. Klicke auf der Karte **Leadscraper as MCP server** auf **Mit Claude verbinden** (Connect to Claude).

![Über „Connect to Claude" startest du die OAuth-Verbindung – Token ist für Claude.ai nicht nötig.](https://public.deimann.io/img/help-ls/mcp_connect_step-01.png)

### Schritt 2 – Server-URL kopieren und Connector in Claude hinzufügen

Ein Fenster zeigt dir deine MCP-Server-URL (`https://mcp.leadscraper.eu/mcp`) mit einem Kopieren-Button. Danach:

1. Klicke auf **Claude-Connectors öffnen ↗** (Open Claude connectors) – oder öffne in Claude direkt **Einstellungen → Connectors → Eigenen Connector hinzufügen** (Settings → Connectors → Add custom connector).
2. Füge die Server-URL ein und bestätige.
3. Claude leitet dich zu einer Leadscraper-**Zustimmungsseite** (Allow-Screen) weiter – klicke auf **Allow**.

> Bereits bei Leadscraper eingeloggt? Dann reicht auf der Zustimmungsseite ein einziger Klick – kein separates Passwort nötig. Leitet Claude dich nicht automatisch zurück, wechsle einfach selbst zu deinem Claude-Tab – der Connector zeigt dort meist schon als verbunden an.

### Schritt 3 – Verbindung prüfen

Frag Claude z. B.:

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

Antwortet Claude mit deinen echten Kontodaten, ist die Verbindung aktiv.

## Weg 2 – Manuelles Token (Claude Desktop, Cursor, eigener Agent)

Nutze diesen Weg, wenn du lieber ein Bearer-Token möchtest oder dein Client (noch) kein OAuth unterstützt – etwa Claude Desktop, Cursor oder eigene Agent-SDKs.

1. Klicke auf der Integrationen-Seite neben **Mit Claude verbinden** auf **Generate token**.
2. Gib im Fenster **Connect an AI client** (Verbinde einen KI-Client) einen Namen ein (z. B. „Claude Desktop") und klicke auf **Generate token**.

![Über „Generate token" erstellst du ein benanntes Token (z. B. „Claude Desktop") – es wird nur einmal angezeigt.](https://public.deimann.io/img/help-ls/mcp_connect_step-02.png)

3. **Kopiere das Token sofort und bewahre es sicher auf.** Es wird dir aus Sicherheitsgründen nur **einmal** angezeigt.
4. Trage es zusammen mit der Server-URL in deine Client-Config ein.

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

Starte deinen Client danach neu und prüfe, ob das Tools-Icon erscheint – dann ist die Verbindung aktiv.

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

> **Token-Gültigkeit:** Manuelle Tokens laufen nach **90 Tagen** automatisch ab. Auf der Integrationen-Seite siehst du neben jedem Token einen **Revoke**-Link, um es vorzeitig zu widerrufen – etwa wenn du es nicht mehr brauchst oder es kompromittiert sein könnte.

## Was du über die KI tun kannst

Aktuell stehen dir sechs Werkzeuge zur Verfügung:

| Werkzeug | Was es tut |
|---|---|
| **list_profiles** | Listet deine Suchprofile auf. |
| **create_profile** | Erstellt ein neues Suchprofil. |
| **create_lead_search** | Startet eine neue Lead-Suche für ein bestehendes Profil. |
| **get_search_status** | Zeigt, ob ein laufender Run schon fertig ist. |
| **list_leads** | Holt die Leads eines Profils – mit denselben Daten, die du auch im Produkt siehst. |
| **get_credit_balance** | Zeigt deinen aktuellen Credit-Stand. |

In der Praxis sprichst du einfach mit deiner KI – z. B. *„Starte eine Suche nach Elektrikern in Hamburg und zeig mir die Ergebnisse, sobald sie da sind."* Die KI ruft im Hintergrund die passenden Werkzeuge auf.

> **Aktuell lesend + suchend:** Aktionen, die zusätzliche Credits für Kontakt-Recherche verbrauchen oder Daten in ein CRM pushen (z. B. Verbindung zu Pipedrive/HubSpot, Outreach-Mails entwerfen), sind bewusst noch gesperrt, bis ein eigener Bestätigungsschritt für Ausgaben verfügbar ist. Diese Werkzeuge werden freigeschaltet, ohne dass du die Verbindung neu einrichten musst.

## Credits & Sicherheit

- **Credits:** Eine Suche verbraucht Credits wie gewohnt – ein Credit pro geliefertem Lead. Egal wie deine KI sich verhält: pro Token bzw. Verbindung gibt es Schutzlimits, damit nichts ungewollt durchläuft.
- **Zugriff:** Die Verbindung greift ausschließlich auf **deinen** Account zu, wird verschlüsselt gespeichert und ist jederzeit widerrufbar (**Revoke**).
- **Gültigkeit:** OAuth-Verbindungen (Claude.ai) halten ~30 Tage und werden von Claude automatisch erneuert. Manuelle Tokens laufen nach 90 Tagen ab.
- **Fehlermeldungen:** Schlägt ein Werkzeug-Aufruf fehl, zeigt Claude einen konkreten Grund (z. B. zu wenig Credits, ungültige Anfrage) statt einer generischen Fehlermeldung.
- **Dein normaler Login bleibt unberührt** – die MCP-Verbindung läuft komplett parallel dazu.

## Troubleshooting

**„Add custom connector" akzeptiert kein Token-Feld?**
Das ist normal – Claudes Connector-Flow für eigene Connectors läuft ausschließlich über OAuth. Füge einfach die Server-URL ein und bestätige über die Allow-Seite, kein Token nötig.

**Mir fehlen Werkzeuge im Vergleich zu vorher?**
Wenn du zuvor über ein Token verbunden warst, siehst du unter Umständen nur die sechs oben gelisteten Werkzeuge. Credit-intensivere und CRM-Push-Werkzeuge sind bewusst deaktiviert, bis der Bestätigungsschritt für Ausgaben live ist.

**Der Connector trennt sich nach einem Tag?**
Das war ein bekanntes Problem mit kurzlebigen Tokens und ist behoben – OAuth-Verbindungen halten inzwischen ~30 Tage. Falls es bei dir weiterhin täglich passiert, melde dich einfach über den In-App-Chat.

## Häufige Fragen

**Brauche ich Programmierkenntnisse?**
Für Claude.ai nicht: ein Klick auf „Mit Claude verbinden" genügt, kein Token nötig. Für andere Clients erstellst du ein Token und trägst es mit der Server-URL in deine Client-Config ein.

**Was, wenn ich mein Token verloren habe?**
Kein Problem: Widerrufe das alte über **Revoke** und erstelle ein neues. Aus Sicherheitsgründen lässt sich ein bestehendes Token nicht erneut anzeigen.

**Verbraucht das Verbinden allein schon Credits?**
Nein. Credits kostet nur eine tatsächlich gestartete Suche bzw. Kontakt-Recherche – genau wie im Produkt.

**Welche KI-Clients werden unterstützt?**
Claude (Desktop & Web), ChatGPT (Custom GPTs), Cursor und jeder weitere MCP-fähige Client, u. a. über eigene Agent-SDKs.

**Kann ich Leadscraper weiter normal im Browser nutzen?**
Ja, uneingeschränkt. MCP ist ein zusätzlicher Weg, kein Ersatz.