BatchData MCP (Real Estate & Contact Data)

offiziell

Immobilien- und Kontaktanreicherungsdaten MCP

Was kann man mit Batch Data (real Estate & Contact Data) MCP machen?

  • Immobiliendetails abrufen — Vollständige Immobilieninformationen anhand von Adresse, Flurstücksnummer oder ID mit lookup_property abrufen.
  • Vergleichbare Immobilien finden — Anzahl, Vorschauen oder seitenweise Details vergleichbarer Immobilien mit comparable_property_count, comparable_property_preview und comparable_property_page abrufen.
  • Nach Immobilien suchen — Immobilien finden, die Kriterien wie Leerstandsstatus oder Standort entsprechen, mit Anzahl, Vorschau und seitenweisem Zugriff über search_properties_count, search_properties_preview und search_properties_page.
  • Eigentümer von Immobilien per Skip-Trace ermitteln — Eigentümernamen und Kontaktinformationen für eine bestimmte Immobilienadresse oder Flurstücksnummer mit skip_trace_property abrufen.
  • Adressen überprüfen und standardisieren — Adressen auf USPS-Standards validieren, eine Adresse in Koordinaten geokodieren oder Koordinaten in eine Adresse rückgeokodieren mit verify_address, geocode_address und reverse_geocode_address.
  • Telefonnummern überprüfen — Erreichbarkeit, Anbieter, DNC-Status und TCPA-Klage-Status einer Telefonnummer mit verify_phone, check_dnc_status oder check_tcpa_status prüfen.

Dokumentation

BatchData Remote MCP Server Einrichtungsanleitung

Einführung

Diese Anleitung dokumentiert, wie Sie sich mit Ihrem MCP-kompatiblen Client mit dem BatchData Remote MCP Server verbinden.

Authentifizierungsmethoden

Der BatchData MCP Server unterstützt zwei Authentifizierungsmethoden:

MethodeEinrichtungsaufwandSicherheitEmpfohlen für
OAuth (Empfohlen)EinfachHochDie meisten Benutzer
API-TokenManuelle KonfigurationMittelBenutzerdefinierte MCP-Clients, Debugging

OAuth-Authentifizierung (Empfohlen)

OAuth bietet eine optimierte Verbindungserfahrung:

  • Keine API-Token-Konfiguration erforderlich — Geben Sie einfach die Server-URL an
  • Browser-basierte Anmeldung — Authentifizieren Sie sich mit Ihren BatchData-Kontodaten
  • Automatische Token-Verwaltung — Zugriffstoken werden automatisch aktualisiert
  • Vertraute Anmeldeerfahrung — Verwenden Sie E-Mail/Passwort oder Google Sign-In

API-Token-Authentifizierung (Alternative)

Für Benutzer, die die direkte API-Token-Konfiguration bevorzugen oder benutzerdefinierte MCP-Clients verwenden, die OAuth nicht unterstützen:

  • Erfordert das manuelle Abrufen und Konfigurieren Ihres BatchData-API-Tokens
  • Das Token muss als sensible Anmeldeinformation verwaltet und geschützt werden
  • Nützlich für Debugging, Automatisierungsskripte oder Clients ohne OAuth-Unterstützung

Zukünftige Erweiterung: OAuth-Zugriffskontrolle (Demnächst verfügbar)

Wir entwickeln erweiterte Zugriffskontrollfunktionen für die OAuth-Authentifizierung:

  • Berechtigungsüberprüfung — Die OAuth-Anmeldung überprüft automatisch, ob Ihrem Konto die Berechtigung zur Nutzung des MCP-Servers erteilt wurde
  • Zentralisierte Zugriffsverwaltung — Teambesitzer können den MCP-Serverzugriff für Teammitglieder über die BatchData-Plattform gewähren oder entziehen

OAuth-Einrichtung (Empfohlen)

Voraussetzungen

  • Ein BatchData-Konto mit gültigen Anmeldedaten
  • Ein MCP-kompatibler Client (Claude Desktop/Web/Mobil, ChatGPT, Cursor, Claude Code oder ähnlich)

