Máy chủ MCP
Nối Claude Desktop, Claude Code, Cursor hoặc AI agent của bạn với chỉ số đã duyệt của workspace qua Model Context Protocol — token, quyền, cấu hình client và công cụ.
DataxLand có máy chủ Model Context Protocol. Agent bên ngoài dùng cùng bộ công cụ với Si: đọc chỉ số, chiều, bộ lọc, kỳ và so sánh qua lớp ngữ nghĩa. Mặc định không có công cụ chạy SQL tự do; token được cấp thêm quyền explore:run có sandbox khám phá (kết quả luôn Chưa xác nhận, xem Si viết và chạy SQL/Python).
1. Tạo token
MCP cần gói Doanh nghiệp nhỏ trở lên và vai trò Quản trị trở lên.
- Vào Cài đặt → Tích hợp, mục Token MCP.
- Ở thẻ Tạo token, điền Nhãn (ví dụ "Claude của Lan").
- Quyền: chọn metrics:read – đọc chỉ số cho hỏi đáp; thêm ops:read – xem vận hành nếu agent cần xem tình trạng build (không có giá trị dữ liệu).
- Workspace: workspace token được đọc. Gói Doanh nghiệp chọn được nhiều workspace cho một token.
- Hết hạn sau (ngày): mặc định 90, tối đa 365.
- Bấm Tạo token. Token (bắt đầu bằng
dxp_) chỉ hiện một lần: bấm Sao chép ngay. DataxLand chỉ lưu bản băm.
Danh sách Token đã tạo ghi trạng thái Đang dùng, Hết hạn hoặc Đã thu hồi. Bấm Thu hồi để vô hiệu ngay.
2. Cấu hình client
Máy chủ dùng Streamable HTTP tại đường dẫn /mcp, xác thực bằng header Authorization: Bearer <token>. Địa chỉ dưới đây là của bản chính thức; bản tự triển khai dùng địa chỉ máy chủ MCP của bạn.
Cursor
File ~/.cursor/mcp.json (hoặc .cursor/mcp.json trong dự án, không commit token):
{
"mcpServers": {
"dataxland": {
"url": "https://app.dataxland.com/mcp",
"headers": { "Authorization": "Bearer <token MCP>" }
}
}
}Claude Code
claude mcp add --transport http dataxland https://app.dataxland.com/mcp \
--header "Authorization: Bearer <token MCP>"Claude Desktop
Claude Desktop nối máy chủ MCP từ xa có header qua cầu mcp-remote (cần Node.js). Mở Settings → Developer → Edit Config và thêm:
{
"mcpServers": {
"dataxland": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.dataxland.com/mcp", "--header", "Authorization:${DX_MCP_TOKEN}"],
"env": { "DX_MCP_TOKEN": "Bearer <token MCP>" }
}
}
}Khởi động lại Claude Desktop.
3. Thử
Hỏi agent: "Dùng DataxLand, liệt kê các chỉ số của workspace", rồi "Lãi sau phí tháng trước theo kênh".
Công cụ
| Quyền | Công cụ |
|---|---|
| metrics:read | list_metrics, describe_metric, query_metric, query_semantic, get_semantic_model, explain_change, get_business_model, search_knowledge |
| ops:read | get_health, list_runs, get_run, list_metric_requests |
| explore:run (cấp riêng, mặc định không có) | sandbox_tables, run_sql, run_python — SQL/Python chạy trong sandbox cách ly trên bản sao chỉ đọc không có thông tin cá nhân; biểu đồ trả dạng ảnh; mỗi lần chạy tính 1 câu hỏi cho Si; gói Doanh nghiệp nhỏ trở lên |
Token nhiều workspace (gói Doanh nghiệp) có thêm công cụ list_tenants, và mỗi công cụ nhận tham số tenant để chọn workspace.
An toàn và giới hạn
- Mỗi lời gọi được ghi nhật ký kèm token và công cụ.
- Token nhiều workspace phải chọn workspace trong mỗi lời gọi; máy chủ kiểm tra token có quyền với workspace đó.
- Công cụ vận hành không trả giá trị ô dữ liệu; không công cụ nào trả thông tin cá nhân người mua.
- Tối đa 60 lời gọi mỗi phút mỗi token, 120 mỗi phút mỗi người dùng; vượt thì nhận lỗi giới hạn tốc độ.
- Token là bí mật: không dán vào chat công khai hay commit vào repo.