MCP-Client verbinden

Nutze Leadbase in einem kompatiblen KI-Client mit nativem OAuth und typisierten Tools.

Konto erstellen und deinen Agenten verbinden

Ein Agent kann die Verbindung vorbereiten und dich durch die Einrichtung führen. Du bestätigst deine Identität und den Zugriff selbst. Du brauchst weder ein bestehendes Leadbase-Konto noch ein Passwort.

Starte die native Verbindung deines Clients mit https://www.leadbase.io/api/mcp. Für ein neues Konto kann die OAuth-Anfrage prompt=create enthalten. Die Registrierung eines OAuth-Clients registriert eine Anwendung und erstellt kein Benutzerkonto.
Wähle Google oder gib deine geschäftliche E-Mail ein. Öffne den einmalig nutzbaren E-Mail-Link innerhalb von 15 Minuten. Mit öffentlichen oder temporären E-Mail-Anbietern kannst du kein neues Konto erstellen. Für bestehende Konten funktionieren auch E-Mail-Link, Passkey oder das vorhandene Passwort.
Gib deinen Namen und einen Workspace-Namen in einem Formular ein oder wähle einen bestehenden Workspace. Prüfe eine offene Teameinladung, bevor du einen separaten Workspace erstellst. Logo und Produkttour sind optional. Nutze nach einer Unterbrechung dieselbe E-Mail und denselben Workspace.
Prüfe Client, Workspace und Berechtigungen. Bestätige nur eine Verbindung, die du selbst angefordert hast. mcp:read erlaubt Lesezugriff. Ergänze mcp:write nur für Änderungen oder Recherche, die du autorisiert hast. Die signierte Verbindungsanfrage wird nach E-Mail-Bestätigung und Workspace-Einrichtung fortgesetzt, auch wenn du den E-Mail-Link in einem anderen Tab öffnest.
Lade die Werkzeuge und prüfe den Zugriff mit billing_get, ohne kostenpflichtige Recherche zu starten. Eine erfolgreiche Browser-Anmeldung beweist noch keine Verbindung zum Agenten. Lass dir Workspace, Berechtigungen und verfügbare Credits nennen und wähle dann deine erste Aufgabe, sofern du noch keine gestellt hast.

Ein Agent darf dich im Chat nicht nach Passwort, E-Mail-Bestätigungslink, Postfachzugriff oder OAuth-Token fragen. Öffne den Anmeldelink selbst. Ohne deine Autorisierung darf er keine Bedingungen akzeptieren, Credits kaufen, kostenpflichtige Recherche starten oder zusätzliche Berechtigungen bestätigen. Für neue Workspaces gilt die bestehende Regel für Startcredits. Die Verbindung gewährt keine zusätzlichen Credits und macht kostenpflichtige Recherche nicht kostenlos.

CLI-Clients ohne Callback-Listener

Nutze bevorzugt den OAuth-Ablauf deines Clients mit PKCE und einem unterstützten lokalen Callback. Ein Client mit RFC-8628-Unterstützung kann alternativ den Device-Endpunkt aus den OAuth-Metadaten verwenden:

Registriere einen öffentlichen Client mit den Grant-Typen urn:ietf:params:oauth:grant-type:device_code und bei dauerhaftem Zugriff refresh_token. Setze token_endpoint_auth_method auf none und fordere zunächst mcp:read offline_access an. Verwende die MCP-Ressource https://www.leadbase.io/api/mcp.
Sende client_id, scope und resource per POST an /api/auth/device/code. Zeige verification_uri_complete und user_code an. Du meldest dich an oder erstellst dein Konto, wählst deinen Workspace, vergleichst den Code und bestätigst oder verweigerst den Zugriff selbst.
Frage /api/auth/oauth2/token mit Device-Grant-Typ, client_id, device_code und derselben resource ab. Beachte das zurückgegebene Abfrageintervall. Warte bei authorization_pending, verlängere das Intervall bei slow_down und stoppe bei access_denied oder expired_token. Verwende den OAuth-Token-Endpunkt und nicht /api/auth/device/token.
Speichere Tokens nur im geschützten Speicher deines Clients und prüfe den Zugriff mit billing_get. Der Client muss Device Authorization unterstützen; das Eintragen einer URL allein reicht nicht.

Fortsetzen, wiederherstellen und widerrufen

Für einen abgelaufenen oder bereits genutzten E-Mail-Link brauchst du einen neuen Link. Für eine abgelaufene signierte Anfrage oder einen abgelaufenen Device-Code muss dein Agent eine neue Verbindung starten. Dein Konto und dein Workspace bleiben bestehen. Wähle nach einer Unterbrechung einen bereits erstellten Workspace. Wiederhole eine Workspace-Erstellung mit unklarem Ergebnis nicht automatisch.

Trenne den Client in seinen Verbindungseinstellungen und widerrufe ausgestellte Tokens bei Bedarf über /api/auth/oauth2/revoke. Das Abmelden aus der App widerruft Agenten-Tokens nicht. Mitgliedschaft und Berechtigungen werden bei jeder API-Anfrage geprüft. Ohne Workspace-Zugriff kann der Agent dessen Daten nicht mehr lesen oder ändern.