Claude-Einrichtung (Desktop, Web & Mobil)

Claude unterstützt MCP-Server über die Desktop-App, die Weboberfläche und die mobile App.

Mobil-Hinweis: Connectors können nicht über die mobile App hinzugefügt werden. Fügen Sie den Connector zuerst auf dem Desktop oder im Web hinzu, und er wird automatisch auf dem Mobilgerät für dasselbe Konto verfügbar sein.

Teams/Enterprise-Hinweis: Workspace-Administratoren müssen zuerst den BatchData-Connector zur Liste der verfügbaren Connectors hinzufügen, bevor Teammitglieder ihn konfigurieren können. Wenden Sie sich an Ihren Administrator, wenn Sie den Connector nicht in Ihrer Liste sehen.

Schritt 1: BatchData-Connector hinzufügen

  1. Öffnen Sie Claude (Desktop oder Web)
  2. Gehen Sie zu Einstellungen → Connectors (oder Einstellungen → MCP-Server)
  3. Klicken Sie auf Connector hinzufügen (oder Server hinzufügen)
  4. Geben Sie die Server-URL ein:
https://mcp.batchdata.com
  1. Klicken Sie auf Hinzufügen oder Verbinden

Schritt 2: Authentifizieren

  1. Ihr Browser öffnet die BatchData-Anmeldeseite
  2. Melden Sie sich an mit:
  • E-Mail und Passwort — Geben Sie Ihre BatchData-Kontodaten ein
  • Google Sign-In — Klicken Sie auf die Google-Schaltfläche, um sich zu authentifizieren
  1. Nach erfolgreicher Anmeldung werden Sie zurück zu Claude geleitet

Schritt 3: Connector aktivieren

Connectors sind nach dem Hinzufügen standardmäßig nicht aktiviert. Aktivieren Sie ihn einmal, und die Einstellung wird gespeichert:

  1. Öffnen Sie einen beliebigen Chat
  2. Klicken Sie auf die Schaltfläche + (oder das Connectors-Symbol) im Chat-Eingabebereich
  3. Suchen Sie BatchData in der Liste der verfügbaren Connectors
  4. Schalten Sie ihn ein, um ihn zu aktivieren

Der Connector ist nun in all Ihren Konversationen verfügbar.

Schritt 4: Erstmalige Tool-Nutzung genehmigen

Wenn Claude zum ersten Mal ein BatchData-Tool verwendet, werden Sie um Genehmigung gebeten:

  1. Wenn Claude versucht, ein Tool zu verwenden, erscheint eine Berechtigungsaufforderung
  2. Überprüfen Sie das angeforderte Tool und die Aktion
  3. Klicken Sie auf Zulassen, um zu genehmigen
  4. Wählen Sie "Immer zulassen", wenn Sie die Genehmigung für zukünftige Verwendungen dieses Tools überspringen möchten

Hinweis: Nach der ersten Genehmigung (oder der Auswahl von "Immer zulassen") erfordern nachfolgende Tool-Nutzungen keine zusätzliche Bestätigung.

Nutzung auf Mobilgeräten

Sobald Sie den Connector auf dem Desktop oder im Web hinzugefügt und authentifiziert haben:

  • Öffnen Sie die mobile Claude-App mit demselben Konto
  • Der BatchData-Connector ist in Ihrer Connector-Liste verfügbar
  • Falls noch nicht aktiviert, schalten Sie ihn über die Schaltfläche + im Chat-Eingabebereich ein (Einstellung wird geräteübergreifend synchronisiert)
  • Auf Desktop/Web erteilte Tool-Genehmigungen gelten auch für Mobilgeräte
  • Alle Tools funktionieren genauso wie auf Desktop/Web

Nachfolgende Verbindungen

Nach der ersten Authentifizierung:

  • Zugriffstoken werden zwischengespeichert und geräteübergreifend automatisch aktualisiert
  • Sie müssen sich nicht erneut anmelden, es sei denn, Ihre Sitzung läuft ab (normalerweise nach 14 Tagen Inaktivität)
  • Wenn Sie zur erneuten Authentifizierung aufgefordert werden, melden Sie sich einfach erneut über Ihren Browser an (auf Desktop oder Web)

