Kết nối AI bên ngoài (MCP)

Ngoài Chuyên gia phân tích AI tích hợp sẵn, Qubix có thể được kết nối với trợ lý AI của riêng bạn — Claude Desktop, Claude Code, Cursor hoặc bất kỳ client nào hỗ trợ MCP (Model Context Protocol). Khi đó trợ lý sẽ trả lời các câu hỏi về chiến dịch của bạn dựa trên dữ liệu trực tiếp — với đúng quyền truy cập và quyền hạn mà bạn có trong giao diện.

Bạn cần những gì

• Một token cá nhân (PAT) — tạo nó trên trang MCP/API. Xem thêm — MCP/API.
• Địa chỉ Qubix của bạn ở dạng https://<your-domain>/api/mcp.

Token chỉ hiển thị một lần

Token chỉ hiển thị đúng vào lúc bạn tạo nó. Hãy sao chép ngay và giữ an toàn — Qubix chỉ lưu mã hash của nó và không thể hiển thị lại. Bị mất rồi? Nhấn Tạo lại để nhận token mới (token cũ ngừng hoạt động ngay lập tức).

Cách kết nối

Bạn cần hai thứ: địa chỉ https://<your-domain>/api/mcp và header Authorization: Bearer <your-token>. Phần còn lại tùy thuộc vào client.

Claude Code (CLI)

Bash

claude mcp add --transport http qubix https://<your-domain>/api/mcp \
  --header "Authorization: Bearer qbx_YOUR_TOKEN"

Khởi động lại Claude Code — các công cụ Qubix sẽ khả dụng trong cuộc trò chuyện.

Claude Desktop

Mở Settings → Connectors → Add custom connector, đặt địa chỉ https://<your-domain>/api/mcp và thêm header Authorization: Bearer qbx_YOUR_TOKEN.

Cursor

Thêm máy chủ vào ~/.cursor/mcp.json (hoặc .cursor/mcp.json của dự án):

JSON

{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

Trợ lý có thể làm gì

Sau khi kết nối, trợ lý có thể đọc dữ liệu phân tích của bạn và thực hiện các hành động — tất cả trong phạm vi quyền hạn của bạn:

• Phân tích — bảng điều khiển, geo, offer, network, nguồn lưu lượng, các màn hình Facebook, phễu khách truy cập, và phân tích chi tiết cho bất kỳ một quảng cáo, chiến dịch, offer, creative, PWA, geo hoặc nguồn lưu lượng nào.
• Creative — tìm kiếm ngữ nghĩa ("tìm những creative giống ảnh chụp màn hình chat giả") và các chủ đề creative có hiệu suất hàng đầu.
• Britva — xem các quy tắc tự động hóa, quảng cáo đã tạm dừng và lịch sử kích hoạt; tạo, chỉnh sửa và phát hành quy tắc.
• Hành động — tạm dừng và tiếp tục quảng cáo cùng chiến dịch; quản lý offer, network, nguồn lưu lượng và chiến dịch tracker.
• Truy vấn tự do — cho những câu hỏi mà các công cụ có sẵn không bao quát được.

Chỉ dữ liệu của bạn

Trợ lý nhìn thấy đúng những gì bạn nhìn thấy trong giao diện: quản trị viên nhận toàn bộ tài khoản, một buyer chỉ nhận dữ liệu của nhóm mình. Các hành động bị giới hạn bởi quyền hạn của bạn giống hệt như trong bảng quản trị.

Hành động là thật

Tạm dừng một quảng cáo, xóa một quy tắc hoặc một offer qua trợ lý sẽ thay đổi chiến dịch thật của bạn. Trong các client trò chuyện, những hành động như vậy chỉ được thực hiện sau khi bạn xác nhận — hãy đọc kỹ những gì trợ lý đề xuất trước khi phê duyệt.

Bảo mật

• Token là chìa khóa truy cập của bạn — hãy coi nó như mật khẩu, đừng đặt nó trong các tệp dùng chung hoặc kho lưu trữ công khai.
• Một token cho mỗi người dùng. Để thu hồi quyền truy cập, mở trang MCP/API và nhấn Thu hồi (hoặc Tạo lại để thay thế nó).

Tiếp theo là gì

Chat với Chuyên gia phân tích AI

trợ lý tích hợp sẵn, không cần thiết lập.

MCP/API

endpoint, token của bạn và toàn bộ danh mục phương thức.

AI (tổng quan)

dữ liệu phân tích đằng sau các công cụ.