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、geocode_address 及 reverse_geocode_address，將地址驗證至USPS標準、將地址地理編碼為座標，或將座標反向地理編碼為地址。
驗證電話號碼 — 使用 verify_phone、check_dnc_status 或 check_tcpa_status，檢查電話的可接通性、電信業者、DNC狀態及TCPA訴訟狀態。

文件

BatchData 遠端 MCP 伺服器設定指南

1 簡介
2 驗證方式
- 2.1 OAuth 驗證（建議）
- 2.2 API 權杖驗證（替代方案）
3 未來強化功能：OAuth 存取控制（即將推出）
4 OAuth 設定（建議）
- 4.1 前置需求
- 4.2 Claude 設定（桌面版、網頁版和行動版）
  - 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 設定（開發者模式）
  - 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 使用 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 權杖 — 只需提供伺服器網址
基於瀏覽器的登入 — 使用您的 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 伺服器）
點擊 新增連接器（或 新增伺服器）
輸入伺服器網址：

https://mcp.batchdata.com

點擊新增或連線

步驟 2：驗證

您的瀏覽器將開啟 BatchData 登入頁面
使用以下任一方式登入：

電子郵件和密碼 — 輸入您的 BatchData 帳戶憑證
Google 登入 — 點擊 Google 按鈕進行驗證

成功登入後，您將被重新導向回 Claude

步驟 3：啟用連接器

連接器在新增後預設不會啟用。只需啟用一次，設定就會被儲存：

開啟任何對話
點擊對話輸入區域中的 + 按鈕（或連接器圖示）
在可用連接器清單中找到 BatchData
將其切換為開啟以啟用它

該連接器現在將在您的所有對話中可用。

步驟 4：核准首次工具使用

Claude 首次使用任何 BatchData 工具時，系統會要求您核准：

當 Claude 嘗試使用工具時，會出現權限提示
檢閱所請求的工具和動作
點擊允許以核准
如果您希望日後使用該工具時跳過核准，請選擇 「一律允許」

注意：在首次核准（或選擇「一律允許」）後，後續的工具使用將不需要再次確認。

在行動裝置上使用

在桌面版或網頁版上新增並驗證連接器後：

使用相同帳戶開啟 Claude 行動應用程式
BatchData 連接器將在您的連接器清單中可用
如果尚未啟用，請透過對話輸入區域中的 + 按鈕將其切換為開啟（設定會跨裝置同步）
在桌面版/網頁版上授予的工具核准會延續到行動版
所有工具的使用方式與桌面版/網頁版相同

後續連線

首次驗證後：

存取權杖會在所有裝置上快取並自動更新
除非您的會話過期（通常在 14 天無活動後），否則無需再次登入
如果系統提示重新驗證，只需透過瀏覽器再次登入（在桌面版或網頁版上）

Cursor 設定

開啟 Cursor 設定
導覽至 MCP 設定區段
點擊 新增 MCP 伺服器
輸入伺服器網址：

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 伺服器網址：https://mcp.batchdata.com

點擊建立

步驟 3：驗證

建立連接器後，ChatGPT 會提示您進行驗證
您的瀏覽器將開啟 BatchData 登入頁面
使用以下任一方式登入：

電子郵件和密碼 — 輸入您的 BatchData 帳戶憑證
Google 登入 — 點擊 Google 按鈕進行驗證

成功登入後，您將被重新導向回 ChatGPT
BatchData 連接器現在已可使用

在 ChatGPT 中使用 BatchData 工具

連線後，您可以在對話中使用 BatchData 工具：

開始一個新對話
點擊 + 按鈕，然後從更多選單中選擇您的連接器
或者，從 Plus 選單 中選擇 開發者模式，然後選取 BatchData
詢問與不動產相關的問題 — ChatGPT 將使用適當的工具

提示範例：

"查詢位於加州洛杉磯 Main Street 123 號的不動產"
"尋找 Oak Avenue 456 號的可比較不動產"
"對佛羅里達州邁阿密 Pine Road 789 號的屋主進行跳躍追蹤"

管理連線

中斷連線：前往 設定 → 連接器，點擊 BatchData，然後中斷連線
重新連線：點擊連接器並重新驗證
會話過期：如果您的會話過期（通常在 14 天後），系統會提示您重新連線

驗證

連線後，只需詢問不動產資料或跳躍追蹤，LLM 就會自動使用 BatchData 工具。

提示範例：

"查詢位於加州洛杉磯 Main Street 123 號的不動產"
"對佛羅里達州邁阿密 Oak Avenue 456 號的屋主進行跳躍追蹤"
"尋找德州奧斯汀 Pine Road 789 號的可比較不動產"
"搜尋佛羅里達州邁阿密的空置不動產"
"驗證這個電話號碼：555-123-4567"
"驗證並標準化這個地址：100 main st los angeles ca"
"取得紐約州紐約市 Park Avenue 200 號的座標"

Claude 或 ChatGPT 將識別意圖，並使用適當的 BatchData 工具來擷取資訊。

API 權杖設定（替代方案）

在以下情況使用此方法：

您的 MCP 客戶端不支援 OAuth
您需要除錯或自動化 MCP 伺服器連線
您偏好明確的權杖管理

前置需求

您的 BatchData API 權杖（從 BatchData 網頁應用程式取得）
一個與 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 客戶端實作：

連線詳細資料：

設定	值
伺服器網址	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 Desktop
前往 設定 → 開發人員 → 編輯設定
移除現有的 BatchData 設定（包含 command、args 和 env 的整個區塊）
儲存並關閉設定檔
按照 Claude 設定（桌面版、網頁版與行動版）的說明，透過使用者介面新增連接器
出現提示時，使用您的 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	完整驗證詳細資料，包含可聯繫性、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 網頁應用程式中具有所需的端點權限。
Node.js 路徑錯誤	透過執行 which npx（macOS/Linux）或檢查安裝路徑（Windows）來驗證 npx 的路徑是否存在。
設定未載入	儲存設定檔後重新啟動您的 MCP 客戶端。

一般問題

問題	解決方案
工具未出現	驗證 MCP 伺服器已在您客戶端的擴充功能清單中啟用。
SkipTracing 傳回 403	管理員必須為您的團隊啟用 SkipTracing v3，且您的權杖需要具備該權限。
回應緩慢	檢查您的網際網路連線。伺服器會代理請求至 BatchData API。

取得協助

API 權杖問題：登入 BatchData 網頁應用程式以管理您的伺服器端權杖
權限問題：聯絡您的 BatchData 團隊管理員
技術問題：聯絡 BatchData 支援團隊