Giao thức AI AgentsEnglish Version →

Tài liệu Tích hợp MCP Server (Model Context Protocol)

Cho phép các mô hình ngôn ngữ lớn (Claude, ChatGPT, Codex) truy vấn trực tiếp dữ liệu đăng ký doanh nghiệp Việt Nam có kiểm chứng thông qua cơ chế function calling chuẩn hoá.

1. Thông số Kỹ thuật & Endpoint

MCP Endpoint (Streamable HTTP):https://mcp.masothue.pro/mcp

Giao thức:JSON-RPC 2.0 (Spec 2026-07-28, Stateless)

2. Bảng Danh mục Công cụ (Tools Catalog & Pricing)

Tên Tool	Chức năng	Scope yêu cầu	Chi phí (Credits)
explain_data	Giải thích phạm vi dataset, snapshot date, mã trạng thái	Không yêu cầu	0 (Miễn phí)
find_company	Tìm kiếm theo tên / từ khoá (tối đa 10 ứng viên, gắn cờ truncated)	company:search	1 credit
get_company	Lấy toàn bộ hồ sơ chi tiết theo mã số thuế	company:read	1 credit (cache) / 2 (fresh)
search_companies	Lọc nâng cao theo tỉnh thành, năm thành lập, loại hình kèm cursor	company:search	1 credit
aggregate_companies	Thống kê số lượng phân bố từ khối dữ liệu tính sẵn (Cube)	analytics:read	2 credits
get_company_changes	Lịch sử thay đổi pháp lý quan trọng (tên, địa chỉ, trạng thái)	changes:read	1 credit

3. Hướng dẫn Cấu hình Client (Playbooks)

A. Claude Code CLI

Thêm server vào Claude Code CLI chỉ với một dòng lệnh duy nhất:

claude mcp add masothue-pro --transport http https://mcp.masothue.pro/mcp --header "Authorization: Bearer msp_live_YOUR_API_KEY"

B. OpenAI Codex CLI (~/.codex/config.toml)

Thêm đoạn cấu hình sau vào tệp ~/.codex/config.toml:

[mcp_servers.masothue_pro]
url = "https://mcp.masothue.pro/mcp"
bearer_token_env_var = "MASOTHUE_API_KEY"

C. Claude.ai Web Connectors (OAuth 2.1)

Trên giao diện claude.ai, mở mục Settings → Connectors → Add Custom Connector:

Connector URL: https://mcp.masothue.pro/mcp
Auth Type: OAuth 2.1 (Hệ thống tự động phát hiện metadata qua /.well-known/oauth-protected-resource)
Audience: https://mcp.masothue.pro
Đăng nhập Clerk bằng đúng email đã xác minh trên tài khoản masothue.pro; lần kết nối đầu sẽ cố định danh tính OAuth vào tài khoản đó.