# 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](https://modelcontextprotocol.io). 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](/vi/docs/ask/sandbox)).

## 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.

1. Vào **Cài đặt → Tích hợp**, mục **Token MCP**.
2. Ở thẻ **Tạo token**, điền **Nhãn** (ví dụ "Claude của Lan").
3. **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).
4. **Workspace**: workspace token được đọc. Gói Doanh nghiệp chọn được nhiều workspace cho một token.
5. **Hết hạn sau (ngày)**: mặc định 90, tối đa 365.
6. 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):

```json
{
  "mcpServers": {
    "dataxland": {
      "url": "https://app.dataxland.com/mcp",
      "headers": { "Authorization": "Bearer <token MCP>" }
    }
  }
}
```

### Claude Code

```bash
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:

```json
{
  "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.

## Liên quan

- [Cài đặt bằng AI agent](/vi/docs/agent-setup)
- [Chỉ số và lớp ngữ nghĩa](/vi/docs/metrics)
- [MCP trên trang tính năng](/vi/platform/mcp)
