Artikel über: Suchen & Leads nutzen

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.


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.


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


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

Aktualisiert am: 31/07/2026

War dieser Beitrag hilfreich?

Teilen Sie Ihr Feedback mit

Stornieren

Danke!