BatchData远程MCP服务器设置指南
- 2.1 [OAuth身份验证（推荐）]() - 2.2 [API令牌身份验证（可选）]()
- 3 [未来增强：OAuth访问控制（即将推出）]()
- 4 [OAuth设置（推荐）]()
- 4.1 先决条件 - 4.2 [Claude设置（桌面、网络和移动）]() - 4.2.1 步骤1：添加BatchData连接器 - 4.2.2 第二步：身份验证 - 4.2.3 步骤3：启用连接器 - 4.2.4 步骤4：批准初始工具使用 - 4.2.5 在移动设备上使用 - 4.2.6 后续连接 - 4.3 光标设置 - 4.4 Claude代码设置 - 4.5 [ChatGPT设置（开发人员模式）]() - 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令牌设置（可选）]()
- 5.1 先决条件 - 5.2 Claude桌面设置API令牌 - 5.2.1 - 5.2.2 步骤2：配置Claude桌面 - 5.3 自定义MCP客户端设置
- 6.1 克劳德桌面版 - 6.2 克劳德代码 - 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 Remote MCP服务器。
身份验证方法
BatchData MCP服务器支持两种身份验证方法：
|方法|设置复杂性|安全性|建议用于| | :-- | :-- | :-- | :-- | |OAuth（推荐）|简单|高|大多数用户| |API令牌|手动配置|中等|自定义MCP客户端，调试|
OAuth身份验证（推荐）
OAuth提供了一种简化的连接体验：
- 不需要API令牌配置 --只需提供服务器URL
- 基于浏览器的登录 --使用您的BatchData帐户凭据进行身份验证
- 自动令牌管理 --访问令牌自动刷新
- 熟悉的登录体验 --使用电子邮件/密码或谷歌登录
API令牌身份验证（可选）
对于喜欢直接API令牌配置或使用不支持OAuth的自定义MCP客户端的用户：
- 需要手动获取和配置BatchData API令牌
- 令牌必须作为敏感凭据进行管理和保护
- 适用于调试、自动化脚本或不支持OAuth的客户端
未来增强：OAuth访问控制（即将推出）
我们正在为OAuth身份验证开发增强的访问控制功能：
- 权限验证 --OAuth登录将自动验证您的帐户是否已被授予使用MCP服务器的权限
- 集中访问管理 --团队所有者将能够通过BatchData平台为团队成员授予或撤销MCP服务器访问权限
______________________________________________________________________
OAuth设置（推荐）
先决条件
- 具有有效凭据的BatchData帐户
- MCP兼容客户端（克劳德桌面/网络/移动、ChatGPT、游标、克劳德代码或类似客户端）
Claude设置（桌面、网络和移动）
Claude通过桌面应用程序、web界面和移动应用程序支持MCP服务器。
手机备忘：无法从移动应用程序添加连接器。首先在桌面或Web上添加连接器，它将自动在同一帐户的移动设备上可用。
团队/企业注释：工作区管理员必须首先将BatchData连接器添加到可用连接器列表中，然后团队成员才能对其进行配置。如果您在列表中没有看到该连接器，请与管理员联系。
步骤1：添加BatchData连接器
- 打开克劳德（桌面或网络）
- 首选 设置→ 连接器 （或 设置→ MCP服务器)
- 点击 添加连接器 （或 添加服务器)
- 输入服务器URL:
https://mcp.batchdata.com- 点击 添加 或 连接
第二步：身份验证
- 您的浏览器将打开BatchData登录页面
- 使用以下任一方式登录：
- 电子邮件和密码 --输入您的BatchData帐户凭据
- 谷歌登录 --点击谷歌按钮进行身份验证
- 成功登录后，您将被重定向回Claude
步骤3：启用连接器
连接器是 默认情况下未启用 在添加它们之后。启用一次即可保存设置：
- 打开任何聊天
- 点击 + 聊天输入区域中的按钮（或连接器图标）
- 找到 批次数据 在可用连接器列表中
- 快捷开关 上 启用它
现在，连接器将在您的所有对话中可用。
步骤4：批准初始工具使用
Claude第一次使用任何BatchData工具时，都会要求您批准：
- 当Claude尝试使用工具时，将出现权限提示
- 审查所请求的工具和行动
- 点击 允许 批准
- 选择 “始终允许” 如果你想跳过对该工具未来使用的审批
备注：在初始批准（或选择“始终允许”）后，后续工具使用不需要额外确认。
在移动设备上使用
在桌面或Web上添加并验证连接器后：
- 使用同一帐户打开Claude移动应用程序
- BatchData连接器将在连接器列表中可用
- 如果尚未启用，请通过 + 聊天输入中的按钮（设置跨设备同步）
- 桌面/网络上授予的工具批准转移到移动设备
- 所有工具的工作原理与桌面/Web上的相同
后续连接
初始身份验证后：
- 访问令牌在所有设备上自动缓存和刷新
- 除非您的会话到期（通常在14天不活动后），否则您不需要再次登录
- 如果系统提示重新验证，只需通过浏览器（在桌面或Web上）重新登录即可
光标设置
- 打开光标设置
- 导航到MCP配置部分
- 点击 添加MCP服务器
- 输入服务器URL:
https://mcp.batchdata.com- 首次使用时，通过浏览器弹出窗口进行身份验证
Claude代码设置
直接通过CLI添加BatchData MCP服务器：
claude mcp add BatchData --url https://mcp.batchdata.com首次使用时，系统会提示您通过浏览器进行身份验证。
ChatGPT设置（开发人员模式）
ChatGPT通过以下方式支持MCP服务器 开发者模式，它提供了完整的 模型上下文协议 客户支持。
先决条件
- ChatGPT Plus或Pro订阅
- 对于企业/企业：管理员必须在“工作区设置”中启用开发人员模式
步骤1：启用开发人员模式
- 打开 ChatGPT
- 首选 设置→ 应用程序和连接器→ 高级设置
- 切换 开发者模式 to on
对于企业/企业工作区：
- 管理员必须首先从启用开发人员模式 工作区设置→ 权限和角色→ 连接数据→ 开发人员模式/创建自定义MCP连接器
步骤2：创建BatchData连接器
- 在ChatGPT中，转到 设置→ 连接器
- 点击 创建
- 输入以下详细信息：
- 连接器名称:
BatchData - MCP服务器URL:
https://mcp.batchdata.com
- 点击 创建
步骤3：身份验证
- 创建连接器后，ChatGPT将提示您进行身份验证
- 您的浏览器将打开BatchData登录页面
- 使用以下任一方式登录：
- 电子邮件和密码 --输入您的BatchData帐户凭据
- 谷歌登录 --点击谷歌按钮进行身份验证
- 成功登录后，您将被重定向回ChatGPT
- BatchData连接器现在可以使用了
在ChatGPT中使用BatchData工具
连接后，您可以在对话中使用BatchData工具：
- 开始新的聊天
- 点击 + 按钮，然后从中选择连接器 更多 菜单
- 或者，选择 开发者模式 从 Plus菜单 并选择BatchData
- 询问与酒店相关的问题——ChatGPT将使用适当的工具
示例提示：
- “查找位于加利福尼亚州洛杉矶主街123号的房产”
- “查找橡树大道456号的类似房产”
- “跳过追踪佛罗里达州迈阿密松树路789号的业主”
管理连接
- 断开连接首选 设置→ 连接器，单击BatchData，然后断开连接
- 重新连接：单击连接器并重新进行身份验证
- 会话到期：如果您的会话到期（通常在14天后），系统将提示您重新连接
验证
连接后，只需询问属性数据或跳过跟踪，LLM将自动使用BatchData工具。
示例提示：
- “查找位于加利福尼亚州洛杉矶主街123号的房产”
- “跳过追踪佛罗里达州迈阿密橡树大道456号的所有者”
- “查找德克萨斯州奥斯汀松树路789号的类似房产”
- “搜索佛罗里达州迈阿密的空置房产”
- “验证此电话号码：555-123-4567”
- “验证并标准化此地址：加利福尼亚州洛杉矶大街100号”
- 获取纽约州纽约市公园大道200号的坐标
Claude或ChatGPT将识别意图，并使用适当的BatchData工具获取信息。
______________________________________________________________________
API令牌设置（可选）
在以下情况下使用此方法：
- 您的MCP客户端不支持OAuth
- 您需要调试或自动化MCP服务器连接
- 您更喜欢显式令牌管理
先决条件
- 您的BatchData API令牌（从BatchData Web App获取）
- MCP兼容客户端
- Node.js 22+（适用于克劳德桌面）
Claude桌面设置API令牌
第一步：安装Node.js 22
Claude Desktop捆绑的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窗户：
从以下网址下载并安装Node.js 22.x LTS
步骤2：配置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 Desktop
自定义MCP客户端设置
对于自定义MCP客户端实现：
连接详细信息：
|设置|值| | :-- | :-- | |服务器URL|https://mcp.batchdata.com | |传输|流式HTTP| |身份验证|通过授权标头进行承载令牌|
配置示例：
{ "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以获得更简单的体验，请执行以下步骤：
克劳德桌面版
- 打开克劳德桌面
- 首选 设置→ 开发者→ 编辑配置
- 删除现有的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 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、地址或包裹号获取详细的房产信息|
可比性分析
|工具|说明| | :-- | :-- | |compatible_property_count |获取可比属性的计数和聚合指标| |compatible_property_preview |快速预览前10个具有摘要字段的可比数据| |compatible_property_page |分页访问完整的可比属性详细信息（支持偏移和基于光标的分页）| |可比性|⚠️ 弃用--一次返回所有可比数据|
房产搜索
|工具|说明| | :-- | :-- | |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合规性格式化地址| |geoce_address |从地址获取坐标| |reverse_geocode_address |从纬度/经度坐标获取地址|
______________________________________________________________________
故障排除
OAuth问题
|问题|解决方案| | :-- | :-- | |浏览器无法打开登录|请确保允许弹出窗口。检查默认浏览器是否设置正确。 | |登录页面显示“会话已过期”|删除并重新添加连接器，然后再次进行身份验证。 | |“登录尝试次数过多”错误|请等待15分钟后重试。 | |谷歌登录不起作用|请确保允许弹出窗口，并尝试使用电子邮件/密码。 | |登录后连接失败|请检查您的互联网连接。重定向回MCP客户端可能失败。尝试卸下并重新添加连接器。 |
ChatGPT问题
|问题|解决方案| | :-- | :-- | |无法创建连接器|确保在“设置”中启用了开发人员模式→ 应用程序和连接器→ 高级设置。 | |缺少开发人员模式切换|对于企业/企业，您的工作区管理员必须首先在工作区设置中启用它。 | |身份验证失败|确保允许弹出窗口http://chatgpt.com .尝试断开和重新连接连接器。 | |未使用的工具|在提示中明确：“使用BatchData连接器…”。在提示之前，通过+按钮添加连接器。 | |连接器没有响应|转到“设置”→ 连接器→ 批次数据→ 刷新以更新元数据。服务器可能暂时不可用。 | |调用错误的工具|指定：“不要使用内置浏览或其他工具；只使用BatchData连接器。”|
API令牌问题
|问题|解决方案| | :-- | :-- | |401未经授权|验证您的API令牌是否正确且尚未过期。 | |403 Forbidden |确保您的令牌在BatchData Web App中具有所需的端点权限。 | |Node.js路径错误|通过运行哪个npx（macOS/Linux）或检查安装路径（Windows）来验证npx的路径是否存在。 | |配置未加载|保存配置文件后重新启动MCP客户端。 |
一般问题
|问题|解决方案| | :-- | :-- | |工具未出现|验证客户端的扩展列表中是否启用了MCP服务器。 | |SkipRacing返回403 |管理员必须为您的团队启用SkipRacing v3，并且您的令牌需要获得许可。 | |响应缓慢|请检查您的互联网连接。服务器将请求代理到BatchData API。 |
获取帮助
- API代币问题：登录BatchData Web App以管理服务器端令牌
- 权限问题：请与BatchData团队管理员联系
- 技术问题：联系BatchData支持团队
______________________________________________________________________
©BatchData 2025