Claude Code và Cursor đọc số liệu kinh doanh qua MCP
Nối Claude Code và Cursor với số liệu kinh doanh qua MCP: tạo token chỉ đọc, cấu hình client, giữ token khỏi repo, và câu lệnh mẫu cho việc hằng ngày.
Tác giả Nhóm DataxLand· · 7 phút đọc
Người làm kỹ thuật trong doanh nghiệp nhỏ thường kiêm luôn việc "lấy số": viết script xuất báo cáo, trả lời sếp hỏi doanh thu tuần trước, kiểm tra một tính năng mới có làm giảm đơn không. Nếu bạn đã dùng Claude Code hay Cursor để viết code, câu hỏi tự nhiên là: sao không cho chính agent đó đọc số liệu kinh doanh?
Cách an toàn để làm việc này là MCP (Model Context Protocol), chuẩn mở để AI agent gọi công cụ bên ngoài. Bài này hướng dẫn nối Claude Code và Cursor với chỉ số đã duyệt của DataxLand qua MCP, giải thích vì sao agent chỉ nên đọc chỉ số thay vì cầm mật khẩu database, và đưa ra các câu lệnh mẫu cho việc hằng ngày. Nếu bạn chưa quen MCP, đọc trước bài MCP cho AI agent đọc số liệu kinh doanh.
Vì sao không đưa thẳng chuỗi kết nối database cho agent
Cách nhanh nhất là dán chuỗi kết nối Postgres vào agent và để nó tự viết SQL. Cách này có ba vấn đề:
- Định nghĩa số bị viết lại mỗi lần. Agent không biết "doanh thu" của công ty bạn là GMV hay doanh thu thuần, có trừ tiền hoàn không, đơn chưa thanh toán có tính không. Mỗi câu hỏi là một câu SQL mới, và hai câu hỏi giống nhau có thể ra hai số khác.
- Quyền quá rộng. Một tài khoản database đọc được mọi bảng, kể cả số điện thoại và địa chỉ người mua.
- Khó thu hồi và khó kiểm tra. Mật khẩu database thường dùng chung cho nhiều hệ thống; đổi nó là cả một dự án.
MCP của DataxLand làm ngược lại: agent dùng cùng bộ công cụ với Si — liệt kê chỉ số, mô tả chỉ số, truy vấn chỉ số theo chiều, bộ lọc, kỳ và so sánh. DataxLand dựng truy vấn từ định nghĩa đã duyệt, nên số agent đọc khớp với dashboard. Mặc định không có công cụ chạy SQL tự do, và không công cụ nào trả thông tin cá nhân người mua.
| Chuỗi kết nối database | Token MCP của DataxLand | |
|---|---|---|
| Agent thấy gì | Mọi bảng, mọi cột | Chỉ số, chiều, bộ lọc đã duyệt |
| Định nghĩa số | Agent tự viết mỗi lần | Một định nghĩa có phiên bản |
| Thông tin cá nhân người mua | Đọc được | Không trả |
| Thu hồi | Đổi mật khẩu dùng chung | Bấm Thu hồi, có hiệu lực ngay |
| Nhật ký | Tùy cấu hình database | Mỗi lời gọi ghi kèm token và công cụ |
Bước 1: tạo token chỉ đọc
MCP có từ gói Doanh nghiệp nhỏ trở lên, và người tạo token cần vai trò Quản trị trở lên.
- Trong workspace, vào Cài đặt → Tích hợp, mục Token MCP.
- Ở thẻ Tạo token, điền Nhãn để sau này nhận ra, ví dụ "Claude Code – máy của Minh".
- Quyền: chọn metrics:read – đọc chỉ số. Chỉ thêm ops:read nếu agent cần xem tình trạng build (quyền này không trả giá trị dữ liệu).
- Hết hạn sau (ngày): đặt ngắn cho máy cá nhân, ví dụ 30 ngày. Mặc định 90, tối đa 365.
- Bấm Tạo token rồi Sao chép ngay: token (bắt đầu bằng
dxp_) chỉ hiện một lần. DataxLand chỉ lưu bản băm.
Một token cho một người, một máy. Khi một người rời dự án, thu hồi đúng token của họ mà không ảnh hưởng ai khác.
Bước 2a: cấu hình Claude Code
Claude Code thêm máy chủ MCP từ xa bằng lệnh claude mcp add với kiểu kết nối HTTP và header xác thực, theo
tài liệu MCP của Claude Code (đọc ngày 16/11/2026):
claude mcp add --transport http dataxland https://app.dataxland.com/mcp \
--header "Authorization: Bearer <token MCP>"Điểm cần chú ý là phạm vi lưu cấu hình. Theo cùng tài liệu, Claude Code có ba phạm vi: local (mặc định, chỉ dự án hiện tại,
lưu trong file cấu hình cá nhân ~/.claude.json), project (lưu vào .mcp.json ở gốc dự án để chia sẻ qua git) và user (mọi
dự án của bạn). Với token MCP, đừng dùng phạm vi project: file .mcp.json được commit cùng repo, nghĩa là token đi theo
repo. Dùng phạm vi mặc định hoặc user.
Kiểm tra bằng claude mcp list trong terminal, hoặc gõ /mcp trong phiên Claude Code để xem trạng thái máy chủ.
Bước 2b: cấu hình Cursor
Cursor đọc cấu hình MCP từ ~/.cursor/mcp.json (dùng cho mọi dự án) hoặc .cursor/mcp.json trong dự án, và hỗ trợ máy chủ từ xa
khai báo bằng url và headers (tài liệu MCP của Cursor, đọc ngày 16/11/2026):
{
"mcpServers": {
"dataxland": {
"url": "https://app.dataxland.com/mcp",
"headers": { "Authorization": "Bearer <token MCP>" }
}
}
}Như với Claude Code, đặt token ở file toàn cục trong thư mục cá nhân. Nếu dự án buộc phải có .cursor/mcp.json, thêm file đó vào
.gitignore trước khi dán token.
Bước 3: thử bằng hai câu
Trong phiên làm việc, hỏi agent:
- "Dùng DataxLand, liệt kê các chỉ số của workspace." — agent gọi
list_metrics, bạn thấy tên và mô tả chỉ số. - "Lãi sau phí tháng trước theo kênh, so với tháng trước nữa." — agent gọi
query_metrichoặcquery_semantic, trả số theo kênh.
Nếu câu thứ hai trả số khớp với ô tương ứng trên dashboard, kết nối đã đúng.
Việc hằng ngày agent làm tốt hơn khi đọc được số
| Việc | Câu lệnh mẫu cho agent |
|---|---|
| Kiểm tra tác động của một bản phát hành | "Số đơn website theo ngày 14 ngày qua; ngày 12 có thay đổi gì so với trung bình tuần trước?" |
| Viết script báo cáo nội bộ | "Viết script Python gọi số doanh thu thuần theo tuần, xuất CSV; dùng đúng tên chỉ số trong DataxLand." |
| Trả lời câu hỏi của sếp | "Vì sao lãi sau phí tháng này giảm? Tách theo kênh và sản phẩm." (agent gọi explain_change) |
| Viết tài liệu, đặc tả | "Mô tả chỉ số biên đóng góp đang dùng, phiên bản bao nhiêu." (agent gọi describe_metric) |
| Đối chiếu số khi sửa bug dữ liệu | "Tỷ lệ hoàn TikTok Shop 30 ngày qua là bao nhiêu, định nghĩa thế nào?" |
Một điều cần nhớ: agent đọc số đã công bố, không đọc bảng thô. Nếu câu hỏi cần một phép tính chưa có trong sổ tay chỉ số, cách bền vững là định nghĩa nó thành chỉ số của workspace (xem Chỉ số của workspace), không phải cho agent quyền SQL rộng hơn.
Giữ an toàn khi dùng hằng ngày
- Không dán token vào chat, issue, tài liệu dùng chung hay ảnh chụp màn hình.
- Hạn ngắn, thu hồi khi xong việc. Danh sách Token đã tạo ghi trạng thái Đang dùng, Hết hạn hoặc Đã thu hồi.
- Một token mỗi máy để nhật ký cho biết lời gọi đến từ đâu.
- Giới hạn tốc độ: tối đa 60 lời gọi mỗi phút mỗi token; script vòng lặp nên gom câu hỏi thay vì gọi từng ngày một.
- Token nhiều workspace (gói Doanh nghiệp) buộc agent chọn workspace trong mỗi lời gọi; máy chủ kiểm tra token có quyền với workspace đó.
DataxLand làm việc này thế nào
Máy chủ MCP của DataxLand dùng Streamable HTTP tại /mcp, xác thực bằng header Authorization: Bearer. Agent bên ngoài, Si trong
ứng dụng, Telegram hay Slack đều gọi cùng một bộ công cụ, nên số khớp ở mọi nơi. Cấu hình đầy đủ cho Claude Code, Cursor và Claude
Desktop nằm ở Máy chủ MCP; nếu muốn agent tự đọc tài liệu và tự cấu hình giúp bạn, dùng câu lệnh mẫu ở
Cài đặt bằng AI agent. Tổng quan tính năng ở trang MCP.
Câu hỏi thường gặp
Agent có ghi hay sửa được dữ liệu qua MCP không?
Không. Quyền metrics:read chỉ đọc chỉ số; ops:read chỉ xem tình trạng build mà không có giá trị dữ liệu. Không công cụ nào sửa
dữ liệu kinh doanh, cấu hình hay kho.
Có cần cài gì thêm cho Claude Code hay Cursor không?
Không cần cầu nối: cả hai nối trực tiếp máy chủ MCP từ xa qua HTTP với header. Riêng Claude Desktop dùng cầu mcp-remote (cần
Node.js), hướng dẫn trong trang Máy chủ MCP.
Agent có thấy thông tin khách hàng không?
Không. Thông tin cá nhân người mua bị băm trong kho và không công cụ MCP nào trả nó. Agent thấy số tổng hợp theo chiều như kênh, sản phẩm, ngày.
Lỡ commit token vào repo thì làm gì?
Thu hồi token đó ngay trong Token MCP, tạo token mới với hạn ngắn, rồi xóa token khỏi lịch sử repo theo quy trình của đội bạn. Thu hồi có hiệu lực từ lời gọi kế tiếp.
Đọc tiếp: MCP cho AI agent đọc số liệu kinh doanh · Semantic layer là gì · Si cho dữ liệu Shopee