Databox MCP

Databox MCP

Trò chuyện với dữ liệu của bạn. Mọi lúc, mọi nơi.

Databox MCP là một máy chủ Model Context Protocol kết nối dữ liệu kinh doanh của bạn với các trợ lý AI. Đặt câu hỏi về các chỉ số của bạn bằng ngôn ngữ tự nhiên—không cần SQL, không cần xây dựng bảng điều khiển, không cần xuất dữ liệu.

Tổng quan

Databox MCP cho phép các công cụ AI như Claude, Cursor, n8n và Gemini CLI truy cập và phân tích dữ liệu Databox của bạn một cách hội thoại. Nó thay đổi cách bạn tương tác với các chỉ số kinh doanh—thay vì điều hướng qua các bảng điều khiển, bạn chỉ cần đặt câu hỏi và nhận câu trả lời ngay lập tức.

Lợi ích chính:

• Truy vấn dữ liệu bằng ngôn ngữ tự nhiên
• Hoạt động với hơn 130 tích hợp Databox hiện có
• Không tốn thêm chi phí cho người dùng Databox
• Thiết lập trong vòng chưa đầy 60 giây

Các ứng dụng AI được hỗ trợ

Ứng dụng	Trạng thái
Claude Desktop	Được hỗ trợ
Claude Web	Được hỗ trợ
Cursor	Được hỗ trợ
n8n	Được hỗ trợ
Gemini CLI	Được hỗ trợ
Bất kỳ công cụ tương thích MCP nào	Được hỗ trợ

Thiết lập nhanh

Claude Desktop

Thêm vào claude_desktop_config.json của bạn:

{
  "mcpServers": {
    "databox": {
      "type": "http",
      "url": "https://mcp.databox.com/mcp"
    }
  }
}

Claude Web / Ứng dụng Claude Desktop

1. Đi tới Cài đặt → Trình kết nối
2. Nhấp vào Thêm Trình kết nối Tùy chỉnh
3. Nhập URL máy chủ từ xa: https://mcp.databox.com/mcp
4. Hoàn tất quy trình ủy quyền

Cursor

Thêm máy chủ Databox MCP trong cài đặt MCP của Cursor với URL https://mcp.databox.com/mcp.

n8n

Sử dụng nút HTTP Request trỏ tới https://mcp.databox.com/mcp và xây dựng quy trình làm việc của bạn từ đó.

Các công cụ có sẵn

Databox MCP cung cấp 15 công cụ để tương tác với dữ liệu của bạn:

Quản lý tài khoản

list_accounts

Liệt kê tất cả các tài khoản Databox mà người dùng đã xác thực có thể truy cập.

Không có tham số.

---

Nguồn dữ liệu

list_data_sources

Liệt kê tất cả các nguồn dữ liệu cho một tài khoản cụ thể.

Tham số	Kiểu	Bắt buộc	Mô tả
account_id	string	Có	Mã định danh duy nhất của tài khoản

create_data_source

Tạo một vùng chứa nguồn dữ liệu mới để tổ chức các tập dữ liệu.

Tham số	Kiểu	Bắt buộc	Mô tả
name	string	Có	Tên dễ đọc cho nguồn dữ liệu
account_id	string	Không	ID tài khoản đích. Mặc định là tài khoản được liên kết với khóa API

delete_data_source

Xóa vĩnh viễn một nguồn dữ liệu và tất cả các tập dữ liệu liên quan. Không thể hoàn tác.

Tham số	Kiểu	Bắt buộc	Mô tả
data_source_id	string	Có	Mã định danh duy nhất của nguồn dữ liệu cần xóa

list_data_source_datasets

Liệt kê tất cả các tập dữ liệu thuộc về một nguồn dữ liệu cụ thể.

Tham số	Kiểu	Bắt buộc	Mô tả
data_source_id	string	Có	Mã định danh duy nhất của nguồn dữ liệu

---

Tập dữ liệu

create_dataset

Tạo một tập dữ liệu mới trong một nguồn dữ liệu, với lược đồ tùy chọn.