Cursor-Einrichtung

  1. Öffnen Sie die Cursor-Einstellungen
  2. Navigieren Sie zum MCP-Konfigurationsbereich
  3. Klicken Sie auf MCP-Server hinzufügen
  4. Geben Sie die Server-URL ein:
https://mcp.batchdata.com
  1. Authentifizieren Sie sich bei der ersten Verwendung über das Browser-Popup

Claude Code-Einrichtung

Fügen Sie den BatchData MCP-Server direkt über die CLI hinzu:

claude mcp add BatchData --url https://mcp.batchdata.com

Bei der ersten Verwendung werden Sie aufgefordert, sich über Ihren Browser zu authentifizieren.

ChatGPT-Einrichtung (Entwicklermodus)

ChatGPT unterstützt MCP-Server über den Entwicklermodus, der vollständige Model Context Protocol-Client-Unterstützung bietet.

Voraussetzungen

  • Ein ChatGPT Plus- oder Pro-Abonnement
  • Für Business/Enterprise: Der Administrator muss den Entwicklermodus in den Workspace-Einstellungen aktivieren

Schritt 1: Entwicklermodus aktivieren

  1. Öffnen Sie ChatGPT
  2. Gehen Sie zu Einstellungen → Apps & Connectors → Erweiterte Einstellungen
  3. Schalten Sie den Entwicklermodus ein

Für Business/Enterprise-Workspaces:

  • Administratoren müssen zuerst den Entwicklermodus unter Workspace-Einstellungen → Berechtigungen & Rollen → Verbundene Daten → Entwicklermodus / Benutzerdefinierte MCP-Connectors erstellen aktivieren

Schritt 2: BatchData-Connector erstellen

  1. Gehen Sie in ChatGPT zu Einstellungen → Connectors
  2. Klicken Sie auf Erstellen
  3. Geben Sie die folgenden Details ein:
  • Connector-Name: BatchData
  • MCP-Server-URL: https://mcp.batchdata.com
  1. Klicken Sie auf Erstellen

Schritt 3: Authentifizieren

  1. Nach dem Erstellen des Connectors fordert ChatGPT Sie zur Authentifizierung auf
  2. Ihr Browser öffnet die BatchData-Anmeldeseite
  3. Melden Sie sich an mit:
  • E-Mail und Passwort — Geben Sie Ihre BatchData-Kontodaten ein
  • Google Sign-In — Klicken Sie auf die Google-Schaltfläche, um sich zu authentifizieren
  1. Nach erfolgreicher Anmeldung werden Sie zurück zu ChatGPT geleitet
  2. Der BatchData-Connector ist jetzt einsatzbereit

BatchData-Tools in ChatGPT verwenden

Sobald die Verbindung hergestellt ist, können Sie BatchData-Tools in Konversationen verwenden:

  1. Starten Sie einen neuen Chat
  2. Klicken Sie auf die Schaltfläche + und wählen Sie dann Ihren Connector aus dem Menü Mehr
  3. Alternativ wählen Sie Entwicklermodus aus dem Plus-Menü und wählen BatchData
  4. Stellen Sie immobilienbezogene Fragen — ChatGPT verwendet die entsprechenden Tools

Beispiel-Prompts:

  • "Suchen Sie die Immobilie in der 123 Main Street, Los Angeles, CA"
  • "Finden Sie vergleichbare Immobilien für 456 Oak Avenue"
  • "Ermitteln Sie den Eigentümer von 789 Pine Road, Miami, FL"

Verbindung verwalten

  • Zum Trennen: Gehen Sie zu Einstellungen → Connectors, klicken Sie auf BatchData und trennen Sie die Verbindung
  • Zum erneuten Verbinden: Klicken Sie auf den Connector und authentifizieren Sie sich erneut
  • Sitzungsablauf: Wenn Ihre Sitzung abläuft (normalerweise nach 14 Tagen), werden Sie aufgefordert, die Verbindung wiederherzustellen

