BatchData MCP (Real Estate & Contact Data)

Guía de configuración del servidor MCP remoto de BatchData

• 1 Introducción
• 2 Métodos de autenticación
  • 2.1 [Autenticación OAuth (Recomendada)](#OAuth-Authentication-(Recommended)
  • 2.2 [Autenticación con token de API (Alternativa)](#API-Token-Authentication-(Alternative)
• 3 [Mejora futura: Control de acceso OAuth (Próximamente)](#Future-Enhancement%3A-OAuth-Access-Control-(Coming-Soon)
• 4 [Configuración de OAuth (Recomendada)](#OAuth-Setup-(Recommended)
  • 4.1 Requisitos previos
  • 4.2 [Configuración de Claude (Escritorio, Web y Móvil)](#Claude-Setup-(Desktop%2C-Web-%26-Mobile)
    • 4.2.1 Paso 1: Añadir el conector de BatchData
    • 4.2.2 Paso 2: Autenticarse
    • 4.2.3 Paso 3: Habilitar el conector
    • 4.2.4 Paso 4: Aprobar el uso inicial de herramientas
    • 4.2.5 Uso en móvil
    • 4.2.6 Conexiones posteriores
  • 4.3 Configuración de Cursor
  • 4.4 Configuración de Claude Code
  • 4.5 [Configuración de ChatGPT (Modo desarrollador)](#ChatGPT-Setup-(Developer-Mode)
    • 4.5.1 Requisitos previos
    • 4.5.2 Paso 1: Habilitar el modo desarrollador
    • 4.5.3 Paso 2: Crear el conector de BatchData
    • 4.5.4 Paso 3: Autenticarse
    • 4.5.5 Uso de herramientas de BatchData en ChatGPT
    • 4.5.6 Gestionar la conexión
  • 4.6 Verificación
• 5 [Configuración con token de API (Alternativa)](#API-Token-Setup-(Alternative)
  • 5.1 Requisitos previos
  • 5.2 Configuración de Claude Desktop con token de API
    • 5.2.1 Paso 1: Instalar Node.js 22
    • 5.2.2 Paso 2: Configurar Claude Desktop
  • 5.3 Configuración de cliente MCP personalizado
• 6 Migrar de token de API a OAuth
  • 6.1 Claude Desktop
  • 6.2 Claude Code
  • 6.3 ChatGPT
  • 6.4 Beneficios de migrar
• 7 Herramientas disponibles
  • 7.1 Consulta y detalles de propiedades
  • 7.2 Análisis de propiedades comparables
  • 7.3 Búsqueda de propiedades
  • 7.4 Información de contacto
  • 7.5 Verificación telefónica
  • 7.6 Procesamiento de direcciones
• 8 Solución de problemas
  • 8.1 Problemas con OAuth
  • 8.2 Problemas con ChatGPT
  • 8.3 Problemas con el token de API
  • 8.4 Problemas generales
  • 8.5 Obtener ayuda

Introducción

Esta guía documenta cómo conectarse al servidor MCP remoto de BatchData usando su cliente compatible con MCP.

Métodos de autenticación

El servidor MCP de BatchData admite dos métodos de autenticación:

Método	Complejidad de configuración	Seguridad	Recomendado para
OAuth (Recomendado)	Simple	Alta	La mayoría de los usuarios
Token de API	Configuración manual	Moderada	Clientes MCP personalizados, depuración

Autenticación OAuth (Recomendada)

OAuth proporciona una experiencia de conexión optimizada:

• No se necesita configuración de token de API — Solo proporcione la URL del servidor
• Inicio de sesión en el navegador — Autentíquese con las credenciales de su cuenta de BatchData
• Gestión automática de tokens — Los tokens de acceso se refrescan automáticamente
• Experiencia de inicio de sesión familiar — Use correo electrónico/contraseña o Google Sign-In

Autenticación con token de API (Alternativa)

Para usuarios que prefieren la configuración directa del token de API o usan clientes MCP personalizados que no admiten OAuth:

• Requiere obtener y configurar su token de API de BatchData manualmente
• El token debe gestionarse y protegerse como una credencial sensible
• Útil para depuración, scripts de automatización o clientes sin soporte OAuth

Mejora futura: Control de acceso OAuth (Próximamente)

Estamos desarrollando funciones mejoradas de control de acceso para la autenticación OAuth:

• Verificación de permisos — El inicio de sesión OAuth verificará automáticamente si su cuenta tiene permiso para usar el servidor MCP
• Gestión de acceso centralizada — Los propietarios de equipos podrán otorgar o revocar el acceso al servidor MCP para los miembros del equipo a través de la plataforma BatchData

---

Configuración de OAuth (Recomendada)

Requisitos previos

• Una cuenta de BatchData con credenciales válidas
• Un cliente compatible con MCP (Claude Desktop/Web/Móvil, ChatGPT, Cursor, Claude Code o similar)

Configuración de Claude (Escritorio, Web y Móvil)

Claude admite servidores MCP a través de la aplicación de escritorio, la interfaz web y la aplicación móvil.

Nota para móvil: Los conectores no se pueden añadir desde la aplicación móvil. Añada el conector primero en Escritorio o Web, y estará disponible automáticamente en el móvil para la misma cuenta.

Nota para Teams/Enterprise: Los administradores del espacio de trabajo deben añadir primero el conector de BatchData a la lista de conectores disponibles antes de que los miembros del equipo puedan configurarlo. Contacte con su administrador si no ve el conector en su lista.

Paso 1: Añadir el conector de BatchData

1. Abra Claude (Escritorio o Web)
2. Vaya a Configuración → Conectores (o Configuración → Servidores MCP)
3. Haga clic en Añadir conector (o Añadir servidor)
4. Introduzca la URL del servidor:

https://mcp.batchdata.com

5. Haga clic en Añadir o Conectar

Paso 2: Autenticarse

1. Su navegador se abrirá en la página de inicio de sesión de BatchData
2. Inicie sesión usando:

• Correo electrónico y contraseña — Introduzca las credenciales de su cuenta de BatchData
• Google Sign-In — Haga clic en el botón de Google para autenticarse

3. Tras iniciar sesión correctamente, será redirigido de vuelta a Claude

Paso 3: Habilitar el conector

Los conectores no están habilitados por defecto después de añadirlos. Habilítelo una vez y la configuración se guarda:

1. Abra cualquier chat
2. Haga clic en el botón + (o el icono de conectores) en el área de entrada del chat
3. Busque BatchData en la lista de conectores disponibles
4. Actívelo para habilitarlo

El conector estará ahora disponible en todas sus conversaciones.

Paso 4: Aprobar el uso inicial de herramientas

La primera vez que Claude use cualquier herramienta de BatchData, se le pedirá que la apruebe:

1. Cuando Claude intente usar una herramienta, aparecerá un aviso de permiso
2. Revise la herramienta y la acción solicitada
3. Haga clic en Permitir para aprobar
4. Seleccione "Permitir siempre" si desea omitir la aprobación para usos futuros de esa herramienta

Nota: Después de la aprobación inicial (o de seleccionar "Permitir siempre"), los usos posteriores de la herramienta no requerirán confirmación adicional.

Uso en móvil

Una vez que haya añadido y autenticado el conector en Escritorio o Web:

• Abra la aplicación móvil de Claude con la misma cuenta
• El conector de BatchData estará disponible en su lista de conectores
• Si aún no está habilitado, actívelo mediante el botón + en la entrada del chat (la configuración se sincroniza entre dispositivos)
• Las aprobaciones de herramientas concedidas en Escritorio/Web se transfieren al móvil
• Todas las herramientas funcionan igual que en Escritorio/Web

Conexiones posteriores

Después de la autenticación inicial:

• Los tokens de acceso se almacenan en caché y se refrescan automáticamente en todos los dispositivos
• No necesitará iniciar sesión de nuevo a menos que su sesión expire (normalmente tras 14 días de inactividad)
• Si se le solicita volver a autenticarse, simplemente inicie sesión de nuevo a través de su navegador (en Escritorio o Web)

Configuración de Cursor

1. Abra la Configuración de Cursor
2. Navegue a la sección de configuración MCP
3. Haga clic en Añadir servidor MCP
4. Introduzca la URL del servidor:

https://mcp.batchdata.com

5. En el primer uso, autentíquese a través de la ventana emergente del navegador

Configuración de Claude Code

Añada el servidor MCP de BatchData directamente mediante la CLI:

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

En el primer uso, se le pedirá que se autentique a través de su navegador.

Configuración de ChatGPT (Modo desarrollador)

ChatGPT admite servidores MCP a través del Modo desarrollador, que proporciona soporte completo de cliente Model Context Protocol.

Requisitos previos

• Una suscripción a ChatGPT Plus o Pro
• Para Business/Enterprise: El administrador debe habilitar el modo desarrollador en la Configuración del espacio de trabajo

Paso 1: Habilitar el modo desarrollador

1. Abra ChatGPT
2. Vaya a Configuración → Apps y conectores → Configuración avanzada
3. Active el Modo desarrollador

Para espacios de trabajo Business/Enterprise:

• Los administradores deben habilitar primero el modo desarrollador desde Configuración del espacio de trabajo → Permisos y roles → Datos conectados → Modo desarrollador / Crear conectores MCP personalizados

Paso 2: Crear el conector de BatchData

1. En ChatGPT, vaya a Configuración → Conectores
2. Haga clic en Crear
3. Introduzca los siguientes detalles:

• Nombre del conector: BatchData
• URL del servidor MCP: https://mcp.batchdata.com

4. Haga clic en Crear

Paso 3: Autenticarse

1. Después de crear el conector, ChatGPT le pedirá que se autentique
2. Su navegador se abrirá en la página de inicio de sesión de BatchData
3. Inicie sesión usando:

• Correo electrónico y contraseña — Introduzca las credenciales de su cuenta de BatchData
• Google Sign-In — Haga clic en el botón de Google para autenticarse

4. Tras iniciar sesión correctamente, será redirigido de vuelta a ChatGPT
5. El conector de BatchData ya está listo para usar

Uso de herramientas de BatchData en ChatGPT

Una vez conectado, puede usar las herramientas de BatchData en las conversaciones:

1. Inicie un nuevo chat
2. Haga clic en el botón +, luego seleccione su conector en el menú Más
3. Alternativamente, elija Modo desarrollador en el menú Plus y seleccione BatchData
4. Haga preguntas relacionadas con propiedades — ChatGPT usará las herramientas apropiadas

Ejemplos de prompts:

• "Busca la propiedad en 123 Main Street, Los Ángeles, CA"
• "Encuentra propiedades comparables para 456 Oak Avenue"
• "Haz skip trace del propietario de 789 Pine Road, Miami, FL"

Gestionar la conexión

• Para desconectar: Vaya a Configuración → Conectores, haga clic en BatchData y desconecte
• Para reconectar: Haga clic en el conector y vuelva a autenticarse
• Expiración de sesión: Si su sesión expira (normalmente tras 14 días), se le pedirá que se reconecte

Verificación

Una vez conectado, simplemente pregunte sobre datos de propiedades o skip-tracing y el LLM usará automáticamente las herramientas de BatchData.

Ejemplos de prompts:

• "Busca la propiedad en 123 Main Street, Los Ángeles, CA"
• "Haz skip trace del propietario de 456 Oak Avenue, Miami, FL"
• "Encuentra propiedades comparables para 789 Pine Road, Austin, TX"
• "Busca propiedades vacantes en Miami, FL"
• "Verifica este número de teléfono: 555-123-4567"
• "Verifica y estandariza esta dirección: 100 main st los angeles ca"
• "Obtén las coordenadas de 200 Park Avenue, Nueva York, NY"

Claude o ChatGPT reconocerán la intención y usarán las herramientas de BatchData apropiadas para obtener la información.

---

Configuración con token de API (Alternativa)

Use este método si:

• Su cliente MCP no admite OAuth
• Necesita depurar o automatizar conexiones al servidor MCP
• Prefiere la gestión explícita de tokens

Requisitos previos

• Su token de API de BatchData (obténgalo desde la aplicación web de BatchData)
• Un cliente compatible con MCP
• Node.js 22+ (para Claude Desktop)

Configuración de Claude Desktop con token de API

Paso 1: Instalar Node.js 22

El Node.js incluido en Claude Desktop está desactualizado. Instale Node.js 22 por separado:

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:

Descargue e instale Node.js 22.x LTS desde nodejs.org

Paso 2: Configurar Claude Desktop

1. Abra Claude Desktop
2. Vaya a Configuración > Desarrollador > Editar configuración
3. Añada la siguiente configuración:

Configuración para 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" } } } }

Configuración para 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" } } } }

Configuración para 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. Reemplace YOUR_USERNAME con su nombre de usuario real
5. Reemplace YOUR_API_TOKEN_HERE con su token de API de BatchData
6. Guarde el archivo y reinicie Claude Desktop

Configuración de cliente MCP personalizado

Para implementaciones de cliente MCP personalizadas:

Detalles de conexión:

Configuración	Valor
URL del servidor	https://mcp.batchdata.com
Transporte	HTTP transmitido
Autenticación	Token Bearer mediante cabecera Authorization

Ejemplo de configuración:

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

Usando npx:

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

---

Migrar de token de API a OAuth

Si previamente configuró BatchData usando el método de token de API y desea cambiar a OAuth para una experiencia más simple, siga estos pasos:

Claude Desktop

1. Abre Claude Desktop
2. Ve a Configuración → Desarrollador → Editar configuración
3. Elimina la configuración existente de BatchData (todo el bloque con command, args y env)
4. Guarda y cierra el archivo de configuración
5. Sigue las instrucciones de Configuración de Claude (Escritorio, Web y Móvil) para añadir el conector mediante la interfaz de usuario
6. Autentícate con tu cuenta de BatchData cuando se te solicite

Antes (Token de 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" } } } }

Después (OAuth): Configurado mediante la interfaz de usuario — no es necesario editar JSON.

Claude Code

1. Elimina la configuración existente:

claude mcp remove BatchData

2. Vuelve a añadirla usando OAuth:

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

3. Autentícate a través de tu navegador cuando se te solicite

ChatGPT

Si estabas usando una solución alternativa con tokens de API, simplemente:

1. Elimina cualquier conector de BatchData existente desde Configuración → Conectores
2. Sigue las instrucciones de Configuración de ChatGPT para crear un nuevo conector
3. Autentícate con tu cuenta de BatchData

Beneficios de la migración

Aspecto	Token de API	OAuth
Configuración	Edición manual de JSON	Flujo simple en la interfaz
Gestión de tokens	Rotación manual	Renovación automática
Seguridad	Token almacenado en archivo de configuración	Tokens gestionados por el cliente
Multidispositivo	Configurar cada dispositivo	Se sincroniza entre dispositivos

---

Herramientas disponibles

Una vez conectado, el servidor MCP de BatchData proporciona las siguientes herramientas:

Búsqueda y detalles de propiedades

Herramienta	Descripción
lookup_property	Obtiene información detallada de una propiedad por ID, dirección o número de parcela

Análisis de propiedades comparables

Herramienta	Descripción
comparable_property_count	Obtiene el recuento y métricas agregadas de propiedades comparables
comparable_property_preview	Vista previa rápida de las primeras 10 propiedades comparables con campos de resumen
comparable_property_page	Acceso paginado a los detalles completos de propiedades comparables (admite paginación por desplazamiento y por cursor)
comparable_property	⚠️ Obsoleto — Devuelve todas las propiedades comparables a la vez

Búsqueda de propiedades

Herramienta	Descripción
search_properties_count	Obtiene el recuento de propiedades que coinciden con los criterios de búsqueda, con desgloses de listas rápidas
search_properties_preview	Vista previa rápida de las primeras 10 propiedades coincidentes
search_properties_page	Búsqueda paginada de propiedades con detalles completos (admite paginación por desplazamiento y por cursor)

Información de contacto

Herramienta	Descripción
skip_trace_property	Obtiene información del propietario y de contacto de una propiedad por dirección o número de parcela

Verificación telefónica

Herramienta	Descripción
verify_phone	Detalles completos de verificación, incluyendo accesibilidad, estado DNC, operador, estado de litigante TCPA
check_dnc_status	Solo verifica el estado de No Llamar
check_tcpa_status	Solo verifica el estado de litigante TCPA

Procesamiento de direcciones

Herramienta	Descripción
verify_address	Formatea direcciones según el cumplimiento de USPS
geocode_address	Obtiene coordenadas a partir de una dirección
reverse_geocode_address	Obtiene una dirección a partir de coordenadas de latitud/longitud

---

Solución de problemas

Problemas con OAuth

Problema	Solución
El navegador no se abre para iniciar sesión	Asegúrate de que las ventanas emergentes estén permitidas. Verifica que tu navegador predeterminado esté configurado correctamente.
La página de inicio de sesión muestra "Sesión expirada"	Elimina y vuelve a añadir el conector, luego autentícate de nuevo.
Error de "Demasiados intentos de inicio de sesión"	Espera 15 minutos antes de intentarlo de nuevo.
El inicio de sesión con Google no funciona	Asegúrate de que las ventanas emergentes estén permitidas e intenta usar correo electrónico/contraseña en su lugar.
La conexión falla después de iniciar sesión	Verifica tu conexión a internet. La redirección de vuelta al cliente MCP puede haber fallado. Intenta eliminar y volver a añadir el conector.

Problemas con ChatGPT

Problema	Solución
No se pueden crear conectores	Asegúrate de que el Modo Desarrollador esté habilitado en Configuración → Aplicaciones y conectores → Configuración avanzada.
Falta la opción de Modo Desarrollador	Para Business/Enterprise, el administrador de tu espacio de trabajo debe habilitarlo primero en Configuración del espacio de trabajo.
La autenticación falla	Asegúrate de que las ventanas emergentes estén permitidas para http://chatgpt.com . Intenta desconectar y volver a conectar el conector.
Las herramientas no se están usando	Sé explícito en tu indicación: "Usa el conector de BatchData para...". Añade el conector mediante el botón + antes de dar la indicación.
El conector no responde	Ve a Configuración → Conectores → BatchData → Actualizar para refrescar los metadatos. El servidor puede estar temporalmente no disponible.
Se están llamando herramientas incorrectas	Especifica: "No uses la navegación integrada ni otras herramientas; solo usa el conector de BatchData."

Problemas con el token de API

Problema	Solución
401 No autorizado	Verifica que tu token de API sea correcto y no haya expirado.
403 Prohibido	Asegúrate de que tu token tenga los permisos de endpoint requeridos en la aplicación web de BatchData.
Errores de ruta de Node.js	Verifica que la ruta a npx exista ejecutando which npx (macOS/Linux) o comprobando la ruta de instalación (Windows).
La configuración no se carga	Reinicia tu cliente MCP después de guardar el archivo de configuración.

Problemas generales

Problema	Solución
Las herramientas no aparecen	Verifica que el servidor MCP esté habilitado en la lista de extensiones de tu cliente.
SkipTracing devuelve 403	SkipTracing v3 debe estar habilitado para tu equipo por un administrador, y tu token necesita el permiso.
Respuestas lentas	Verifica tu conexión a internet. El servidor proxy envía las solicitudes a las API de BatchData.

Obtener ayuda

• Problemas con el token de API: Inicia sesión en la aplicación web de BatchData para gestionar tus tokens del lado del servidor
• Problemas de permisos: Contacta al administrador de tu equipo de BatchData
• Problemas técnicos: Contacta al equipo de soporte de BatchData

---

© BatchData 2025