Đang Phát Triển (Planned)MCP Protocol

Tích Hợp AI Agent & Giao Thức MCP

Kết nối BOP Data trực tiếp vào Claude, ChatGPT, Cursor IDE và các AI Agent tự hành. Trang này hướng dẫn cách AI truy xuất dữ liệu công dân Việt Nam từ BOP Data ngay hôm nay — và lộ trình triển khai giao thức MCP (Model Context Protocol) trong tương lai.

Để bảo vệ tính toàn vẹn của dữ liệu và tránh gây lỗi cho các agent tự động, BOP Data tuyệt đối không cung cấp cấu hình máy chủ giả mạo. Khi máy chủ MCP chính thức hoàn tất, thông số kết nối sẽ được công bố minh bạch tại trang này.

1. Phương thức Tích hợp AI Agent Hiện tại (Today without MCP)

Các nhà phát triển hệ thống AI, RAG và tác tử tự hành hoàn toàn có thể sử dụng BOP Data ngay hôm nay thông qua 4 lớp cấu trúc sẵn có:

A. Khám phá qua Catalog (/catalog)

Duyệt danh bạ cấu trúc để ánh xạ nhu cầu tra cứu sang canonicalId bất biến và danh mục tương ứng.

B. Hiểu Lược đồ qua Schemas (/schemas)

Đọc đặc tả trường, kiểu dữ liệu và đơn vị để viết parser dữ liệu chính xác và có thể dự đoán được.

C. Trích xuất Data Page HTML

Mỗi trang dữ liệu đều có Schema.org Dataset microdata và cấu trúc thẻ ngữ nghĩa Answer Zone rõ ràng.

D. Đối chiếu Căn cứ Pháp lý (Trust Rail)

Tác tử trích xuất nguồn văn bản gốc, số hiệu, ngày ban hành và giấy phép để cung cấp dẫn chứng đầy đủ cho người dùng.

2. Sơ đồ Luồng Tác tử AI (Agent Architecture Flow)

Quy trình giải quyết truy vấn từ câu hỏi người dùng đến câu trả lời có bảo chứng căn cứ pháp lý:

Tra cứu Danh mục

Dò tìm canonicalId và danh mục tương ứng từ danh bạ dữ liệu.

Xác định Lược đồ

Đọc cấu trúc trường, kiểu dữ liệu và đơn vị đo chuẩn hóa.

Truy xuất Dữ liệu

Trích xuất Answer Zone và bảng dữ liệu có cấu trúc ngữ nghĩa.

Xác thực Bằng chứng

Đối chiếu cơ quan ban hành, số văn bản, ngày hiệu lực và bản quyền.

Sinh Câu trả lời

Trả lời người dùng kèm số liệu chính xác và trích dẫn văn bản gốc.

3. Gói Bằng chứng Xác thực (BOP Evidence Pack)

Cấu trúc thông tin bảo chứng mà một tác tử AI văn minh cần trích xuất và hiển thị khi trả lời số liệu công dân:

Cơ quan thẩm quyền ban hành:🏛 Tổng cục Thuế / Bộ Tài chính

Số hiệu văn bản căn cứ:142/2025/QH15

Ngày ban hành văn bản:2025-06-25

Ngày áp dụng hiệu lực:2026-01-01

Tình trạng pháp lý:● Đang hiệu lực (CURRENT)

Giấy phép phân phối:Open Public Domain

4. Đoạn mã Trích xuất Dữ liệu Mẫu (Integration Snippet)

Cách tác tử có thể truy xuất dữ liệu từ nguồn HTML chuẩn hóa của BOP Data một cách an toàn:

// Ví dụ: Tác tử AI truy xuất số liệu Biểu thuế GTGT qua Schema.org Dataset microdata
async function fetchBopVatData() {
  const res = await fetch('https://data.bop.ink/thue/thue-gtgt/thue-gtgt-viet-nam-2026/');
  const html = await res.text();
  
  // Dữ liệu được bọc trong article[itemscope][itemtype="https://schema.org/Dataset"]
  // Answer Zone chứa trực tiếp bảng thuế suất chuẩn và căn cứ pháp lý
  return {
    source: 'https://data.bop.ink/thue/thue-gtgt/thue-gtgt-viet-nam-2026/',
    canonicalId: 'vn.tax.vat.rates',
    schemaId: 'vn.tax.vat.rates',
    version: '2026.01',
    status: 'current'
  };
}

Hành động Tiếp theo (Next Actions)

Dù máy chủ MCP chưa ra mắt, bạn có thể bắt đầu tích hợp ngay hôm nay bằng cách tra cứu danh bạ dữ liệu và lược đồ:

Mở Danh mục (Catalog) →Đặc tả Lược đồ (Schemas) →Xem Tài liệu API →

Hiện trạng Máy chủ MCP: ĐANG PHÁT TRIỂN (PLANNED)