BatchData MCP (Real Estate & Contact Data)

официальный

MCP для обогащения данных о недвижимости и контактах

GitHub

Что можно делать с Batch Data (real Estate & Contact Data) MCP?

Поиск сведений об объекте недвижимости — Получение полной информации об объекте по адресу, кадастровому номеру или идентификатору с помощью lookup_property.
Поиск сопоставимых объектов — Получение количества, предварительного просмотра или постраничных сведений о сопоставимых объектах с помощью comparable_property_count, comparable_property_preview и comparable_property_page.
Поиск объектов недвижимости — Обнаружение объектов, соответствующих критериям, таким как статус вакантности или местоположение, с возможностью получения количества, предварительного просмотра и постраничного доступа через search_properties_count, search_properties_preview и search_properties_page.
Поиск владельцев объектов недвижимости — Получение имен владельцев и контактной информации для заданного адреса или кадастрового номера с помощью skip_trace_property.
Проверка и стандартизация адресов — Валидация адресов по стандартам USPS, геокодирование адреса в координаты или обратное геокодирование координат в адрес с помощью verify_address, geocode_address и reverse_geocode_address.
Проверка номеров телефонов — Проверка доступности номера, оператора, статуса DNC и статуса судебного разбирательства по TCPA с помощью verify_phone, check_dnc_status или check_tcpa_status.

Документация

Руководство по настройке удаленного MCP-сервера BatchData

1 Введение
2 Методы аутентификации
- 2.1 OAuth-аутентификация (рекомендуется)
- 2.2 Аутентификация по API-токену (альтернативный метод)
3 Будущее улучшение: контроль доступа OAuth (скоро)
4 Настройка OAuth (рекомендуется)
5 Настройка API-токена (альтернативный метод)
6 Переход с API-токена на OAuth
- 6.1 Claude Desktop
- 6.2 Claude Code
- 6.3 ChatGPT
- 6.4 Преимущества перехода
7 Доступные инструменты
8 Устранение неполадок
- 8.1 Проблемы с OAuth
- 8.2 Проблемы с ChatGPT
- 8.3 Проблемы с API-токеном
- 8.4 Общие проблемы
- 8.5 Получение помощи

Введение

В этом руководстве описывается, как подключиться к удаленному MCP-серверу BatchData с помощью вашего MCP-совместимого клиента.

Методы аутентификации

MCP-сервер BatchData поддерживает два метода аутентификации:

Метод	Сложность настройки	Безопасность	Рекомендуется для
OAuth (рекомендуется)	Простая	Высокая	Большинство пользователей
API-токен	Ручная настройка	Средняя	Пользовательские MCP-клиенты, отладка

OAuth-аутентификация (рекомендуется)

OAuth обеспечивает упрощенный процесс подключения:

Не требуется настройка API-токена — достаточно указать URL-адрес сервера
Вход через браузер — аутентификация с использованием учетных данных вашей учетной записи BatchData
Автоматическое управление токенами — токены доступа обновляются автоматически
Привычный процесс входа — используйте email/пароль или Google Sign-In

Аутентификация по API-токену (альтернативный метод)

Для пользователей, предпочитающих прямую настройку API-токена или использующих пользовательские MCP-клиенты, не поддерживающие OAuth:

Требуется получить и настроить ваш API-токен BatchData вручную
Токен необходимо хранить и защищать как конфиденциальные учетные данные
Полезно для отладки, скриптов автоматизации или клиентов без поддержки OAuth

Будущее улучшение: контроль доступа OAuth (скоро)

Мы разрабатываем расширенные функции контроля доступа для OAuth-аутентификации:

Проверка разрешений — вход через OAuth будет автоматически проверять, предоставлено ли вашей учетной записи разрешение на использование MCP-сервера
Централизованное управление доступом — владельцы команд смогут предоставлять или отзывать доступ к MCP-серверу для членов команды через платформу BatchData

Настройка OAuth (рекомендуется)

Предварительные требования

Учетная запись BatchData с действительными учетными данными
MCP-совместимый клиент (Claude Desktop/Web/Mobile, ChatGPT, Cursor, Claude Code или аналогичный)

Настройка Claude (Desktop, Web и Mobile)

Claude поддерживает MCP-серверы через десктопное приложение, веб-интерфейс и мобильное приложение.

Примечание для мобильных устройств: Коннекторы нельзя добавить из мобильного приложения. Сначала добавьте коннектор в Desktop или Web версии, и он автоматически станет доступен на мобильном устройстве для той же учетной записи.