Verifizierung

Fragen Sie nach der Verbindung einfach nach Immobiliendaten oder Skip-Tracing, und das LLM verwendet automatisch die BatchData-Tools.

Beispiel-Prompts:

  • "Suchen Sie die Immobilie in der 123 Main Street, Los Angeles, CA"
  • "Ermitteln Sie den Eigentümer von 456 Oak Avenue, Miami, FL"
  • "Finden Sie vergleichbare Immobilien für 789 Pine Road, Austin, TX"
  • "Suchen Sie nach leerstehenden Immobilien in Miami, FL"
  • "Verifizieren Sie diese Telefonnummer: 555-123-4567"
  • "Verifizieren und standardisieren Sie diese Adresse: 100 main st los angeles ca"
  • "Ermitteln Sie die Koordinaten für 200 Park Avenue, New York, NY"

Claude oder ChatGPT erkennen die Absicht und verwenden die entsprechenden BatchData-Tools, um die Informationen abzurufen.


API-Token-Einrichtung (Alternative)

Verwenden Sie diese Methode, wenn:

  • Ihr MCP-Client OAuth nicht unterstützt
  • Sie MCP-Serververbindungen debuggen oder automatisieren müssen
  • Sie explizite Token-Verwaltung bevorzugen

Voraussetzungen

  • Ihr BatchData-API-Token (erhältlich über die BatchData-Web-App)
  • Ein MCP-kompatibler Client
  • Node.js 22+ (für Claude Desktop)

Claude Desktop-Einrichtung mit API-Token

Schritt 1: Node.js 22 installieren

Das in Claude Desktop gebündelte Node.js ist veraltet. Installieren Sie Node.js 22 separat:

macOS/Linux:

# Install Volta (Node.js version manager) curl https://get.volta.sh | bash # Restart terminal, then install Node.js 22 volta install node@22 # Find your username for the config below whoami

Windows:

Laden Sie Node.js 22.x LTS von nodejs.org herunter und installieren Sie es

Schritt 2: Claude Desktop konfigurieren

  1. Öffnen Sie Claude Desktop
  2. Gehen Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten
  3. Fügen Sie die folgende Konfiguration hinzu:

macOS-Konfiguration:

