跳到主要内容

接入外部 AI（MCP）

除了内置的 AI 分析师 之外，Qubix 还可以连接到您自己的 AI 助手——Claude Desktop、Claude Code、Cursor 或任何支持 MCP（Model Context Protocol）的客户端。该助手随后会使用实时数据回答有关您 广告系列的问题——访问权限和权限范围与您在界面中拥有的完全一致。

您需要准备什么​

  • 一个个人令牌（PAT）——在 MCP/API 页面创建。详见 MCP/API。
  • 您的 Qubix 地址，格式为 https://<your-domain>/api/mcp。
令牌仅显示一次

令牌只在您创建它的那一刻显示。请立即复制并妥善保管——Qubix 只存储其哈希值， 无法再次显示。丢失了？按 重新生成 获取新令牌（旧令牌会立即失效）。

如何连接​

您需要两样东西：地址 https://<your-domain>/api/mcp 和请求头 Authorization: Bearer <your-token>。其余取决于客户端。

Claude Code（CLI）​

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

重启 Claude Code——Qubix 工具便会在聊天中可用。

Claude Desktop​

打开 Settings → Connectors → Add custom connector，设置地址 https://<your-domain>/api/mcp 并添加请求头 Authorization: Bearer qbx_YOUR_TOKEN。

Cursor​

将服务器添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

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

助手能做什么​

连接后，助手可以读取您的分析数据并执行操作—— 一切都在您的权限范围之内：

  • 分析 — 仪表盘、地理、Offer、网络、流量来源、 Facebook 各个界面、访客漏斗，以及对任一单个广告、 广告系列、Offer、创意、PWA、地理或流量来源的下钻分析。
  • 创意 — 语义搜索（"查找类似假聊天截图的创意"） 以及表现最佳的创意主题。
  • Britva — 查看自动化规则、已暂停的广告和触发历史；创建、 编辑和发布规则。
  • 操作 — 暂停和恢复广告及广告系列；管理 Offer、网络、 流量来源和 Tracker 广告系列。
  • 自由格式查询 — 处理现成工具未涵盖的问题。
仅限您的数据

助手看到的内容与您在界面中看到的完全一致：管理员获得整个 账户，买量员只获得其团队的数据。操作受您的 权限限制，就像在管理面板中一样。

操作是真实的

通过助手暂停广告、删除规则或 Offer 会更改您的 真实广告系列。在聊天客户端中，此类操作只有在您 确认后才会执行——在批准之前请阅读助手所提议的内容。

安全​

  • 令牌是您的访问密钥——请像对待密码一样对待它，不要将其放入 共享文件或公共代码仓库中。
  • 每个用户一个令牌。要撤销访问，请打开 MCP/API 页面并 按 撤销（或 重新生成 以替换它）。

下一步​

AI 分析师聊天

内置助手，无需任何设置。

MCP/API

端点、您的令牌和完整的方法目录。

AI（概览）

工具背后的分析数据。

On this page