Примечание для Teams/Enterprise: Администраторы рабочей области должны сначала добавить коннектор BatchData в список доступных коннекторов, прежде чем члены команды смогут его настроить. Обратитесь к администратору, если вы не видите коннектор в своем списке.

Шаг 1: Добавление коннектора BatchData

Откройте Claude (Desktop или Web)
Перейдите в Настройки → Коннекторы (или Настройки → MCP-серверы)
Нажмите Добавить коннектор (или Добавить сервер)
Введите URL-адрес сервера:

https://mcp.batchdata.com

Нажмите Добавить или Подключить

Шаг 2: Аутентификация

В браузере откроется страница входа BatchData
Войдите, используя один из способов:

Email и пароль — введите учетные данные вашей учетной записи BatchData
Google Sign-In — нажмите кнопку Google для аутентификации

После успешного входа вы будете перенаправлены обратно в Claude

Шаг 3: Включение коннектора

Коннекторы не включены по умолчанию после добавления. Включите его один раз, и настройка сохранится:

Откройте любой чат
Нажмите кнопку + (или значок коннекторов) в области ввода чата
Найдите BatchData в списке доступных коннекторов
Переключите его в положение вкл, чтобы включить

Теперь коннектор будет доступен во всех ваших беседах.

Шаг 4: Подтверждение первого использования инструмента

При первом использовании Claude любого инструмента BatchData вам будет предложено подтвердить это:

Когда Claude попытается использовать инструмент, появится запрос на разрешение
Проверьте запрашиваемый инструмент и действие
Нажмите Разрешить для подтверждения
Выберите "Всегда разрешать", если хотите пропускать подтверждение для будущих использований этого инструмента

Примечание: После первоначального подтверждения (или выбора "Всегда разрешать") последующие использования инструмента не будут требовать дополнительного подтверждения.

Использование на мобильных устройствах

После добавления и аутентификации коннектора в Desktop или Web версии:

Откройте мобильное приложение Claude с той же учетной записью
Коннектор BatchData будет доступен в вашем списке коннекторов
Если он еще не включен, включите его через кнопку + в области ввода чата (настройка синхронизируется между устройствами)
Разрешения на использование инструментов, предоставленные в Desktop/Web, переносятся на мобильное устройство
Все инструменты работают так же, как в Desktop/Web

Последующие подключения

После первоначальной аутентификации:

Токены доступа кэшируются и автоматически обновляются на всех устройствах
Вам не потребуется входить в систему снова, пока не истечет срок действия сеанса (обычно после 14 дней бездействия)
Если будет предложено повторно пройти аутентификацию, просто войдите снова через браузер (в Desktop или Web версии)

Настройка Cursor

Откройте настройки Cursor
Перейдите в раздел конфигурации MCP
Нажмите Добавить MCP-сервер
Введите URL-адрес сервера:

https://mcp.batchdata.com

При первом использовании пройдите аутентификацию через всплывающее окно браузера

Настройка Claude Code

Добавьте MCP-сервер BatchData напрямую через CLI:

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

При первом использовании вам будет предложено пройти аутентификацию через браузер.

Настройка ChatGPT (режим разработчика)

ChatGPT поддерживает MCP-серверы через режим разработчика, который обеспечивает полную поддержку клиента Model Context Protocol.

Предварительные требования

Подписка ChatGPT Plus или Pro
Для Business/Enterprise: администратор должен включить режим разработчика в настройках рабочей области

Шаг 1: Включение режима разработчика

Откройте ChatGPT
Перейдите в Настройки → Приложения и коннекторы → Расширенные настройки
Переключите Режим разработчика в положение вкл

Для рабочих областей Business/Enterprise:

Администраторы должны сначала включить режим разработчика в Настройки рабочей области → Разрешения и роли → Подключенные данные → Режим разработчика / Создание пользовательских MCP-коннекторов

Шаг 2: Создание коннектора BatchData

В ChatGPT перейдите в Настройки → Коннекторы
Нажмите Создать
Введите следующие данные:

Имя коннектора: BatchData
URL-адрес MCP-сервера: https://mcp.batchdata.com

Нажмите Создать

Шаг 3: Аутентификация

После создания коннектора ChatGPT предложит пройти аутентификацию
В браузере откроется страница входа BatchData
Войдите, используя один из способов:

Email и пароль — введите учетные данные вашей учетной записи BatchData
Google Sign-In — нажмите кнопку Google для аутентификации

После успешного входа вы будете перенаправлены обратно в ChatGPT
Коннектор BatchData готов к использованию

Использование инструментов BatchData в ChatGPT

После подключения вы можете использовать инструменты BatchData в беседах:

