BatchData MCP (Real Estate & Contact Data)

chính thức

Dữ liệu làm giàu Bất động sản & Liên hệ MCP

Bạn có thể làm gì với Batch Data (real Estate & Contact Data) MCP?

  • Tra cứu chi tiết bất động sản — Lấy thông tin đầy đủ về bất động sản theo địa chỉ, số thửa đất hoặc ID bằng lookup_property.
  • Tìm kiếm bất động sản tương tự — Lấy số lượng, bản xem trước hoặc chi tiết phân trang của các bất động sản tương tự với comparable_property_count, comparable_property_previewcomparable_property_page.
  • Tìm kiếm bất động sản — Khám phá các bất động sản phù hợp với tiêu chí như tình trạng trống hoặc vị trí, với số lượng, bản xem trước và truy cập phân trang qua search_properties_count, search_properties_previewsearch_properties_page.
  • Tra cứu thông tin chủ sở hữu bất động sản — Lấy tên chủ sở hữu và thông tin liên hệ cho một địa chỉ bất động sản hoặc số thửa đất nhất định bằng skip_trace_property.
  • Xác minh và chuẩn hóa địa chỉ — Xác thực địa chỉ theo tiêu chuẩn USPS, mã hóa địa lý địa chỉ thành tọa độ, hoặc giải mã tọa độ ngược lại thành địa chỉ bằng verify_address, geocode_addressreverse_geocode_address.
  • Xác minh số điện thoại — Kiểm tra khả năng liên lạc, nhà mạng, trạng thái DNC và trạng thái kiện tụng TCPA của một số điện thoại bằng verify_phone, check_dnc_status hoặc check_tcpa_status.

Tài liệu

Hướng dẫn thiết lập Máy chủ MCP Từ xa BatchData

Giới thiệu

Hướng dẫn này mô tả cách kết nối với Máy chủ MCP Từ xa BatchData bằng trình khách tương thích MCP của bạn.

Phương thức xác thực

Máy chủ MCP BatchData hỗ trợ hai phương thức xác thực:

Phương thứcĐộ phức tạp thiết lậpBảo mậtKhuyến nghị cho
OAuth (Khuyến nghị)Đơn giảnCaoHầu hết người dùng
Token APICấu hình thủ côngTrung bìnhTrình khách MCP tùy chỉnh, gỡ lỗi

Xác thực OAuth (Khuyến nghị)

OAuth cung cấp trải nghiệm kết nối hợp lý:

  • Không cần cấu hình token API — Chỉ cần cung cấp URL máy chủ
  • Đăng nhập dựa trên trình duyệt — Xác thực bằng thông tin tài khoản BatchData của bạn
  • Quản lý token tự động — Token truy cập tự động làm mới
  • Trải nghiệm đăng nhập quen thuộc — Sử dụng email/mật khẩu hoặc Đăng nhập Google

Xác thực Token API (Thay thế)

Dành cho người dùng thích cấu hình token API trực tiếp hoặc đang sử dụng trình khách MCP tùy chỉnh không hỗ trợ OAuth:

  • Yêu cầu lấy và cấu hình token API BatchData của bạn theo cách thủ công
  • Token phải được quản lý và bảo vệ như một thông tin xác thực nhạy cảm
  • Hữu ích cho việc gỡ lỗi, tập lệnh tự động hóa hoặc trình khách không hỗ trợ OAuth

Cải tiến tương lai: Kiểm soát truy cập OAuth (Sắp ra mắt)

Chúng tôi đang phát triển các tính năng kiểm soát truy cập nâng cao cho xác thực OAuth:

  • Xác minh quyền — Đăng nhập OAuth sẽ tự động xác minh xem tài khoản của bạn có được cấp quyền sử dụng máy chủ MCP hay không
  • Quản lý truy cập tập trung — Chủ sở hữu nhóm sẽ có thể cấp hoặc thu hồi quyền truy cập máy chủ MCP cho các thành viên trong nhóm thông qua nền tảng BatchData

Thiết lập OAuth (Khuyến nghị)

Điều kiện tiên quyết

  • Tài khoản BatchData với thông tin xác thực hợp lệ
  • Trình khách tương thích MCP (Claude Desktop/Web/Di động, ChatGPT, Cursor, Claude Code hoặc tương tự)

Thiết lập Claude (Máy tính, Web & Di động)

Claude hỗ trợ máy chủ MCP thông qua ứng dụng máy tính, giao diện web và ứng dụng di động.

Lưu ý cho Di động: Không thể thêm trình kết nối từ ứng dụng di động. Thêm trình kết nối trên Máy tính hoặc Web trước, và nó sẽ tự động có sẵn trên di động cho cùng một tài khoản.