Tham số	Kiểu	Bắt buộc	Mô tả
data_source_id	string	Có	ID của nguồn dữ liệu cha
name	string	Có	Tên dễ đọc cho tập dữ liệu
columns	string (JSON)	Không	Lược đồ cột dưới dạng mảng JSON. Mỗi cột có name (string) và data_type ("string", "number", hoặc "datetime")
primary_keys	string (JSON)	Không	Mảng JSON chứa tên các cột để sử dụng làm khóa tổng hợp (ví dụ: '["id"]')

ingest_data

Đẩy các bản ghi dữ liệu vào một tập dữ liệu hiện có.

Tham số	Kiểu	Bắt buộc	Mô tả
dataset_id	string	Có	Mã định danh duy nhất của tập dữ liệu đích (UUID)
data	string (JSON)	Có	Mảng JSON chứa các bản ghi, mỗi bản ghi là một đối tượng với tên cột làm khóa

get_dataset_ingestions

Lấy lịch sử nhập dữ liệu cho một tập dữ liệu cụ thể.

Tham số	Kiểu	Bắt buộc	Mô tả
dataset_id	string	Có	Mã định danh duy nhất của tập dữ liệu (UUID)

get_ingestion

Lấy thông tin chi tiết cho một sự kiện nhập dữ liệu cụ thể, bao gồm số lượng bản ghi và các chỉ số của tập dữ liệu.

Tham số	Kiểu	Bắt buộc	Mô tả
dataset_id	string	Có	Mã định danh duy nhất của tập dữ liệu (UUID)
ingestion_id	string	Có	Mã định danh duy nhất của sự kiện nhập dữ liệu (UUID)

delete_dataset

Xóa vĩnh viễn một tập dữ liệu và tất cả dữ liệu của nó. Không thể hoàn tác.

Tham số	Kiểu	Bắt buộc	Mô tả
dataset_id	string	Có	Mã định danh duy nhất của tập dữ liệu cần xóa (UUID)

list_merged_datasets

Liệt kê tất cả các tập dữ liệu đã hợp nhất cho một tài khoản cụ thể. Các tập dữ liệu đã hợp nhất kết hợp dữ liệu từ nhiều nguồn.

Tham số	Kiểu	Bắt buộc	Mô tả
account_id	string	Có	Mã định danh duy nhất của tài khoản

---

Chỉ số

list_metrics

Liệt kê tất cả các chỉ số có sẵn cho một nguồn dữ liệu (Google Analytics, Stripe, v.v.).

Tham số	Kiểu	Bắt buộc	Mô tả
data_source_id	integer	Có	ID nguồn dữ liệu để liệt kê các chỉ số

load_metric_data

Tải dữ liệu cho một chỉ số trong một khoảng thời gian với các chiều tùy chọn và phân chia chuỗi thời gian.

Tham số	Kiểu	Bắt buộc	Mô tả
data_source_id	integer	Có	ID nguồn dữ liệu cho chỉ số
metric_key	string	Có	Khóa chỉ số ngắn (ví dụ: "GoogleAnalytics4@sessions")
start_date	string	Có	Ngày bắt đầu theo định dạng YYYY-MM-DD
end_date	string	Có	Ngày kết thúc theo định dạng YYYY-MM-DD
dimension	string	Không	Khóa chiều để phân tích theo (ví dụ: "source")
granulation_time_unit	integer	Không	Đơn vị thời gian cho chuỗi thời gian: 1=giờ, 2=ngày, 3=tuần, 4=tháng
is_whole_range	boolean	Không	Nếu true (mặc định), trả về một giá trị tổng hợp duy nhất. Tự động đặt thành false khi granulation_time_unit được cung cấp
record_limit	integer	Không	Số lượng bản ghi giá trị chiều tối đa để trả về

---

Phân tích hỗ trợ bởi AI

ask_genie

Truy vấn dữ liệu của bạn bằng ngôn ngữ tự nhiên, được hỗ trợ bởi Genie AI. Genie thực thi các truy vấn thực tế trên dữ liệu của bạn và trả về kết quả đã tính toán, không phải là các xấp xỉ của LLM. Hỗ trợ phân luồng hội thoại cho các câu hỏi tiếp theo.