Начните новый чат
Нажмите кнопку +, затем выберите ваш коннектор из меню Еще
Или выберите Режим разработчика из меню Plus и выберите BatchData
Задавайте вопросы, связанные с недвижимостью — ChatGPT будет использовать соответствующие инструменты

Примеры запросов:

"Найди информацию об объекте недвижимости по адресу 123 Main Street, Los Angeles, CA"
"Найди сопоставимые объекты для 456 Oak Avenue"
"Найди контактные данные владельца 789 Pine Road, Miami, FL"

Управление подключением

Чтобы отключиться: перейдите в Настройки → Коннекторы, нажмите BatchData и отключитесь
Чтобы переподключиться: нажмите на коннектор и пройдите повторную аутентификацию
Истечение сеанса: если срок действия вашего сеанса истечет (обычно через 14 дней), вам будет предложено переподключиться

Проверка

После подключения просто спросите о данных недвижимости или поиске контактов, и LLM автоматически использует инструменты BatchData.

Примеры запросов:

"Найди информацию об объекте недвижимости по адресу 123 Main Street, Los Angeles, CA"
"Найди контактные данные владельца 456 Oak Avenue, Miami, FL"
"Найди сопоставимые объекты для 789 Pine Road, Austin, TX"
"Поищи свободные объекты недвижимости в Miami, FL"
"Проверь этот номер телефона: 555-123-4567"
"Проверь и стандартизируй этот адрес: 100 main st los angeles ca"
"Получи координаты для 200 Park Avenue, New York, NY"

Claude или ChatGPT распознают намерение и используют соответствующие инструменты BatchData для получения информации.

Настройка API-токена (альтернативный метод)

Используйте этот метод, если:

Ваш MCP-клиент не поддерживает OAuth
Вам нужно отлаживать или автоматизировать подключения к MCP-серверу
Вы предпочитаете явное управление токенами

Предварительные требования

Ваш API-токен BatchData (получите в веб-приложении BatchData)
MCP-совместимый клиент
Node.js 22+ (для Claude Desktop)

Настройка Claude Desktop с API-токеном

Шаг 1: Установка Node.js 22

Встроенный Node.js в Claude Desktop устарел. Установите Node.js 22 отдельно:

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:

Загрузите и установите Node.js 22.x LTS с nodejs.org

Шаг 2: Настройка Claude Desktop

Откройте Claude Desktop
Перейдите в Настройки > Разработчик > Редактировать конфигурацию
Добавьте следующую конфигурацию:

Конфигурация для 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" } } } }

Конфигурация для 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" } } } }

Конфигурация для 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" } } } }

Замените YOUR_USERNAME на ваше фактическое имя пользователя
Замените YOUR_API_TOKEN_HERE на ваш API-токен BatchData
Сохраните файл и перезапустите Claude Desktop

Настройка пользовательского MCP-клиента

Для пользовательских реализаций MCP-клиента:

Детали подключения:

Параметр	Значение
URL-адрес сервера	https://mcp.batchdata.com
Транспорт	Streamable HTTP
Аутентификация	Bearer-токен через заголовок Authorization

Пример конфигурации:

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

Использование npx:

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

Переход с API-токена на OAuth

Если вы ранее настраивали BatchData с использованием метода API-токена и хотите перейти на OAuth для более простого взаимодействия, выполните следующие шаги:

Claude Desktop

Откройте Claude Desktop
Перейдите в Настройки → Разработчик → Редактировать конфигурацию
Удалите существующую конфигурацию BatchData (весь блок с command, args и env)
Сохраните и закройте файл конфигурации
Следуйте инструкциям Настройка Claude (Desktop, Web и Mobile), чтобы добавить коннектор через интерфейс
При появлении запроса выполните аутентификацию с вашей учётной записью BatchData