Lưu ý cho Nhóm/Doanh nghiệp: Quản trị viên không gian làm việc phải thêm trình kết nối BatchData vào danh sách trình kết nối có sẵn trước khi các thành viên trong nhóm có thể cấu hình nó. Liên hệ với quản trị viên của bạn nếu bạn không thấy trình kết nối trong danh sách của mình.

Bước 1: Thêm Trình kết nối BatchData

  1. Mở Claude (Máy tính hoặc Web)
  2. Đi tới Cài đặt → Trình kết nối (hoặc Cài đặt → Máy chủ MCP)
  3. Nhấp Thêm Trình kết nối (hoặc Thêm Máy chủ)
  4. Nhập URL máy chủ:
https://mcp.batchdata.com
  1. Nhấp Thêm hoặc Kết nối

Bước 2: Xác thực

  1. Trình duyệt của bạn sẽ mở trang đăng nhập BatchData
  2. Đăng nhập bằng một trong hai cách:
  • Email và mật khẩu — Nhập thông tin tài khoản BatchData của bạn
  • Đăng nhập Google — Nhấp nút Google để xác thực
  1. Sau khi đăng nhập thành công, bạn sẽ được chuyển hướng trở lại Claude

Bước 3: Kích hoạt Trình kết nối

Trình kết nối không được kích hoạt theo mặc định sau khi thêm chúng. Kích hoạt một lần và cài đặt sẽ được lưu:

  1. Mở bất kỳ cuộc trò chuyện nào
  2. Nhấp nút + (hoặc biểu tượng trình kết nối) trong khu vực nhập liệu trò chuyện
  3. Tìm BatchData trong danh sách trình kết nối có sẵn
  4. Bật nó lên để kích hoạt

Trình kết nối bây giờ sẽ có sẵn trong tất cả các cuộc trò chuyện của bạn.

Bước 4: Phê duyệt sử dụng công cụ ban đầu

Lần đầu tiên Claude sử dụng bất kỳ công cụ BatchData nào, bạn sẽ được yêu cầu phê duyệt:

  1. Khi Claude cố gắng sử dụng một công cụ, lời nhắc cấp quyền sẽ xuất hiện
  2. Xem xét công cụ và hành động được yêu cầu
  3. Nhấp Cho phép để phê duyệt
  4. Chọn "Luôn cho phép" nếu bạn muốn bỏ qua phê duyệt cho các lần sử dụng công cụ đó trong tương lai

Lưu ý: Sau khi phê duyệt ban đầu (hoặc chọn "Luôn cho phép"), các lần sử dụng công cụ tiếp theo sẽ không yêu cầu xác nhận thêm.

Sử dụng trên Di động

Sau khi bạn đã thêm và xác thực trình kết nối trên Máy tính hoặc Web:

  • Mở ứng dụng di động Claude với cùng một tài khoản
  • Trình kết nối BatchData sẽ có sẵn trong danh sách trình kết nối của bạn
  • Nếu chưa được kích hoạt, hãy bật nó lên qua nút + trong khu vực nhập liệu trò chuyện (cài đặt đồng bộ trên các thiết bị)
  • Các phê duyệt công cụ được cấp trên Máy tính/Web sẽ được áp dụng trên di động
  • Tất cả các công cụ hoạt động giống như trên Máy tính/Web

Các kết nối tiếp theo

Sau khi xác thực ban đầu:

  • Token truy cập được lưu vào bộ nhớ đệm và tự động làm mới trên tất cả các thiết bị
  • Bạn sẽ không cần đăng nhập lại trừ khi phiên của bạn hết hạn (thường là sau 14 ngày không hoạt động)
  • Nếu được nhắc xác thực lại, chỉ cần đăng nhập lại thông qua trình duyệt của bạn (trên Máy tính hoặc Web)

Thiết lập Cursor

  1. Mở Cài đặt Cursor
  2. Điều hướng đến phần cấu hình MCP
  3. Nhấp Thêm Máy chủ MCP
  4. Nhập URL máy chủ:
https://mcp.batchdata.com
  1. Ở lần sử dụng đầu tiên, xác thực qua cửa sổ bật lên của trình duyệt

Thiết lập Claude Code

Thêm máy chủ MCP BatchData trực tiếp qua CLI:

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

Ở lần sử dụng đầu tiên, bạn sẽ được nhắc xác thực qua trình duyệt của mình.

Thiết lập ChatGPT (Chế độ Nhà phát triển)

