BatchData MCP (Real Estate & Contact Data)

Guide de configuration du serveur MCP distant BatchData

• 1 Introduction
• 2 Méthodes d'authentification
  • 2.1 [Authentification OAuth (recommandée)](#OAuth-Authentication-(Recommended)
  • 2.2 [Authentification par jeton API (alternative)](#API-Token-Authentication-(Alternative)
• 3 [Amélioration future : contrôle d'accès OAuth (à venir)](#Future-Enhancement%3A-OAuth-Access-Control-(Coming-Soon)
• 4 [Configuration OAuth (recommandée)](#OAuth-Setup-(Recommended)
  • 4.1 Prérequis
  • 4.2 [Configuration de Claude (Desktop, Web et Mobile)](#Claude-Setup-(Desktop%2C-Web-%26-Mobile)
    • 4.2.1 Étape 1 : ajouter le connecteur BatchData
    • 4.2.2 Étape 2 : s'authentifier
    • 4.2.3 Étape 3 : activer le connecteur
    • 4.2.4 Étape 4 : approuver l'utilisation initiale de l'outil
    • 4.2.5 Utilisation sur mobile
    • 4.2.6 Connexions ultérieures
  • 4.3 Configuration de Cursor
  • 4.4 Configuration de Claude Code
  • 4.5 [Configuration de ChatGPT (mode développeur)](#ChatGPT-Setup-(Developer-Mode)
    • 4.5.1 Prérequis
    • 4.5.2 Étape 1 : activer le mode développeur
    • 4.5.3 Étape 2 : créer le connecteur BatchData
    • 4.5.4 Étape 3 : s'authentifier
    • 4.5.5 Utiliser les outils BatchData dans ChatGPT
    • 4.5.6 Gérer la connexion
  • 4.6 Vérification
• 5 [Configuration par jeton API (alternative)](#API-Token-Setup-(Alternative)
  • 5.1 Prérequis
  • 5.2 Configuration de Claude Desktop avec un jeton API
    • 5.2.1 Étape 1 : installer Node.js 22
    • 5.2.2 Étape 2 : configurer Claude Desktop
  • 5.3 Configuration d'un client MCP personnalisé
• 6 Migration du jeton API vers OAuth
  • 6.1 Claude Desktop
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 Avantages de la migration
• 7 Outils disponibles
  • 7.1 Recherche et détails de propriété
  • 7.2 Analyse de propriétés comparables
  • 7.3 Recherche de propriétés
  • 7.4 Informations de contact
  • 7.5 Vérification téléphonique
  • 7.6 Traitement d'adresse
• 8 Dépannage
  • 8.1 Problèmes OAuth
  • 8.2 Problèmes ChatGPT
  • 8.3 Problèmes de jeton API
  • 8.4 Problèmes généraux
  • 8.5 Obtenir de l'aide

Introduction

Ce guide explique comment se connecter au serveur MCP distant BatchData à l'aide de votre client compatible MCP.

Méthodes d'authentification

Le serveur MCP BatchData prend en charge deux méthodes d'authentification :

Méthode	Complexité de configuration	Sécurité	Recommandée pour
OAuth (recommandée)	Simple	Élevée	La plupart des utilisateurs
Jeton API	Configuration manuelle	Modérée	Clients MCP personnalisés, débogage

Authentification OAuth (recommandée)

OAuth offre une expérience de connexion simplifiée :

• Aucune configuration de jeton API nécessaire — Fournissez simplement l'URL du serveur
• Connexion via le navigateur — Authentifiez-vous avec vos identifiants de compte BatchData
• Gestion automatique des jetons — Les jetons d'accès sont actualisés automatiquement
• Expérience de connexion familière — Utilisez l'e-mail/mot de passe ou Google Sign-In

Authentification par jeton API (alternative)

Pour les utilisateurs qui préfèrent la configuration directe du jeton API ou qui utilisent des clients MCP personnalisés ne prenant pas en charge OAuth :

• Nécessite d'obtenir et de configurer manuellement votre jeton API BatchData
• Le jeton doit être géré et protégé comme une information d'identification sensible
• Utile pour le débogage, les scripts d'automatisation ou les clients sans prise en charge OAuth

Amélioration future : contrôle d'accès OAuth (à venir)

Nous développons des fonctionnalités de contrôle d'accès améliorées pour l'authentification OAuth :

• Vérification des autorisations — La connexion OAuth vérifiera automatiquement si votre compte a l'autorisation d'utiliser le serveur MCP
• Gestion centralisée des accès — Les propriétaires d'équipe pourront accorder ou révoquer l'accès au serveur MCP pour les membres de l'équipe via la plateforme BatchData

---

Configuration OAuth (recommandée)

Prérequis

• Un compte BatchData avec des identifiants valides
• Un client compatible MCP (Claude Desktop/Web/Mobile, ChatGPT, Cursor, Claude Code ou similaire)

Configuration de Claude (Desktop, Web et Mobile)

Claude prend en charge les serveurs MCP via l'application de bureau, l'interface Web et l'application mobile.

Note mobile : les connecteurs ne peuvent pas être ajoutés depuis l'application mobile. Ajoutez d'abord le connecteur sur Desktop ou Web, et il sera automatiquement disponible sur mobile pour le même compte.

Note Équipes/Enterprise : les administrateurs de l'espace de travail doivent d'abord ajouter le connecteur BatchData à la liste des connecteurs disponibles avant que les membres de l'équipe puissent le configurer. Contactez votre administrateur si vous ne voyez pas le connecteur dans votre liste.

Étape 1 : ajouter le connecteur BatchData

1. Ouvrez Claude (Desktop ou Web)
2. Allez dans Paramètres → Connecteurs (ou Paramètres → Serveurs MCP)
3. Cliquez sur Ajouter un connecteur (ou Ajouter un serveur)
4. Saisissez l'URL du serveur :

https://mcp.batchdata.com

5. Cliquez sur Ajouter ou Connecter

Étape 2 : s'authentifier

1. Votre navigateur s'ouvrira sur la page de connexion BatchData
2. Connectez-vous en utilisant :

• E-mail et mot de passe — Saisissez vos identifiants de compte BatchData
• Google Sign-In — Cliquez sur le bouton Google pour vous authentifier

3. Après une connexion réussie, vous serez redirigé vers Claude

Étape 3 : activer le connecteur

Les connecteurs ne sont pas activés par défaut après leur ajout. Activez-le une fois et le paramètre est sauvegardé :

1. Ouvrez une conversation
2. Cliquez sur le bouton + (ou l'icône des connecteurs) dans la zone de saisie du chat
3. Trouvez BatchData dans la liste des connecteurs disponibles
4. Basculez-le sur activé pour l'activer

Le connecteur sera désormais disponible dans toutes vos conversations.

Étape 4 : approuver l'utilisation initiale de l'outil

La première fois que Claude utilise un outil BatchData, il vous sera demandé de l'approuver :

1. Lorsque Claude tente d'utiliser un outil, une invite d'autorisation apparaîtra
2. Vérifiez l'outil et l'action demandée
3. Cliquez sur Autoriser pour approuver
4. Sélectionnez "Toujours autoriser" si vous souhaitez ignorer l'approbation pour les utilisations futures de cet outil

Note : après l'approbation initiale (ou la sélection de « Toujours autoriser »), les utilisations ultérieures de l'outil ne nécessiteront pas de confirmation supplémentaire.

Utilisation sur mobile

Une fois que vous avez ajouté et authentifié le connecteur sur Desktop ou Web :

• Ouvrez l'application mobile Claude avec le même compte
• Le connecteur BatchData sera disponible dans votre liste de connecteurs
• S'il n'est pas déjà activé, activez-le via le bouton + dans la zone de saisie du chat (le paramètre se synchronise entre les appareils)
• Les approbations d'outils accordées sur Desktop/Web sont reportées sur mobile
• Tous les outils fonctionnent de la même manière que sur Desktop/Web

Connexions ultérieures

Après l'authentification initiale :

• Les jetons d'accès sont mis en cache et actualisés automatiquement sur tous les appareils
• Vous n'aurez pas besoin de vous reconnecter, sauf si votre session expire (généralement après 14 jours d'inactivité)
• Si vous êtes invité à vous ré-authentifier, connectez-vous simplement à nouveau via votre navigateur (sur Desktop ou Web)

Configuration de Cursor

1. Ouvrez les paramètres de Cursor
2. Accédez à la section de configuration MCP
3. Cliquez sur Ajouter un serveur MCP
4. Saisissez l'URL du serveur :

https://mcp.batchdata.com

5. Lors de la première utilisation, authentifiez-vous via la fenêtre contextuelle du navigateur

Configuration de Claude Code

Ajoutez le serveur MCP BatchData directement via l'interface de ligne de commande :

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

Lors de la première utilisation, vous serez invité à vous authentifier via votre navigateur.

Configuration de ChatGPT (mode développeur)

ChatGPT prend en charge les serveurs MCP via le mode développeur, qui fournit une prise en charge complète du client Model Context Protocol.

Prérequis

• Un abonnement ChatGPT Plus ou Pro
• Pour Business/Enterprise : l'administrateur doit activer le mode développeur dans les paramètres de l'espace de travail

Étape 1 : activer le mode développeur

1. Ouvrez ChatGPT
2. Allez dans Paramètres → Applications et connecteurs → Paramètres avancés
3. Activez le mode développeur

Pour les espaces de travail Business/Enterprise :

• Les administrateurs doivent d'abord activer le mode développeur depuis Paramètres de l'espace de travail → Autorisations et rôles → Données connectées → Mode développeur / Créer des connecteurs MCP personnalisés

Étape 2 : créer le connecteur BatchData

1. Dans ChatGPT, allez dans Paramètres → Connecteurs
2. Cliquez sur Créer
3. Saisissez les détails suivants :

• Nom du connecteur : BatchData
• URL du serveur MCP : https://mcp.batchdata.com

4. Cliquez sur Créer

Étape 3 : s'authentifier

1. Après avoir créé le connecteur, ChatGPT vous invitera à vous authentifier
2. Votre navigateur s'ouvrira sur la page de connexion BatchData
3. Connectez-vous en utilisant :

• E-mail et mot de passe — Saisissez vos identifiants de compte BatchData
• Google Sign-In — Cliquez sur le bouton Google pour vous authentifier

4. Après une connexion réussie, vous serez redirigé vers ChatGPT
5. Le connecteur BatchData est maintenant prêt à être utilisé

Utiliser les outils BatchData dans ChatGPT

Une fois connecté, vous pouvez utiliser les outils BatchData dans les conversations :

1. Démarrez une nouvelle conversation
2. Cliquez sur le bouton +, puis sélectionnez votre connecteur dans le menu Plus
3. Alternativement, choisissez Mode développeur dans le menu Plus et sélectionnez BatchData
4. Posez des questions relatives aux propriétés — ChatGPT utilisera les outils appropriés

Exemples d'invites :

• « Recherche la propriété au 123 Main Street, Los Angeles, CA »
• « Trouve des propriétés comparables pour le 456 Oak Avenue »
• « Effectue une recherche inversée sur le propriétaire du 789 Pine Road, Miami, FL »

Gérer la connexion

• Pour déconnecter : allez dans Paramètres → Connecteurs, cliquez sur BatchData et déconnectez
• Pour reconnecter : cliquez sur le connecteur et ré-authentifiez-vous
• Expiration de session : si votre session expire (généralement après 14 jours), vous serez invité à vous reconnecter

Vérification

Une fois connecté, demandez simplement des données de propriété ou une recherche inversée et le LLM utilisera automatiquement les outils BatchData.

Exemples d'invites :

• « Recherche la propriété au 123 Main Street, Los Angeles, CA »
• « Effectue une recherche inversée sur le propriétaire du 456 Oak Avenue, Miami, FL »
• « Trouve des propriétés comparables pour le 789 Pine Road, Austin, TX »
• « Recherche des propriétés vacantes à Miami, FL »
• « Vérifie ce numéro de téléphone : 555-123-4567 »
• « Vérifie et standardise cette adresse : 100 main st los angeles ca »
• « Obtiens les coordonnées du 200 Park Avenue, New York, NY »

Claude ou ChatGPT reconnaîtra l'intention et utilisera les outils BatchData appropriés pour récupérer les informations.

---

Configuration par jeton API (alternative)

Utilisez cette méthode si :

• Votre client MCP ne prend pas en charge OAuth
• Vous devez déboguer ou automatiser les connexions au serveur MCP
• Vous préférez une gestion explicite des jetons

Prérequis

• Votre jeton API BatchData (à obtenir depuis l'application Web BatchData)
• Un client compatible MCP
• Node.js 22+ (pour Claude Desktop)

Configuration de Claude Desktop avec un jeton API

Étape 1 : installer Node.js 22

Le Node.js intégré de Claude Desktop est obsolète. Installez Node.js 22 séparément :

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 :

Téléchargez et installez Node.js 22.x LTS depuis nodejs.org

Étape 2 : configurer Claude Desktop

1. Ouvrez Claude Desktop
2. Allez dans Paramètres > Développeur > Modifier la configuration
3. Ajoutez la configuration suivante :

Configuration macOS :

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

Configuration Linux :

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

Configuration Windows :

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

4. Remplacez YOUR_USERNAME par votre nom d'utilisateur réel
5. Remplacez YOUR_API_TOKEN_HERE par votre jeton API BatchData
6. Enregistrez le fichier et redémarrez Claude Desktop

Configuration d'un client MCP personnalisé

Pour les implémentations de client MCP personnalisées :

Détails de connexion :

Paramètre	Valeur
URL du serveur	https://mcp.batchdata.com
Transport	HTTP diffusable en continu (Streamable HTTP)
Authentification	Jeton porteur via l'en-tête Authorization

Exemple de configuration :

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

Utilisation de npx :

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

---

Migration du jeton API vers OAuth

Si vous avez précédemment configuré BatchData en utilisant la méthode du jeton API et souhaitez passer à OAuth pour une expérience plus simple, suivez ces étapes :

Claude Desktop

1. Ouvrez Claude Desktop
2. Allez dans Paramètres → Développeur → Modifier la configuration
3. Supprimez la configuration BatchData existante (le bloc entier avec command, args et env)
4. Enregistrez et fermez le fichier de configuration
5. Suivez les instructions de Configuration Claude (Desktop, Web et Mobile) pour ajouter le connecteur via l'interface utilisateur
6. Authentifiez-vous avec votre compte BatchData lorsque vous y êtes invité

Avant (jeton API) :

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

Après (OAuth) : Configuré via l'interface utilisateur — aucune modification JSON requise.

Claude Code

1. Supprimez la configuration existante :

claude mcp remove BatchData

2. Rajoutez-la en utilisant OAuth :

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

3. Authentifiez-vous via votre navigateur lorsque vous y êtes invité

ChatGPT

Si vous utilisiez une solution de contournement avec des jetons API, il vous suffit de :

1. Supprimer tout connecteur BatchData existant depuis Paramètres → Connecteurs
2. Suivre les instructions de Configuration ChatGPT pour créer un nouveau connecteur
3. Vous authentifier avec votre compte BatchData

Avantages de la migration

Aspect	Jeton API	OAuth
Configuration	Modification manuelle du JSON	Flux simple via l'interface utilisateur
Gestion des jetons	Rotation manuelle	Actualisation automatique
Sécurité	Jeton stocké dans le fichier de configuration	Jetons gérés par le client
Multi-appareil	Configurer chaque appareil	Synchronisation entre les appareils

---

Outils disponibles

Une fois connecté, le serveur MCP BatchData fournit les outils suivants :

Recherche et détails de propriété

Outil	Description
lookup_property	Obtenir des informations détaillées sur une propriété par ID, adresse ou numéro de parcelle

Analyse de propriétés comparables

Outil	Description
comparable_property_count	Obtenir le nombre et les métriques agrégées des propriétés comparables
comparable_property_preview	Aperçu rapide des 10 premières propriétés comparables avec des champs récapitulatifs
comparable_property_page	Accès paginé aux détails complets des propriétés comparables (prend en charge la pagination par décalage et par curseur)
comparable_property	⚠️ Obsolète — Renvoie toutes les propriétés comparables en une seule fois

Recherche de propriétés

Outil	Description
search_properties_count	Obtenir le nombre de propriétés correspondant aux critères de recherche avec des répartitions par liste rapide
search_properties_preview	Aperçu rapide des 10 premières propriétés correspondantes
search_properties_page	Recherche paginée de propriétés avec tous les détails (prend en charge la pagination par décalage et par curseur)

Informations de contact

Outil	Description
skip_trace_property	Obtenir les informations sur le propriétaire et les contacts pour une propriété par adresse ou numéro de parcelle

Vérification téléphonique

Outil	Description
verify_phone	Détails complets de la vérification incluant la joignabilité, le statut DNC, l'opérateur, le statut de plaideur TCPA
check_dnc_status	Vérifier uniquement le statut de la liste Do Not Call
check_tcpa_status	Vérifier uniquement le statut de plaideur TCPA

Traitement des adresses

Outil	Description
verify_address	Formater les adresses conformément aux normes USPS
geocode_address	Obtenir les coordonnées à partir d'une adresse
reverse_geocode_address	Obtenir l'adresse à partir des coordonnées de latitude/longitude

---

Dépannage

Problèmes OAuth

Problème	Solution
Le navigateur ne s'ouvre pas pour la connexion	Assurez-vous que les pop-ups sont autorisées. Vérifiez que votre navigateur par défaut est correctement défini.
La page de connexion affiche « Session expirée »	Supprimez et rajoutez le connecteur, puis authentifiez-vous à nouveau.
Erreur « Trop de tentatives de connexion »	Attendez 15 minutes avant de réessayer.
La connexion Google ne fonctionne pas	Assurez-vous que les pop-ups sont autorisées et essayez d'utiliser l'e-mail/mot de passe à la place.
La connexion échoue après l'authentification	Vérifiez votre connexion internet. La redirection vers le client MCP a peut-être échoué. Essayez de supprimer et de rajouter le connecteur.

Problèmes ChatGPT

Problème	Solution
Impossible de créer des connecteurs	Assurez-vous que le mode développeur est activé dans Paramètres → Applications et connecteurs → Paramètres avancés.
Option du mode développeur manquante	Pour les comptes Business/Enterprise, votre administrateur d'espace de travail doit d'abord l'activer dans les paramètres de l'espace de travail.
L'authentification échoue	Assurez-vous que les pop-ups sont autorisées pour http://chatgpt.com . Essayez de déconnecter et de reconnecter le connecteur.
Les outils ne sont pas utilisés	Soyez explicite dans votre invite : « Utilisez le connecteur BatchData pour... ». Ajoutez le connecteur via le bouton + avant de formuler votre demande.
Le connecteur ne répond pas	Allez dans Paramètres → Connecteurs → BatchData → Actualiser pour mettre à jour les métadonnées. Le serveur est peut-être temporairement indisponible.
Les mauvais outils sont appelés	Précisez : « N'utilisez pas la navigation intégrée ou d'autres outils ; utilisez uniquement le connecteur BatchData. »

Problèmes de jeton API

Problème	Solution
401 Non autorisé	Vérifiez que votre jeton API est correct et n'a pas expiré.
403 Interdit	Assurez-vous que votre jeton dispose des autorisations de point de terminaison requises dans l'application Web BatchData.
Erreurs de chemin Node.js	Vérifiez que le chemin vers npx existe en exécutant which npx (macOS/Linux) ou en vérifiant le chemin d'installation (Windows).
La configuration ne se charge pas	Redémarrez votre client MCP après avoir enregistré le fichier de configuration.

Problèmes généraux

Problème	Solution
Les outils n'apparaissent pas	Vérifiez que le serveur MCP est activé dans la liste des extensions de votre client.
SkipTracing renvoie 403	SkipTracing v3 doit être activé pour votre équipe par un administrateur, et votre jeton a besoin de l'autorisation correspondante.
Réponses lentes	Vérifiez votre connexion internet. Le serveur proxyfie les requêtes vers les API BatchData.

Obtenir de l'aide

• Problèmes de jeton API : Connectez-vous à l'application Web BatchData pour gérer vos jetons côté serveur
• Problèmes d'autorisation : Contactez votre administrateur d'équipe BatchData
• Problèmes techniques : Contactez l'équipe d'assistance BatchData

---

© BatchData 2025