In der lokalen Entwicklung werden Transaktions-E-Mails unter /api/dev-email gesammelt und nie an echte Empfänger gesendet. Dieses Postfach gibt es nur im Entwicklungsbetrieb auf Loopback. Es umgeht weder Kontoerstellung noch E-Mail-Bestätigung.

Recherchiere in deinem eigenen KI-Chat

Verbinde Leadbase einmal und beschreibe dann, was du finden möchtest. Recherchiere Firmen und Personen, finde geschäftliche Kontaktdaten, sammle offene Stellen oder öffentliche Beiträge oder reichere eine Liste an. Leadbase wählt passende Tools, recherchiert fehlende Angaben und liefert typisierte Ergebnisse mit Quellen. Du kannst den Chat verlassen, während ein Auftrag läuft, und Ergebnis und tatsächliche Kosten später abrufen.

Der Katalog bietet dir Einstiegspunkte für LinkedIn, Firmen, Personen, Stellen und mehr. Die Vorlagen sind Beispiele: Du kannst die Frage ändern, bekannte Angaben mitgeben und die benötigten Ergebnisfelder auswählen.

Probiere zum Beispiel:

„Finde das LinkedIn-Profil und die geschäftliche E-Mail-Adresse dieser Person. Hier sind Name und Firma.“
„Welche offenen Stellen schreibt diese Firma aktuell aus? Liefere Titel, Standort und Bewerbungslink mit Quellen.“
„Finde für jede dieser Firmen die offizielle Karriereseite und liefere jeweils eine URL.“

Ergebnisse hängen von den verfügbaren Belegen ab. Leadbase unterscheidet eine belegte Antwort, keinen Treffer und einen technischen Fehler. Gefundene Kontaktdaten sind dadurch allein noch nicht verifiziert.

Verbinde deinen Client

Öffne Getting Started und kopiere die Server-URL oder die Anleitung für deinen Client. Leadbase nutzt Streamable HTTP unter https://www.leadbase.io/api/mcp. Schließe OAuth in einem Client ab, der Remote-MCP und diesen Autorisierungsablauf unterstützt.

ChatGPT, Claude, Codex, Cursor und weitere Clients unterscheiden sich bei MCP-Einrichtung und verfügbaren Tarifen. Nutze die Anleitung für deinen Host. Die Nennung eines Clients garantiert nicht, dass jede Version Remote-Tools, OAuth oder interaktive Tool-Ansichten unterstützt.

Checkliste für die Einrichtung durch einen Agenten

Wenn der Nutzer dich bittet, Leadbase einzurichten:

Ermittle den aktuellen Client und seine native Konfiguration für Remote-MCP. Füge einen Server namens leadbase mit der Streamable-HTTP-URL https://www.leadbase.io/api/mcp hinzu. Behalte vorhandene Server und Einstellungen bei. Wenn du den Client nicht konfigurieren kannst, nenne die genauen Einrichtungsschritte, statt eine bestehende Verbindung zu behaupten.
Folge den Schritten zur Kontoerstellung und Verbindung oben. Beginne mit Lesezugriff und fordere Schreibzugriff an, wenn er für den autorisierten Auftrag nötig ist. Unterstützt der Client nur Header, nutze den bestehenden Workspace-API-Key-Ablauf und den geschützten Speicher des Clients.
Rufe die Tool-Liste ab und prüfe den Zugriff mit einem reinen Leseaufruf wie billing_get. Starte keine kostenpflichtige Recherche als Verbindungstest. Berichte, ob Verbindung und Workspace-Zugriff geprüft wurden, und erkläre den Widerruf in den Verbindungseinstellungen des Clients. Hat eine vorhandene ChatGPT-Verbindung eine veraltete Tool-Liste, aktualisiere sie auf der Detailseite des Plugins und prüfe die Tool-Erkennung erneut.
Nutze für die erste vom Nutzer beauftragte Recherche die abgerufenen Schemas. Behalte Auftrags-ID und Idempotenzschlüssel bei, rufe Ergebnis und Kosten ab und wiederhole keine Einreichung mit unklarem Ausgang.

Erkläre bei der Einrichtung kurz die Möglichkeiten, die zum Ziel des Nutzers passen, und biete zwei oder drei konkrete Beispielaufträge in seiner Sprache an. Sage nach erfolgreicher Prüfung, was einsatzbereit ist, und schlage einen nächsten Schritt vor. Sind Autorisierung oder Tool-Erkennung noch offen, benenne den verbleibenden Schritt, statt eine erfolgreiche Verbindung zu behaupten. Biete Beispiele an, ohne sie automatisch auszuführen. Hat der Nutzer bereits einen konkreten Auftrag erteilt, arbeite daran weiter, statt die Einführung zu wiederholen.