ChatGPT hỗ trợ máy chủ MCP thông qua Chế độ Nhà phát triển, cung cấp hỗ trợ đầy đủ cho Giao thức Ngữ cảnh Mô hình.

Điều kiện tiên quyết

  • Đăng ký ChatGPT Plus hoặc Pro
  • Đối với Doanh nghiệp/Tổ chức: Quản trị viên phải kích hoạt chế độ nhà phát triển trong Cài đặt Không gian làm việc

Bước 1: Kích hoạt Chế độ Nhà phát triển

  1. Mở ChatGPT
  2. Đi tới Cài đặt → Ứng dụng & Trình kết nối → Cài đặt nâng cao
  3. Bật Chế độ Nhà phát triển lên

Đối với không gian làm việc Doanh nghiệp/Tổ chức:

  • Quản trị viên trước tiên phải kích hoạt chế độ nhà phát triển từ Cài đặt Không gian làm việc → Quyền & Vai trò → Dữ liệu được kết nối → Chế độ Nhà phát triển / Tạo trình kết nối MCP tùy chỉnh

Bước 2: Tạo Trình kết nối BatchData

  1. Trong ChatGPT, đi tới Cài đặt → Trình kết nối
  2. Nhấp Tạo
  3. Nhập các chi tiết sau:
  • Tên trình kết nối: BatchData
  • URL Máy chủ MCP: https://mcp.batchdata.com
  1. Nhấp Tạo

Bước 3: Xác thực

  1. Sau khi tạo trình kết nối, ChatGPT sẽ nhắc bạn xác thực
  2. Trình duyệt của bạn sẽ mở trang đăng nhập BatchData
  3. Đăng nhập bằng một trong hai cách:
  • Email và mật khẩu — Nhập thông tin tài khoản BatchData của bạn
  • Đăng nhập Google — Nhấp nút Google để xác thực
  1. Sau khi đăng nhập thành công, bạn sẽ được chuyển hướng trở lại ChatGPT
  2. Trình kết nối BatchData hiện đã sẵn sàng để sử dụng

Sử dụng công cụ BatchData trong ChatGPT

Sau khi kết nối, bạn có thể sử dụng các công cụ BatchData trong các cuộc trò chuyện:

  1. Bắt đầu một cuộc trò chuyện mới
  2. Nhấp nút +, sau đó chọn trình kết nối của bạn từ menu Thêm
  3. Ngoài ra, chọn Chế độ Nhà phát triển từ Menu Plus và chọn BatchData
  4. Đặt câu hỏi liên quan đến bất động sản — ChatGPT sẽ sử dụng các công cụ thích hợp

Ví dụ lời nhắc:

  • "Tra cứu bất động sản tại 123 Main Street, Los Angeles, CA"
  • "Tìm bất động sản so sánh cho 456 Oak Avenue"
  • "Skip trace chủ sở hữu của 789 Pine Road, Miami, FL"

Quản lý kết nối

  • Để ngắt kết nối: Đi tới Cài đặt → Trình kết nối, nhấp BatchData và ngắt kết nối
  • Để kết nối lại: Nhấp vào trình kết nối và xác thực lại
  • Hết hạn phiên: Nếu phiên của bạn hết hạn (thường sau 14 ngày), bạn sẽ được nhắc kết nối lại

Xác minh

Sau khi kết nối, chỉ cần hỏi về dữ liệu bất động sản hoặc skip-tracing và LLM sẽ tự động sử dụng các công cụ BatchData.

Ví dụ lời nhắc:

  • "Tra cứu bất động sản tại 123 Main Street, Los Angeles, CA"
  • "Skip trace chủ sở hữu của 456 Oak Avenue, Miami, FL"
  • "Tìm bất động sản so sánh cho 789 Pine Road, Austin, TX"
  • "Tìm kiếm bất động sản trống ở Miami, FL"
  • "Xác minh số điện thoại này: 555-123-4567"
  • "Xác minh và chuẩn hóa địa chỉ này: 100 main st los angeles ca"
  • "Lấy tọa độ cho 200 Park Avenue, New York, NY"

Claude hoặc ChatGPT sẽ nhận ra ý định và sử dụng các công cụ BatchData thích hợp để lấy thông tin.


Thiết lập Token API (Thay thế)

Sử dụng phương pháp này nếu:

  • Trình khách MCP của bạn không hỗ trợ OAuth
  • Bạn cần gỡ lỗi hoặc tự động hóa các kết nối máy chủ MCP
  • Bạn thích quản lý token rõ ràng

