Claude & Trợ lý AI

Kết nối Claude với dữ liệu BĐS TP.HCM

35 công cụ MCP cho phép Claude Desktop, Cursor và các MCP client khác truy cập trực tiếp tin đăng TP.HCM, bảng giá đất nhà nước, báo cáo độ tin cậy dữ liệu, tín hiệu quy hoạch, kiểm tra rủi ro và chat theo tin đăng.

MCP là gì?

Model Context Protocol (MCP) là tiêu chuẩn mở cho phép trợ lý AI kết nối trực tiếp với nguồn dữ liệu bên ngoài. Với MCP server của bds.chat, Claude có thể tìm kiếm tin đăng, đối chiếu giá rao với bảng giá đất nhà nước NQ 87/2025, kiểm tra tín hiệu quy hoạch và xem chỉ số rủi ro — dựa trên dữ liệu có cấu trúc với nguồn trích dẫn.

Cài đặt

Claude Desktop (binary cục bộ)

1Cài binary bds-mcp từ bds-chat releases.

2Thêm vào cấu hình MCP của Claude Desktop:

{
  "mcpServers": {
    "bds-chat": {
      "command": "bds-mcp",
      "args": ["--api-url", "https://api.bds.chat"],
      "env": {
        "BDS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Server từ xa (HTTP)

Cho Claude Code, Cursor và các MCP client hỗ trợ server từ xa:

{
  "mcpServers": {
    "bds-chat": {
      "url": "https://api.bds.chat/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Công cụ

35 công cụ chia thành 7 nhóm. Công cụ chỉ đọc dùng được ở mọi hạng. Công cụ quản lý cần hạng pro hoặc đối tác.

Tìm kiếm & Khám phá

ToolDescription
search_listingsTìm kiếm tin đăng TP.HCM theo giá, diện tích, quận, tình trạng pháp lý, đường vào và loại hình
get_listing_detailChi tiết tin đăng: giá, diện tích, vị trí, tình trạng pháp lý và hình ảnh
get_trust_reportBáo cáo độ tin cậy dữ liệu: mức đầy đủ, tín hiệu rủi ro và hạng (A–F)
get_spatial_contextBối cảnh không gian: dữ liệu quy hoạch, ranh giới hành chính và đặc điểm lân cận
chat_about_listingHỏi đáp theo tin đăng, dựa trên dữ liệu có cấu trúc và nguồn trích dẫn

Bảng giá đất & Dữ liệu tham chiếu

ToolDescription
get_gov_land_priceBảng giá đất nhà nước theo tên đường (NQ 87/2025, chỉ dùng tham khảo)
get_gov_land_price_wardTổng hợp bảng giá đất nhà nước cấp phường
get_gov_land_price_districtTổng hợp bảng giá đất nhà nước cấp quận
compare_gov_land_priceĐối chiếu giá rao với bảng giá đất nhà nước — tỷ lệ và bối cảnh
check_location_riskTín hiệu rủi ro vị trí: xung đột quy hoạch, lộ giới và cờ dữ liệu
get_zoningDữ liệu quy hoạch từ lớp dữ liệu hiện có
get_zoning_reportBáo cáo quy hoạch chi tiết kèm lớp phủ và lộ giới
check_listing_zoningKiểm tra tín hiệu quy hoạch cho một tin đăng cụ thể
resolve_wardTra cứu tình trạng sáp nhập phường (TP.HCM 312→102 phường, hiệu lực 01/07/2025)
search_reform_knowledgeTìm kiếm kho kiến thức sáp nhập phường
get_legal_refsCăn cứ pháp lý về giá đất, quy hoạch và xây dựng
get_boundariesRanh giới hành chính quận/phường TP.HCM (polygon)
get_boundary_containsXác định tọa độ nằm trong quận/phường nào

Quản lý tin đăng

Cần hạng pro/đối tác
ToolDescription
create_listingTạo tin đăng mới với thông tin bất động sản
update_listingCập nhật tin đăng hiện có
delete_listingXóa tin đăng
update_listing_statusĐổi trạng thái tin đăng (đang rao, đã bán, hết hạn, rút lại)
batch_upsert_listingsTải lên hàng loạt tin đăng (chỉ hạng đối tác)

Giấy tờ

Cần hạng pro/đối tác
ToolDescription
submit_documentGửi giấy tờ pháp lý cho tin đăng
get_listing_documentsXem giấy tờ của tin đăng
upload_document_imageTải ảnh giấy tờ (bản scan sổ hồng, giấy phép)

Xác thực & Hồ sơ

ToolDescription
register_api_keyĐăng ký API key
get_profileXem hồ sơ API key, hạng và giới hạn
update_profileCập nhật thông tin hồ sơ
get_usageKiểm tra mức sử dụng API
rotate_keyĐổi API key mới

Nền tảng

ToolDescription
get_platform_statsThống kê nền tảng: tin đăng, quận/huyện, chất lượng dữ liệu
submit_partner_interestĐăng ký làm đối tác nền tảng
get_data_qualityChỉ số chất lượng dữ liệu: mức đầy đủ, độ mới, phân bố hạng tin cậy

Hình ảnh

ToolDescription
upload_imageTải ảnh tin đăng (trả token ảnh mã hóa)

Xác thực

Đăng ký API key qua API hoặc dùng công cụ MCP register_api_key. Thêm key vào cấu hình MCP — server tự xử lý xác thực.

Hạng miễn phí: tìm kiếm và dữ liệu tham chiếu chỉ đọc
Hạng pro: + báo cáo độ tin cậy dữ liệu, chat theo tin đăng, CRUD, giấy tờ
Hạng đối tác: + thao tác hàng loạt, tất cả tính năng

bds.chat là API dữ liệu, không phải sàn môi giới hoặc đơn vị tư vấn pháp lý. Bảng giá đất nhà nước là dữ liệu tham chiếu có trích nguồn, không phải thẩm định giá thị trường. Cần xác minh pháp lý, chủ sở hữu, quy hoạch và giá với bên bán và cơ quan có thẩm quyền.