Tham số	Kiểu	Bắt buộc	Mô tả
dataset_id	string	Có	Mã định danh duy nhất của tập dữ liệu cần phân tích (UUID)
question	string	Có	Câu hỏi bằng ngôn ngữ tự nhiên về dữ liệu
thread_id	string	Không	ID luồng từ phản hồi trước đó để tiếp tục cuộc trò chuyện

---

Tiện ích

get_current_datetime

Lấy ngày và giờ hiện tại. Sử dụng công cụ này để giải quyết các biểu thức ngày tương đối như "tháng trước" hoặc "hôm qua" trước khi gọi các công cụ khác.

Tham số	Kiểu	Bắt buộc	Mô tả
timezone	string	Không	Tên múi giờ (ví dụ: "UTC", "America/New_York"). Mặc định là UTC

Cách thức hoạt động

Databox MCP sử dụng kiến trúc ba lớp để đảm bảo câu trả lời chính xác, đáng tin cậy:

1. Nền tảng Dữ liệu – Các tập dữ liệu có cấu trúc với lược đồ, kiểu dữ liệu và xác thực
2. Công cụ Truy vấn Phân tích – Thực thi các truy vấn thực tế (tổng hợp, nối, lọc)
3. Lớp Ngữ nghĩa – Hiểu các định nghĩa kinh doanh và mối quan hệ giữa các chỉ số

AI không bao giờ trực tiếp chạm vào các phép tính của bạn. Nó xây dựng các truy vấn, công cụ thực thi chúng và AI tóm tắt kết quả. Điều này có nghĩa là bạn nhận được các phép tính thực tế, không phải các xấp xỉ thống kê.

Xác thực

Databox MCP sử dụng xác thực an toàn:

• OAuth 2.0 để ủy quyền người dùng
• Xác thực mã thông báo JWT cho các phiên làm việc an toàn
• Xác thực khóa API cho truy cập theo chương trình

Dữ liệu của bạn vẫn nằm trong tài khoản Databox với các tiêu chuẩn quản trị hiện có. Quyền truy cập AI bị giới hạn ở các quyền dữ liệu được cấp phép rõ ràng.

Bảo mật

• Kết nối được mã hóa (HTTPS)
• Ủy quyền dựa trên phạm vi
• Nhật ký kiểm tra và lịch sử nhập dữ liệu
• Không phụ thuộc vào nhà cung cấp (tiêu chuẩn MCP phổ quát)
• Cô lập dữ liệu theo tài khoản

Các trường hợp sử dụng

Phân tích đột xuất

"Tỷ lệ chuyển đổi của chúng tôi tuần trước so với tuần trước nữa là bao nhiêu?"

Thông tin chi tiết đa nguồn

"Tính ROAS bằng cách kết hợp chi tiêu quảng cáo từ Google Ads với doanh thu từ Stripe"

Phát hiện xu hướng

"Danh mục sản phẩm nào có tỷ lệ hoàn trả cao nhất trong quý này?"

Cảnh báo tự động

"Cảnh báo cho tôi nếu tỷ lệ chuyển đổi trong 3 ngày giảm xuống dưới 2%"

Dọn dẹp dữ liệu

Đẩy các tệp xuất CSV lộn xộn và để Databox tự động chuẩn hóa ngày tháng, định dạng và lược đồ

Truy vấn chỉ số trực tiếp

"Hiển thị cho tôi các phiên Google Analytics trong 30 ngày qua được phân tích theo nguồn lưu lượng truy cập"

Phân tích chuỗi thời gian

"Tải lượt xem trang hàng ngày cho tháng 1 với tổng hợp hàng tuần"

Phân tích theo chiều

"10 quốc gia hàng đầu theo doanh thu từ Stripe là gì?"

Tài nguyên

• Trang đích Databox MCP
• Blog: Trò chuyện với Dữ liệu của Bạn Mọi lúc, Mọi nơi
• Đặc tả Model Context Protocol
• Trung tâm Trợ giúp Databox

Hỗ trợ

Đối với các câu hỏi và hỗ trợ:

• Truy cập Trung tâm Trợ giúp Databox
• Liên hệ support@databox.com

---

Được xây dựng bởi Databox — Theo dõi tất cả các chỉ số kinh doanh của bạn tại một nơi.