Điều kiện tiên quyết

  • Token API BatchData của bạn (lấy từ Ứng dụng Web BatchData)
  • Trình khách tương thích MCP
  • Node.js 22+ (cho Claude Desktop)

Thiết lập Claude Desktop với Token API

Bước 1: Cài đặt Node.js 22

Node.js đi kèm của Claude Desktop đã lỗi thời. Cài đặt Node.js 22 riêng biệt:

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:

Tải xuống và cài đặt Node.js 22.x LTS từ nodejs.org

Bước 2: Cấu hình Claude Desktop

  1. Mở Claude Desktop
  2. Đi tới Cài đặt > Nhà phát triển > Chỉnh sửa Cấu hình
  3. Thêm cấu hình sau:

Cấu hình 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" } } } }

Cấu hình 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" } } } }

Cấu hình 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" } } } }
  1. Thay thế YOUR_USERNAME bằng tên người dùng thực tế của bạn
  2. Thay thế YOUR_API_TOKEN_HERE bằng Token API BatchData của bạn
  3. Lưu tệp và khởi động lại Claude Desktop

Thiết lập Trình khách MCP tùy chỉnh

Đối với các triển khai trình khách MCP tùy chỉnh:

Chi tiết kết nối:

Cài đặtGiá trị
URL Máy chủhttps://mcp.batchdata.com
Truyền tảiHTTP có thể truyền phát
Xác thựcToken Bearer qua tiêu đề Authorization

Ví dụ cấu hình:

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

Sử dụng npx:

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

Chuyển từ Token API sang OAuth

Nếu trước đây bạn đã thiết lập BatchData bằng phương pháp token API và muốn chuyển sang OAuth để có trải nghiệm đơn giản hơn, hãy làm theo các bước sau:

Claude Desktop

  1. Mở Claude Desktop
  2. Đi tới Cài đặt → Nhà phát triển → Chỉnh sửa Cấu hình
  3. Xóa cấu hình BatchData hiện có (toàn bộ khối với command, argsenv)
  4. Lưu và đóng tệp cấu hình
  5. Làm theo hướng dẫn Thiết lập Claude (Máy tính, Web & Di động) để thêm trình kết nối qua giao diện người dùng
  6. Xác thực bằng tài khoản BatchData của bạn khi được nhắc