{ "mcpServers": { "BatchData": { "command": "/Users/YOUR_USERNAME/.volta/bin/npx", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }

Linux-Konfiguration:

{ "mcpServers": { "BatchData": { "command": "/home/YOUR_USERNAME/.volta/bin/npx", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }

Windows-Konfiguration:

{ "mcpServers": { "BatchData": { "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": [ "-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN_HERE" } } } }
  1. Ersetzen Sie YOUR_USERNAME durch Ihren tatsächlichen Benutzernamen
  2. Ersetzen Sie YOUR_API_TOKEN_HERE durch Ihr BatchData-API-Token
  3. Speichern Sie die Datei und starten Sie Claude Desktop neu

Benutzerdefinierte MCP-Client-Einrichtung

Für benutzerdefinierte MCP-Client-Implementierungen:

Verbindungsdetails:

EinstellungWert
Server-URLhttps://mcp.batchdata.com
TransportStreamable HTTP
AuthentifizierungBearer-Token über Authorization-Header

Konfigurationsbeispiel:

{ "server_url": "https://mcp.batchdata.com", "headers": { "Authorization": "Bearer YOUR_API_TOKEN_HERE" } }

Verwendung von npx:

npx mcp-remote https://mcp.batchdata.com --header "Authorization:Bearer YOUR_API_TOKEN_HERE"

Migration von API-Token zu OAuth

Wenn Sie BatchData zuvor mit der API-Token-Methode eingerichtet haben und für ein einfacheres Erlebnis zu OAuth wechseln möchten, befolgen Sie diese Schritte:

Claude Desktop

  1. Öffnen Sie Claude Desktop
  2. Gehen Sie zu Einstellungen → Entwickler → Konfiguration bearbeiten
  3. Entfernen Sie die bestehende BatchData-Konfiguration (den gesamten Block mit command, args und env)
  4. Speichern und schließen Sie die Konfigurationsdatei
  5. Befolgen Sie die Anleitung Claude Einrichtung (Desktop, Web & Mobil), um den Connector über die Benutzeroberfläche hinzuzufügen
  6. Authentifizieren Sie sich bei Aufforderung mit Ihrem BatchData-Konto

Vorher (API-Token):

{ "mcpServers": { "BatchData": { "command": "/Users/YOUR_USERNAME/.volta/bin/npx", "args": ["-y", "mcp-remote", "https://mcp.batchdata.com", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer YOUR_API_TOKEN" } } } }

Nachher (OAuth): Konfiguriert über die Benutzeroberfläche – keine JSON-Bearbeitung erforderlich.

Claude Code

  1. Entfernen Sie die bestehende Konfiguration:
claude mcp remove BatchData
  1. Fügen Sie sie mit OAuth wieder hinzu:
claude mcp add BatchData --url https://mcp.batchdata.com
  1. Authentifizieren Sie sich bei Aufforderung über Ihren Browser

ChatGPT

Wenn Sie einen Workaround mit API-Tokens verwendet haben, gehen Sie einfach wie folgt vor:

  1. Entfernen Sie alle vorhandenen BatchData-Connectors unter Einstellungen → Connectors
  2. Befolgen Sie die Anleitung ChatGPT Einrichtung, um einen neuen Connector zu erstellen
  3. Authentifizieren Sie sich mit Ihrem BatchData-Konto

Vorteile der Migration

AspektAPI-TokenOAuth
EinrichtungManuelle JSON-BearbeitungEinfacher UI-Ablauf
Token-VerwaltungManuelle RotationAutomatische Aktualisierung
SicherheitToken in Konfigurationsdatei gespeichertTokens werden vom Client verwaltet
Mehrere GeräteJedes Gerät einzeln konfigurierenGeräteübergreifende Synchronisierung

Verfügbare Werkzeuge

Sobald die Verbindung hergestellt ist, stellt der BatchData MCP-Server die folgenden Werkzeuge bereit:

Immobiliensuche & Details

WerkzeugBeschreibung
lookup_propertyDetaillierte Immobilieninformationen anhand von ID, Adresse oder Parzellennummer abrufen

Vergleichbare Immobilienanalyse

WerkzeugBeschreibung
comparable_property_countAnzahl und aggregierte Metriken vergleichbarer Immobilien abrufen
comparable_property_previewSchnelle Vorschau der ersten 10 vergleichbaren Immobilien mit Zusammenfassungsfeldern
comparable_property_pageSeitenweiser Zugriff auf vollständige Details vergleichbarer Immobilien (unterstützt sowohl offset- als auch cursor-basierte Paginierung)
comparable_property⚠️ Veraltet – Gibt alle vergleichbaren Immobilien auf einmal zurück

Immobiliensuche

WerkzeugBeschreibung
search_properties_countAnzahl der Immobilien, die den Suchkriterien entsprechen, mit Quicklist-Aufschlüsselungen abrufen
search_properties_previewSchnelle Vorschau der ersten 10 passenden Immobilien
search_properties_pageSeitenweise Immobiliensuche mit vollständigen Details (unterstützt offset- und cursor-basierte Paginierung)

Kontaktinformationen

WerkzeugBeschreibung
skip_trace_propertyEigentümer- und Kontaktinformationen für eine Immobilie anhand von Adresse oder Parzellennummer abrufen

Telefonverifizierung

WerkzeugBeschreibung
verify_phoneVollständige Verifizierungsdetails einschließlich Erreichbarkeit, DNC-Status, Anbieter, TCPA-Klägerstatus
check_dnc_statusNur den „Do Not Call“-Status prüfen
check_tcpa_statusNur den TCPA-Klägerstatus prüfen

Adressverarbeitung

WerkzeugBeschreibung
verify_addressAdressen gemäß USPS-Konformität formatieren
geocode_addressKoordinaten von einer Adresse abrufen
reverse_geocode_addressAdresse anhand von Breiten-/Längenkoordinaten abrufen

Fehlerbehebung

OAuth-Probleme

ProblemLösung
Browser öffnet sich nicht zur AnmeldungStellen Sie sicher, dass Pop-ups erlaubt sind. Überprüfen Sie, ob Ihr Standardbrowser korrekt eingestellt ist.
Anmeldeseite zeigt „Sitzung abgelaufen“Entfernen und fügen Sie den Connector erneut hinzu und authentifizieren Sie sich dann erneut.
Fehler „Zu viele Anmeldeversuche“Warten Sie 15 Minuten, bevor Sie es erneut versuchen.
Google-Anmeldung funktioniert nichtStellen Sie sicher, dass Pop-ups erlaubt sind, und versuchen Sie stattdessen die Anmeldung mit E-Mail/Passwort.
Verbindung schlägt nach der Anmeldung fehlÜberprüfen Sie Ihre Internetverbindung. Die Weiterleitung zurück zum MCP-Client ist möglicherweise fehlgeschlagen. Versuchen Sie, den Connector zu entfernen und erneut hinzuzufügen.

ChatGPT-Probleme

ProblemLösung
Connectors können nicht erstellt werdenStellen Sie sicher, dass der Entwicklermodus unter Einstellungen → Apps & Connectors → Erweiterte Einstellungen aktiviert ist.
Umschalter für Entwicklermodus fehltBei Business/Enterprise muss Ihr Workspace-Administrator dies zuerst in den Workspace-Einstellungen aktivieren.
Authentifizierung schlägt fehlStellen Sie sicher, dass Pop-ups für http://chatgpt.com erlaubt sind. Versuchen Sie, den Connector zu trennen und erneut zu verbinden.
Werkzeuge werden nicht verwendetSeien Sie explizit in Ihrer Eingabeaufforderung: „Verwenden Sie den BatchData-Connector, um...“. Fügen Sie den Connector vor der Eingabeaufforderung über die Schaltfläche + hinzu.
Connector reagiert nichtGehen Sie zu Einstellungen → Connectors → BatchData → Aktualisieren, um die Metadaten zu aktualisieren. Der Server ist möglicherweise vorübergehend nicht verfügbar.
Falsche Werkzeuge werden aufgerufenGeben Sie an: „Verwenden Sie keine integrierten Browser- oder anderen Werkzeuge; verwenden Sie nur den BatchData-Connector.“

API-Token-Probleme

ProblemLösung
401 UnauthorizedÜberprüfen Sie, ob Ihr API-Token korrekt und nicht abgelaufen ist.
403 ForbiddenStellen Sie sicher, dass Ihr Token die erforderlichen Endpunktberechtigungen in der BatchData-Web-App hat.
Node.js-PfadfehlerÜberprüfen Sie, ob der Pfad zu npx existiert, indem Sie which npx (macOS/Linux) ausführen oder den Installationspfad (Windows) überprüfen.
Konfiguration wird nicht geladenStarten Sie Ihren MCP-Client nach dem Speichern der Konfigurationsdatei neu.

Allgemeine Probleme

ProblemLösung
Werkzeuge erscheinen nichtÜberprüfen Sie, ob der MCP-Server in der Erweiterungsliste Ihres Clients aktiviert ist.
SkipTracing gibt 403 zurückSkipTracing v3 muss für Ihr Team von einem Administrator aktiviert werden, und Ihr Token benötigt die entsprechende Berechtigung.
Langsame AntwortenÜberprüfen Sie Ihre Internetverbindung. Der Server leitet Anfragen an die BatchData-APIs weiter.

Hilfe erhalten

  • API-Token-Probleme: Melden Sie sich in der BatchData-Web-App an, um Ihre serverseitigen Tokens zu verwalten
  • Berechtigungsprobleme: Wenden Sie sich an Ihren BatchData-Teamadministrator
  • Technische Probleme: Wenden Sie sich an das BatchData-Supportteam

© BatchData 2025