До (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" } } } }

После (OAuth): Настраивается через интерфейс — редактирование JSON не требуется.

Claude Code

Удалите существующую конфигурацию:

claude mcp remove BatchData

Добавьте её снова, используя OAuth:

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

При появлении запроса выполните аутентификацию через браузер

ChatGPT

Если вы использовали обходной путь с API-токенами, просто:

Удалите все существующие коннекторы BatchData в разделе Настройки → Коннекторы
Следуйте инструкциям Настройка ChatGPT, чтобы создать новый коннектор
Выполните аутентификацию с вашей учётной записью BatchData

Преимущества миграции

Аспект	API-токен	OAuth
Настройка	Ручное редактирование JSON	Простой процесс в интерфейсе
Управление токенами	Ручная ротация	Автоматическое обновление
Безопасность	Токен хранится в файле конфигурации	Токены управляются клиентом
Несколько устройств	Настройка на каждом устройстве	Синхронизация между устройствами

Доступные инструменты

После подключения сервер BatchData MCP предоставляет следующие инструменты:

Поиск и сведения об объекте недвижимости

Инструмент	Описание
lookup_property	Получение подробной информации об объекте по ID, адресу или номеру участка

Анализ сопоставимых объектов

Инструмент	Описание
comparable_property_count	Получение количества и агрегированных показателей по сопоставимым объектам
comparable_property_preview	Быстрый предпросмотр первых 10 сопоставимых объектов с основными полями
comparable_property_page	Постраничный доступ к полным сведениям о сопоставимых объектах (поддерживает как смещение, так и курсорную пагинацию)
comparable_property	⚠️ Устарел — возвращает все сопоставимые объекты сразу

Поиск объектов

Инструмент	Описание
search_properties_count	Получение количества объектов, соответствующих критериям поиска, с разбивкой по быстрым спискам
search_properties_preview	Быстрый предпросмотр первых 10 подходящих объектов
search_properties_page	Постраничный поиск объектов с полными сведениями (поддерживает смещение и курсорную пагинацию)

Контактная информация

Инструмент	Описание
skip_trace_property	Получение информации о владельце и контактных данных для объекта по адресу или номеру участка

Проверка телефона

Инструмент	Описание
verify_phone	Полная проверка, включая доступность, статус «Не звонить», оператора, статус участника судебных разбирательств по TCPA
check_dnc_status	Проверка только статуса «Не звонить»
check_tcpa_status	Проверка только статуса участника судебных разбирательств по TCPA

Обработка адресов

Инструмент	Описание
verify_address	Форматирование адресов в соответствии с требованиями USPS
geocode_address	Получение координат по адресу
reverse_geocode_address	Получение адреса по координатам широты и долготы

Устранение неполадок

Проблемы с OAuth

Проблема	Решение
Браузер не открывается для входа	Убедитесь, что всплывающие окна разрешены. Проверьте, что браузер по умолчанию настроен правильно.
На странице входа отображается «Сессия истекла»	Удалите и снова добавьте коннектор, затем выполните аутентификацию заново.
Ошибка «Слишком много попыток входа»	Подождите 15 минут, прежде чем повторить попытку.
Вход через Google не работает	Убедитесь, что всплывающие окна разрешены, и попробуйте использовать email/пароль.
Сбой подключения после входа	Проверьте интернет-соединение. Возможно, не удалось выполнить перенаправление обратно в MCP-клиент. Попробуйте удалить и снова добавить коннектор.

Проблемы с ChatGPT

Проблема	Решение
Не удаётся создать коннекторы	Убедитесь, что режим разработчика включён в Настройки → Приложения и коннекторы → Дополнительные настройки.
Переключатель режима разработчика отсутствует	Для Business/Enterprise администратор рабочей области должен сначала включить его в настройках рабочей области.
Сбой аутентификации	Убедитесь, что всплывающие окна разрешены для http://chatgpt.com . Попробуйте отключить и снова подключить коннектор.
Инструменты не используются	Будьте точны в запросе: «Используй коннектор BatchData, чтобы...». Добавьте коннектор через кнопку + перед отправкой запроса.
Коннектор не отвечает	Перейдите в Настройки → Коннекторы → BatchData → Обновить, чтобы обновить метаданные. Сервер может быть временно недоступен.
Вызываются не те инструменты	Уточните: «Не используй встроенный браузинг или другие инструменты; используй только коннектор BatchData.»

Проблемы с API-токеном

Проблема	Решение
401 Unauthorized	Проверьте, что ваш API-токен корректен и не истёк.
403 Forbidden	Убедитесь, что у токена есть необходимые разрешения конечных точек в веб-приложении BatchData.
Ошибки пути Node.js	Проверьте наличие пути к npx, выполнив which npx (macOS/Linux) или проверив путь установки (Windows).
Конфигурация не загружается	Перезапустите MCP-клиент после сохранения файла конфигурации.

Общие проблемы

Проблема	Решение
Инструменты не отображаются	Убедитесь, что сервер MCP включён в списке расширений вашего клиента.
SkipTracing возвращает 403	SkipTracing v3 должен быть включён для вашей команды администратором, и у токена должно быть разрешение.
Медленные ответы	Проверьте интернет-соединение. Сервер проксирует запросы к API BatchData.

Получение помощи

Проблемы с API-токеном: Войдите в веб-приложение BatchData для управления серверными токенами
Проблемы с разрешениями: Обратитесь к администратору вашей команды BatchData
Технические проблемы: Обратитесь в службу поддержки BatchData