BatchData MCP (Real Estate & Contact Data)

官方

房地产与联系人增强数据MCP

GitHub

你可以用 Batch Data (real Estate & Contact Data) MCP 做什么？

查询房产详情 — 通过地址、地块编号或ID使用lookup_property获取完整的房产信息。
查找可比房产 — 使用comparable_property_count、comparable_property_preview和comparable_property_page获取可比房产的数量、预览或分页详情。
搜索房产 — 通过search_properties_count、search_properties_preview和search_properties_page，按空置状态或位置等条件搜索房产，支持数量统计、预览和分页访问。
跳过追踪房产所有者 — 使用skip_trace_property获取指定房产地址或地块编号的所有者姓名和联系信息。
验证并标准化地址 — 使用verify_address将地址验证为USPS标准，使用geocode_address将地址地理编码为坐标，或使用reverse_geocode_address将坐标反向地理编码为地址。
验证电话号码 — 使用verify_phone、check_dnc_status或check_tcpa_status检查电话的可达性、运营商、DNC状态和TCPA诉讼状态。

文档

BatchData 远程 MCP 服务器设置指南

1 简介
2 认证方式
- 2.1 [OAuth 认证（推荐）](#OAuth-Authentication-(Recommended)
- 2.2 [API 令牌认证（备选）](#API-Token-Authentication-(Alternative)
3 [未来增强：OAuth 访问控制（即将推出）](#Future-Enhancement%3A-OAuth-Access-Control-(Coming-Soon)
4 [OAuth 设置（推荐）](#OAuth-Setup-(Recommended)
- 4.1 前提条件
- 4.2 [Claude 设置（桌面版、网页版和移动版）](#Claude-Setup-(Desktop%2C-Web-%26-Mobile)
  - 4.2.1 第 1 步：添加 BatchData 连接器
  - 4.2.2 第 2 步：进行认证
  - 4.2.3 第 3 步：启用连接器
  - 4.2.4 第 4 步：批准首次工具使用
  - 4.2.5 在移动设备上使用
  - 4.2.6 后续连接
- 4.3 Cursor 设置
- 4.4 Claude Code 设置
- 4.5 [ChatGPT 设置（开发者模式）](#ChatGPT-Setup-(Developer-Mode)
  - 4.5.1 前提条件
  - 4.5.2 第 1 步：启用开发者模式
  - 4.5.3 第 2 步：创建 BatchData 连接器
  - 4.5.4 第 3 步：进行认证
  - 4.5.5 在 ChatGPT 中使用 BatchData 工具
  - 4.5.6 管理连接
- 4.6 验证
5 [API 令牌设置（备选）](#API-Token-Setup-(Alternative)
- 5.1 前提条件
- 5.2 使用 API 令牌进行 Claude 桌面版设置
  - 5.2.1 第 1 步：安装 Node.js 22
  - 5.2.2 第 2 步：配置 Claude 桌面版
- 5.3 自定义 MCP 客户端设置
6 从 API 令牌迁移到 OAuth
- 6.1 Claude 桌面版
- 6.2 Claude Code
- 6.3 ChatGPT
- 6.4 迁移的好处
7 可用工具
- 7.1 房产查询与详情
- 7.2 可比房产分析
- 7.3 房产搜索
- 7.4 联系信息
- 7.5 电话验证
- 7.6 地址处理
8 故障排除
- 8.1 OAuth 问题
- 8.2 ChatGPT 问题
- 8.3 API 令牌问题
- 8.4 一般问题
- 8.5 获取帮助

简介

本指南介绍如何使用兼容 MCP 的客户端连接到 BatchData 远程 MCP 服务器。

认证方式

BatchData MCP 服务器支持两种认证方式：

方式	设置复杂度	安全性	推荐对象
OAuth（推荐）	简单	高	大多数用户
API 令牌	手动配置	中等	自定义 MCP 客户端、调试

OAuth 认证（推荐）

OAuth 提供简化的连接体验：

无需配置 API 令牌 — 只需提供服务器 URL
基于浏览器的登录 — 使用您的 BatchData 账户凭据进行认证
自动令牌管理 — 访问令牌自动刷新
熟悉的登录体验 — 使用电子邮件/密码或 Google 登录

API 令牌认证（备选）

适用于偏好直接配置 API 令牌或使用不支持 OAuth 的自定义 MCP 客户端的用户：

需要手动获取并配置您的 BatchData API 令牌
令牌必须作为敏感凭据进行管理和保护
适用于调试、自动化脚本或不支持 OAuth 的客户端

未来增强：OAuth 访问控制（即将推出）

我们正在为 OAuth 认证开发增强的访问控制功能：

权限验证 — OAuth 登录将自动验证您的账户是否已被授予使用 MCP 服务器的权限
集中式访问管理 — 团队所有者将能够通过 BatchData 平台为团队成员授予或撤销 MCP 服务器访问权限

OAuth 设置（推荐）

前提条件

拥有有效凭据的 BatchData 账户
兼容 MCP 的客户端（Claude 桌面版/网页版/移动版、ChatGPT、Cursor、Claude Code 或类似客户端）

Claude 设置（桌面版、网页版和移动版）

Claude 通过桌面应用、网页界面和移动应用支持 MCP 服务器。

移动端注意：无法从移动应用添加连接器。请先在桌面版或网页版上添加连接器，它将自动在同一账户的移动端可用。

团队/企业版注意：工作区管理员必须先将 BatchData 连接器添加到可用连接器列表中，团队成员才能进行配置。如果您在列表中看不到该连接器，请联系您的管理员。

第 1 步：添加 BatchData 连接器

打开 Claude（桌面版或网页版）
前往 设置 → 连接器（或 设置 → MCP 服务器）
点击 添加连接器（或 添加服务器）
输入服务器 URL：

https://mcp.batchdata.com

点击添加或连接

第 2 步：进行认证

您的浏览器将打开 BatchData 登录页面
使用以下任一方式登录：

电子邮件和密码 — 输入您的 BatchData 账户凭据
Google 登录 — 点击 Google 按钮进行认证

成功登录后，您将被重定向回 Claude

第 3 步：启用连接器

连接器在添加后默认未启用。只需启用一次，设置即会保存：

打开任意聊天
点击聊天输入区域中的 + 按钮（或连接器图标）
在可用连接器列表中找到 BatchData
将其切换为开启以启用

该连接器现在将在您的所有对话中可用。

第 4 步：批准首次工具使用

Claude 首次使用任何 BatchData 工具时，系统会要求您批准：

当 Claude 尝试使用某个工具时，将出现权限提示
查看所请求的工具和操作
点击允许以批准
如果您希望以后使用该工具时跳过批准，请选择 “始终允许”

注意：在首次批准（或选择“始终允许”）后，后续使用工具将无需额外确认。

在移动设备上使用

在桌面版或网页版上添加并认证连接器后：

使用同一账户打开 Claude 移动应用
BatchData 连接器将在您的连接器列表中可用
如果尚未启用，通过聊天输入中的 + 按钮将其开启（设置跨设备同步）
在桌面版/网页版上授予的工具批准将延续到移动端
所有工具的使用方式与桌面版/网页版相同

后续连接

首次认证后：

访问令牌将缓存并在所有设备上自动刷新
除非您的会话过期（通常在 14 天不活动后），否则无需再次登录
如果提示重新认证，只需通过浏览器再次登录（在桌面版或网页版上）

Cursor 设置

打开 Cursor 设置
导航到 MCP 配置部分
点击 添加 MCP 服务器
输入服务器 URL：

https://mcp.batchdata.com

首次使用时，通过浏览器弹窗进行认证

Claude Code 设置

通过 CLI 直接添加 BatchData MCP 服务器：

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

首次使用时，系统将提示您通过浏览器进行认证。

ChatGPT 设置（开发者模式）

ChatGPT 通过开发者模式支持 MCP 服务器，该模式提供完整的模型上下文协议客户端支持。

前提条件

ChatGPT Plus 或 Pro 订阅
对于企业/商业版：管理员必须在工作区设置中启用开发者模式

第 1 步：启用开发者模式

打开 ChatGPT
前往 设置 → 应用与连接器 → 高级设置
将 开发者模式 切换为开启

对于企业/商业版工作区：

管理员必须首先从 工作区设置 → 权限与角色 → 已连接数据 → 开发者模式 / 创建自定义 MCP 连接器 启用开发者模式

第 2 步：创建 BatchData 连接器

在 ChatGPT 中，前往 设置 → 连接器
点击创建
输入以下详细信息：

连接器名称：BatchData
MCP 服务器 URL：https://mcp.batchdata.com

点击创建

第 3 步：进行认证

创建连接器后，ChatGPT 将提示您进行认证
您的浏览器将打开 BatchData 登录页面
使用以下任一方式登录：

电子邮件和密码 — 输入您的 BatchData 账户凭据
Google 登录 — 点击 Google 按钮进行认证

成功登录后，您将被重定向回 ChatGPT
BatchData 连接器现在可以使用了

在 ChatGPT 中使用 BatchData 工具

连接后，您可以在对话中使用 BatchData 工具：

开始新聊天
点击 + 按钮，然后从更多菜单中选择您的连接器
或者，从 Plus 菜单 中选择 开发者模式，然后选择 BatchData
提出与房产相关的问题 — ChatGPT 将使用适当的工具

示例提示：

“查询位于加利福尼亚州洛杉矶主街 123 号的房产”
“查找橡树大道 456 号的可比房产”
“跳过追踪佛罗里达州迈阿密松树路 789 号的业主”

管理连接

断开连接：前往 设置 → 连接器，点击 BatchData，然后断开连接
重新连接：点击连接器并重新认证
会话过期：如果您的会话过期（通常在 14 天后），系统将提示您重新连接

验证

连接后，只需询问房产数据或跳过追踪，LLM 将自动使用 BatchData 工具。

示例提示：

“查询位于加利福尼亚州洛杉矶主街 123 号的房产”
“跳过追踪佛罗里达州迈阿密橡树大道 456 号的业主”
“查找德克萨斯州奥斯汀松树路 789 号的可比房产”
“搜索佛罗里达州迈阿密的空置房产”
“验证此电话号码：555-123-4567”
“验证并标准化此地址：100 main st los angeles ca”
“获取纽约州纽约市公园大道 200 号的坐标”

Claude 或 ChatGPT 将识别意图并使用适当的 BatchData 工具来获取信息。

API 令牌设置（备选）

在以下情况下使用此方法：

您的 MCP 客户端不支持 OAuth
您需要调试或自动化 MCP 服务器连接
您偏好显式的令牌管理

前提条件

您的 BatchData API 令牌（从 BatchData Web 应用获取）
兼容 MCP 的客户端
Node.js 22+（用于 Claude 桌面版）

使用 API 令牌进行 Claude 桌面版设置

第 1 步：安装 Node.js 22

Claude 桌面版自带的 Node.js 已过时。请单独安装 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：

从 nodejs.org 下载并安装 Node.js 22.x LTS

第 2 步：配置 Claude 桌面版

打开 Claude 桌面版
前往 设置 > 开发者 > 编辑配置
添加以下配置：

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 替换为您的 BatchData API 令牌
保存文件并重启 Claude 桌面版

自定义 MCP 客户端设置

对于自定义 MCP 客户端实现：

连接详情：

设置	值
服务器 URL	https://mcp.batchdata.com
传输方式	可流式传输的 HTTP
认证	通过 Authorization 标头的 Bearer 令牌

配置示例：

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

如果您之前使用 API 令牌方法设置了 BatchData，并希望切换到 OAuth 以获得更简单的体验，请按照以下步骤操作：

Claude 桌面版

打开 Claude 桌面版
前往 设置 → 开发者 → 编辑配置
删除现有的 BatchData 配置（包含 command、args 和 env 的整个代码块）
保存并关闭配置文件
按照 Claude 设置（桌面版、网页版和移动版）的说明，通过 UI 添加连接器
在提示时使用您的 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）： 通过 UI 配置 — 无需编辑 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	简单的 UI 流程
令牌管理	手动轮换	自动刷新
安全性	令牌存储在配置文件中	令牌由客户端管理
多设备	每台设备单独配置	跨设备同步

可用工具

连接后，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	完整的验证详情，包括可接通性、DNC 状态、运营商、TCPA 诉讼人状态
check_dnc_status	仅检查“请勿来电”状态
check_tcpa_status	仅检查 TCPA 诉讼人状态

地址处理

工具	描述
verify_address	将地址格式化为符合 USPS 标准
geocode_address	从地址获取坐标
reverse_geocode_address	从纬度/经度坐标获取地址

故障排除

OAuth 问题

问题	解决方案
浏览器未打开登录页面	确保允许弹窗。检查您的默认浏览器设置是否正确。
登录页面显示“会话已过期”	移除并重新添加连接器，然后重新认证。
“登录尝试次数过多”错误	等待 15 分钟后再试。
Google 登录不工作	确保允许弹窗，并尝试改用电子邮件/密码登录。
登录后连接失败	检查您的互联网连接。重定向回 MCP 客户端可能失败。尝试移除并重新添加连接器。

ChatGPT 问题

问题	解决方案
无法创建连接器	确保在设置 → 应用与连接器 → 高级设置中启用了开发者模式。
缺少开发者模式开关	对于企业/商业版，您的工作区管理员必须首先在工作区设置中启用它。
认证失败	确保允许 http://chatgpt.com 的弹窗。尝试断开并重新连接连接器。
工具未被使用	在提示中明确说明：“使用 BatchData 连接器来...”。在提示前通过 + 按钮添加连接器。
连接器无响应	前往设置 → 连接器 → BatchData → 刷新以更新元数据。服务器可能暂时不可用。
调用了错误的工具	指定：“不要使用内置浏览或其他工具；仅使用 BatchData 连接器。”

API 令牌问题

问题	解决方案
401 未授权	验证您的 API 令牌是否正确且未过期。
403 禁止访问	确保您的令牌在 BatchData Web 应用中具有所需的端点权限。
Node.js 路径错误	通过运行 which npx (macOS/Linux) 或检查安装路径 (Windows) 来验证 npx 的路径是否存在。
配置未加载	保存配置文件后重启您的 MCP 客户端。

一般问题

问题	解决方案
工具未出现	验证 MCP 服务器在客户端的扩展列表中是否已启用。
SkipTracing 返回 403	必须由管理员为您的团队启用 SkipTracing v3，并且您的令牌需要该权限。
响应缓慢	检查您的互联网连接。服务器将请求代理到 BatchData API。

获取帮助

API 令牌问题：登录 BatchData Web 应用以管理您的服务器端令牌
权限问题：联系您的 BatchData 团队管理员
技术问题：联系 BatchData 支持团队