Trước (Token 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" } } } }

Sau (OAuth): Được cấu hình qua giao diện người dùng — không cần chỉnh sửa JSON.

Claude Code

  1. Xóa cấu hình hiện có:
claude mcp remove BatchData
  1. Thêm lại bằng OAuth:
claude mcp add BatchData --url https://mcp.batchdata.com
  1. Xác thực qua trình duyệt của bạn khi được nhắc

ChatGPT

Nếu bạn đang sử dụng một giải pháp thay thế với token API, chỉ cần:

  1. Xóa bất kỳ trình kết nối BatchData hiện có khỏi Cài đặt → Trình kết nối
  2. Làm theo hướng dẫn Thiết lập ChatGPT để tạo một trình kết nối mới
  3. Xác thực bằng tài khoản BatchData của bạn

Lợi ích của việc chuyển đổi

Khía cạnhToken APIOAuth
Thiết lậpChỉnh sửa JSON thủ côngLuồng giao diện người dùng đơn giản
Quản lý tokenXoay vòng thủ côngTự động làm mới
Bảo mậtToken được lưu trong tệp cấu hìnhToken được quản lý bởi trình khách
Đa thiết bịCấu hình từng thiết bịĐồng bộ trên các thiết bị

Công cụ có sẵn

Sau khi kết nối, Máy chủ MCP BatchData cung cấp các công cụ sau:

Tra cứu & Chi tiết Bất động sản

Công cụMô tả
lookup_propertyLấy thông tin chi tiết bất động sản theo ID, địa chỉ hoặc số thửa đất

Phân tích Bất động sản So sánh

Công cụMô tả
comparable_property_countLấy số lượng và số liệu tổng hợp của các bất động sản so sánh
comparable_property_previewXem trước nhanh 10 bất động sản so sánh đầu tiên với các trường tóm tắt
comparable_property_pageTruy cập phân trang đến chi tiết đầy đủ của bất động sản so sánh (hỗ trợ cả phân trang dựa trên offset và con trỏ)
comparable_property⚠️ Không dùng nữa — Trả về tất cả các bất động sản so sánh cùng một lúc

Tìm kiếm Bất động sản

Công cụMô tả
search_properties_countLấy số lượng bất động sản phù hợp với tiêu chí tìm kiếm với phân tích danh sách nhanh
search_properties_previewXem trước nhanh 10 bất động sản phù hợp đầu tiên
search_properties_pageTìm kiếm bất động sản phân trang với chi tiết đầy đủ (hỗ trợ phân trang dựa trên offset và con trỏ)

Thông tin Liên hệ

Công cụMô tả
skip_trace_propertyLấy thông tin chủ sở hữu và liên hệ cho một bất động sản theo địa chỉ hoặc số thửa đất

Xác minh Điện thoại

Công cụMô tả
verify_phoneChi tiết xác minh đầy đủ bao gồm khả năng liên lạc, trạng thái DNC, nhà mạng, trạng thái người kiện TCPA
check_dnc_statusChỉ kiểm tra trạng thái Không Gọi
check_tcpa_statusChỉ kiểm tra trạng thái người kiện TCPA

Xử lý Địa chỉ

Công cụMô tả
verify_addressĐịnh dạng địa chỉ tuân thủ USPS
geocode_addressLấy tọa độ từ một địa chỉ
reverse_geocode_addressLấy địa chỉ từ tọa độ vĩ độ/kinh độ

Khắc phục sự cố

Sự cố OAuth

Sự cốGiải pháp
Trình duyệt không mở để đăng nhậpĐảm bảo cửa sổ bật lên được cho phép. Kiểm tra xem trình duyệt mặc định của bạn đã được đặt đúng chưa.
Trang đăng nhập hiển thị "Phiên đã hết hạn"Xóa và thêm lại trình kết nối, sau đó xác thực lại.
Lỗi "Quá nhiều lần thử đăng nhập"Đợi 15 phút trước khi thử lại.
Đăng nhập Google không hoạt độngĐảm bảo cửa sổ bật lên được cho phép và thử sử dụng email/mật khẩu thay thế.
Kết nối không thành công sau khi đăng nhậpKiểm tra kết nối internet của bạn. Việc chuyển hướng trở lại trình khách MCP có thể đã thất bại. Thử xóa và thêm lại trình kết nối.

Sự cố ChatGPT

Sự cốGiải pháp
Không thể tạo trình kết nốiĐảm bảo Chế độ Nhà phát triển được kích hoạt trong Cài đặt → Ứng dụng & Trình kết nối → Cài đặt nâng cao.
Thiếu nút bật Chế độ Nhà phát triểnĐối với Doanh nghiệp/Tổ chức, quản trị viên không gian làm việc của bạn phải kích hoạt nó trong Cài đặt Không gian làm việc trước.
Xác thực không thành côngĐảm bảo cửa sổ bật lên được cho phép cho http://chatgpt.com . Thử ngắt kết nối và kết nối lại trình kết nối.
Công cụ không được sử dụngHãy rõ ràng trong lời nhắc của bạn: "Sử dụng trình kết nối BatchData để...". Thêm trình kết nối qua nút + trước khi nhắc.
Trình kết nối không phản hồiĐi tới Cài đặt → Trình kết nối → BatchData → Làm mới để cập nhật siêu dữ liệu. Máy chủ có thể tạm thời không khả dụng.
Gọi sai công cụChỉ định: "Không sử dụng trình duyệt tích hợp hoặc các công cụ khác; chỉ sử dụng trình kết nối BatchData."

Sự cố Token API

Sự cốGiải pháp
401 UnauthorizedXác minh token API của bạn là chính xác và chưa hết hạn.
403 ForbiddenĐảm bảo token của bạn có các quyền endpoint cần thiết trong Ứng dụng Web BatchData.
Lỗi đường dẫn Node.jsXác minh đường dẫn đến npx tồn tại bằng cách chạy which npx (macOS/Linux) hoặc kiểm tra đường dẫn cài đặt (Windows).
Cấu hình không tảiKhởi động lại trình khách MCP của bạn sau khi lưu tệp cấu hình.

Sự cố chung

Sự cốGiải pháp
Công cụ không xuất hiệnXác minh máy chủ MCP được kích hoạt trong danh sách tiện ích mở rộng của trình khách của bạn.
SkipTracing trả về 403SkipTracing v3 phải được kích hoạt cho nhóm của bạn bởi quản trị viên và token của bạn cần có quyền.
Phản hồi chậmKiểm tra kết nối internet của bạn. Máy chủ ủy quyền các yêu cầu đến API BatchData.

Nhận trợ giúp

  • Sự cố Token API: Đăng nhập vào Ứng dụng Web BatchData để quản lý token phía máy chủ của bạn
  • Sự cố quyền: Liên hệ với quản trị viên nhóm BatchData của bạn
  • Sự cố kỹ thuật: Liên hệ với nhóm hỗ trợ BatchData

© BatchData 2025