Das OpenAPI-Dokument enthält ausführbare HTTP-Schemas. Das Lesen dieser Anleitung allein installiert keine Verbindung: Manche Web-Clients erfordern, dass der Nutzer den Connector in seinen Einstellungen hinzufügt.

Was der Client erhält

Der Server stellt typisierte Tools mit Beschreibungen bereit. Die REST-Operation enrichment.start erscheint als enrichment_start. Maßgeblich ist die aktuelle Tool-Liste. Dein Client kann zusätzlich Suche oder Codeausführung anbieten; beides ist nicht erforderlich, um die Leadbase-Eingabeschemas zu verstehen.

Ein Beispielauftrag an deinen Agenten: „Finde mit Leadbase die offiziellen Karriereseiten dieser Firmen. Liefere URLs mit Belegen, starte mit drei Datensätzen und zeige die Kosten vor der Ausweitung.“ Gib Firmennamen und Domains mit. Der Agent kann den Batch starten, seine ID behalten und Antworten später abrufen.

Drei Recherche-Einstiege

Neue Liste — sheets_research: Übergib einen Titel, Kriterien in question, die Zielanzahl count, typisierte fields und ein Text- oder URL-identityField aus diesen Feldern. sourceUrl ist reserviert und wird automatisch ergänzt. Leadbase speichert bestätigte Treffer in einem Sheet. Behalte die Batch-ID und nutze enrichment_get für Fortschritt, Trefferzahl, Sheet-Link und abgerechnete Credits. Eine kleinere bestätigte Liste ist ein Teilergebnis; fehlende Zeilen werden nicht erfunden.
Liste anreichern — sheets_enrich: Übergib sheetId und column: {"columnId":"COLUMN_UUID"} für eine vorhandene Spalte oder column: {"name":"Geschäftliche E-Mail","question":"Finde die geschäftliche E-Mail-Adresse dieser Person.","type":"email"} für eine neue. Übergib rowIds für eine Teilmenge; lasse sie nur für alle vorhandenen Zeilen weg, bis zu 10.000. Gefüllte und aktive Zellen werden übersprungen. Jede ausgewählte Zeile wird einzeln recherchiert. Werte, Quellen und Status bleiben ihren Zellen zugeordnet. Lies sie über sheets_get_enrichment_status und sheets_query aus.
Direkte Antwort — enrichment_start: Übergib 1–100 unabhängige Elemente mit bekannten Angaben, Frage und Ergebnistyp sowie einen stabilen Batch-idempotencyKey. Viele Telefon- oder E-Mail-Anfragen können gemeinsam eingereicht werden; nutze getrennte Elemente für beide Angaben pro Person. Siehe das Bulk-Kontaktbeispiel. Dabei entsteht kein Sheet. Fehlende Identitätsangaben können recherchiert werden; leere Datenbanktreffer verhindern keine Webrecherche. enrichment_get liefert mit der Batch-ID Antwort, Quellen, Status und tatsächlich abgerechnete Credits.

Alle drei laufen unabhängig von der Client-Verbindung im Hintergrund weiter. Jede Recherche-Einreichung benötigt einen eigenen stabilen idempotencyKey für diesen logischen Auftrag. Nutze nach einer unterbrochenen Einreichung denselben Idempotenzschlüssel mit unveränderten Eingaben. Ein leeres Ergebnis und ein technischer Fehler sind unterschiedliche Fälle. Offene Abrechnung bedeutet nicht null Kosten.

Die MCP-Verbindung bietet diese Recherche-Einstiege und die vollständige Sheet-Verwaltung entsprechend deinen Berechtigungen: Sheets erstellen, umbenennen und organisieren, Zeilen und Spalten bearbeiten sowie gespeicherte Ansichten, Freigaben und den Versionsverlauf verwalten. Direkte Katalog- und Anbietertools sind nicht über öffentliches MCP verfügbar. Anwendungen können die entsprechenden direkten Operationen über die HTTP-API aufrufen; gehe nicht davon aus, dass jede OpenAPI-Operation ein aufrufbares MCP-Gegenstück besitzt. view_sheet zeigt ein interaktives Sheet in Clients mit MCP-Apps-Unterstützung; andere Clients können strukturierte Sheet-Daten und den Sheet-Link nutzen.

Zugriff und Kosten

mcp:read umfasst Lesezugriffe. Kostenpflichtige Operationen benötigen den passenden Schreib-Scope und Workspace-Zugriff. Die Verbindung macht Recherche nicht kostenlos; prüfe Credits. Ein gelistetes Tool umgeht weder Berechtigungen noch Budgetgrenzen.

OAuth ist der übliche interaktive Weg. Unterstützt dein Client eigene Header, ist ein Workspace-API-Key eine weitere unterstützte Authentifizierung. Speichere ihn im Secret-Speicher des Clients.

Widerrufe die Client-Autorisierung, wenn der Zugriff enden soll. Die Abmeldung aus der App und das Trennen eines Clients sind unterschiedliche Aktionen. Bewahre bei Fehlern Tool-Name, Code und Request-IDs auf. Siehe Fehlerbehebung.