Zum Inhalt springen
Leadbase

KI-Clients verbinden (MCP)

Verbinde einen KI-Client mit dem Leadbase-Model-Context-Protocol-Endpunkt.

Öffne Einstellungen → MCP und kopiere die dort gezeigte Server-URL oder den Einrichtungs-Prompt. Das Panel enthält aktuelle Verbindungsanleitungen für unterstützte Clients wie Claude Code, Codex, Cursor und eine allgemeine MCP-Konfiguration.

Zugriff begrenzt halten

Die MCP-Verbindung verwendet die angemeldete Leadbase-Sitzung und den Zugriff ihres aktiven Workspace. Sie macht weder alle Workspaces noch alle Sheets öffentlich. Ein KI-Client kann nur innerhalb der Berechtigungen arbeiten, die Leadbase für diese Sitzung prüft.

Prüfe die Client-Konfiguration, bevor du sie teilst. Die URL ist ein Verbindungsdetail, kein Ersatz für Zugriffskontrolle, und darf nicht dort veröffentlicht werden, wo nicht vertrauenswürdige Nutzer deine authentifizierte Umgebung wiederverwenden könnten.

Work-E-Mail mit einem AI-Client finden

Der aktuelle MCP-Katalog kann prospects.find_email bereitstellen, wenn Workspace und Berechtigung es erlauben. Das Tool akzeptiert entweder eine kanonische LinkedIn-Profilidentität oder eine geprüfte person_at_company-Identität mit Vorname, Nachname und Unternehmensdomain. Ergänze Unternehmen, Rolle oder zweistelligen Länderkontext, wenn bereits bekannt. Beauftrage das Modell niemals, fehlenden Namen, Domain oder Profil zu erfinden.

Ein Aufruf akzeptiert 1-50 identifizierte Personen. Das ist die Nutzlast pro Aufruf und keine Grenze für das Sheet oder den gesamten Workflow. Ein Agent kann ein größeres Sheet seitenweise lesen und begrenzte Aufrufe in deterministischer Reihenfolge wiederholen. Erzeuge für jeden neuen geordneten Batch eine frische UUID oder ULID. Nutze identischen Input und Key nur erneut, um diesen Batch bei pending abzufragen.

Jeder Input erhält genau einen geordneten Status: found, not_found, pending oder failed. Ein Found-Ergebnis enthält eine berufliche E-Mail und das Provider-Quality-Label verified, likely oder unknown. Zum Stand der Dokumentation verbraucht eine gefundene Work-E-Mail einen Credit. Exact Replay, not_found, pending und failed verbrauchen keinen. Prüfe vor einem wesentlichen Lauf aktuelle Capability-Beschreibung, Workspace-Policy und Credit-Stand.

Diese Status beschreiben einen Lookup und keine Sendeentscheidung. Ein gefundenes oder vom Provider als verified bezeichnetes Ergebnis beweist weder aktuelle Beschäftigung, unabhängig bestätigte Identität, Inbox-Platzierung, Einwilligung noch Erlaubnis zum Versand. Halte Identitätsreview, Sendeinfrastruktur, Sperrlisten, Länder- und Empfängertyp-Regeln sowie die erlaubte nächste Aktion getrennt.

Direkte Telefonnummer mit einem KI-Client finden

Der aktuelle MCP-Katalog kann prospects.find_phone für einen begrenzten Lookup direkter Telefonnummern bereitstellen, wenn Workspace und Berechtigung es erlauben. Der Kontakt-Lookup benötigt mcp:write; bei einer reinen Leseberechtigung kann das Tool fehlen.

Vor einem Lauf muss ein Owner oder Admin Direkte Telefonnummern aktivieren, die rechtmäßige geschäftliche Nutzung bestätigen, das Credit-Limit für Agenten-Batches festlegen und prüfen, dass die Telefonroute für den Workspace verfügbar ist. Ein gelistetes Tool beweist nicht, dass eine Anfrage ausgeführt werden kann. Ein MCP-Aufruf akzeptiert 1-50 identifizierte Personen. Das ist eine Transportgrenze pro Aufruf und kein Limit für ein Sheet oder den gesamten Workflow. Ein Workflow kann tausende berechtigte Sheet-Zeilen verarbeiten, indem er die Tabelle seitenweise liest und mehrere begrenzte Aufrufe sendet. Aktivierungsstatus, verfügbare Credits, Rate Limits und das konfigurierte Credit-Limit können die aktuelle Batch- oder Laufgrenze trotzdem senken.

Für 5.000 berechtigte Personen sind beispielsweise mindestens 100 Aufrufe nötig, wenn jeder Aufruf 50 Personen enthält. Nutze weniger Personen, wenn das aktuelle Workspace-Limit niedriger liegt. Halte für jede Person stabile Zeilen-ID, Batch-Reihenfolge, Input-Snapshot, Request-ID, Idempotency Key und endgültiges Ergebnis fest. So bleibt ein großer Lauf fortsetzbar und prüfbar, statt zu einer undurchsichtigen Bulk-Anfrage zu werden.

Jede Person benötigt eine kanonische Profil-URL im Format https://www.linkedin.com/in/.... Ergänze aktuelles Unternehmen, Domain, Position, Name oder zweistelligen Ländercode, wenn du die Angabe bereits kennst. Erfinde niemals eine fehlende Zusatzangabe.

Erzeuge für einen neuen Batch eine neue UUID oder ULID. Wenn ein Ergebnis pending lautet, verwende dieselbe Eingabe und denselben Idempotency Key nur zum Abfragen genau dieser Anfrage. Verwende den Key nicht mit anderen Personen und starte nach einem endgültigen Ergebnis nicht stillschweigend eine neue kostenpflichtige Anfrage.

Das Ergebnis bleibt in derselben Reihenfolge wie die Eingaben und hat pro Person genau einen Status. Das öffentliche Schema unterstützt die folgenden Felder. Prüfe die Werte der aktiven Route, statt anzunehmen, dass jeder Typ geliefert wird:

  • found: enthält eine E.164-Nummer, einen Typ mobile, direct, work oder unknown und ein Qualitätslabel verified, likely oder unknown;
  • not_found: Der konfigurierte Lookup hat keine Nummer geliefert;
  • pending: Frage nach der zurückgegebenen Wartezeit mit derselben Eingabe und demselben Key erneut ab;
  • failed: Ein endgültiges nicht verfügbares oder technisches Ergebnis und kein Beweis, dass die Person keine Telefonnummer hat.

Zum Stand dieser Dokumentation verbraucht eine gefundene Telefonnummer fünf Credits. Exakte Wiederholung sowie Ergebnisse mit not_found, pending oder failed verbrauchen keine Credits. Die Tool-Antwort enthält Lookup-Status und Ergebnisfelder, aber kein Feld credits_consumed. Dokumentiere Kosten aus der beschriebenen Regel und dem Billing-Nachweis des Workspace. Prüfe vor jedem Lauf die aktuelle Funktionsbeschreibung, Workspace-Regel und den Credit-Stand, weil sich Produktbedingungen ändern können.

Diese Zustände beschreiben den Lookup und nicht die geschäftliche Entscheidung. Ein gefundenes oder als verified bezeichnetes Ergebnis belegt weder Relevanz noch aktuellen Besitz der Nummer, Erreichbarkeit, Einwilligung oder rechtliche Zulässigkeit eines Anrufs. Halte Identitätsprüfung, Sperrlisten, Länder- und Kanalprüfung sowie die erlaubte nächste Aktion als getrennte Entscheidungen fest.