Bỏ qua tới nội dung

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 đề:

  1. Đị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.
  2. 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.
  3. 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 databaseToken MCP của DataxLand
Agent thấy gìMọi bảng, mọi cộtChỉ số, chiều, bộ lọc đã duyệt
Định nghĩa sốAgent tự viết mỗi lầnMột định nghĩa có phiên bản
Thông tin cá nhân người muaĐọc đượcKhông trả
Thu hồiĐổi mật khẩu dùng chungBấm Thu hồi, có hiệu lực ngay
Nhật kýTùy cấu hình databaseMỗ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.

  1. Trong workspace, vào Cài đặt → Tích hợp, mục Token MCP.
  2. Ở thẻ Tạo token, điền Nhãn để sau này nhận ra, ví dụ "Claude Code – máy của Minh".
  3. 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).
  4. 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.
  5. 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:

  1. "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ố.
  2. "Lãi sau phí tháng trước theo kênh, so với tháng trước nữa." — agent gọi query_metric hoặc query_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ệcCâ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

Bài liên quan

Dashboard đã kiểm số từ dữ liệu của bạn, ngay chiều nay

Gói Miễn phí không thời hạn · Không cần thẻ thanh toán · Workspace mẫu mở trong vài phút