跳到主要内容

MCP/API

MCP/API 是 Qubix 唯一的编程接口。外部客户端——AI 助手、BI 脚本、自动化工具——通过 MCP （Model Context Protocol）连接到同一个端点，并调用本页列出的方法。每一次调用都 严格在您的权限范围内运行：管理员可以访问整个账户，而投放人员 只能访问其团队的数据。

无需另外学习一套独立的 REST API：您在这里看到的方法正是该 端点所提供的内容，因此目录绝不会与真实接口产生偏差。

内置助手也由这些方法驱动​

这些方法不仅用于外部客户端。内置 Qubix AI 助手—— 管理面板每个界面上都可用、无需任何配置的面板——调用的正是 同一套目录。所以无论您是询问内置助手，还是通过 MCP 连接您自己的 AI 代理，二者都通过相同的方法读取您的数据并执行操作，并始终在您的 权限范围内。

在哪里找到它​

在管理面板中，打开账户菜单（右上角，您的名字旁边），然后选择 MCP/API。

端点​

所有请求都发往同一个地址：

POST https://<your-domain>/api/mcp

传输方式为 Streamable HTTP（JSON-RPC 2.0）——一个现成 MCP 客户端可以原生使用的单一端点，您也可以从任何语言直接调用它（参见下方的 代码示例）。

您的 API 令牌​

编程访问使用个人令牌（PAT）——直接在本 页的 API Token 区块中创建和管理。

  1. 按下 生成 API token（如果您已有令牌，则按 重新生成）。
  2. 立即复制令牌——它只显示一次。

令牌形如 qbx_…。Qubix 只存储它的哈希值，无法再次显示它。

  • 每位用户一个令牌。 它继承您的角色和权限，因此通过 API 您看到的 数据和操作与界面中完全一致。
  • 重新生成 会签发一个新令牌，旧令牌随即立即失效。
  • 撤销 会删除令牌，并切断所有使用它的访问。
像对待密码一样对待令牌

个人令牌等同于以您的身份登录。请勿公开或共享它。如果 它泄露，请在此处按下 重新生成——旧令牌会立即失效。

连接客户端​

大多数 MCP 客户端只需一小段配置：端点加上 Authorization 头。在 令牌生成后立即显示的同时，本页已将真实值填入下方的 示例——按原样复制即可。

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

如需特定助手（Claude Code、Claude Desktop、Cursor）的分步配置，参见 连接外部 AI。

代码示例​

要从您自己的代码调用该端点，请发送一个带有认证和 Streamable-HTTP 头的 JSON-RPC 请求。本页为 cURL、JavaScript 和 Python 提供了现成的代码片段——切换标签页并复制即可。例如，列出可用的方法：

Bash
curl -X POST 'https://<your-domain>/api/mcp' \
  -H 'Authorization: Bearer qbx_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Python
import requests

res = requests.post(
    "https://<your-domain>/api/mcp",
    headers={
        "Authorization": "Bearer qbx_YOUR_TOKEN",
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)
用于自定义集成

这些原始调用展示了从任何语言使用该协议的方式。现成的客户端（Claude、Cursor） 不需要它们——它们使用上面的配置。

API 暴露了什么​

本页列出了完整的方法目录——目前约有上百个方法——其中每一个 都标记为 读取 或 写入。在您的权限范围内，它们涵盖：

  • 分析——仪表盘、地理、Offer、网络、流量来源、Facebook 各界面和访客漏斗，以及针对单个广告、广告系列、Offer、 创意、PWA、地理或流量来源的下钻。
  • 创意——语义搜索和表现最佳的创意主题。
  • Britva——查看自动化规则、已暂停的广告和触发历史；创建、编辑和 发布规则。
  • 操作——暂停和恢复广告与广告系列；管理 Offer、网络、流量 来源、追踪器广告系列、像素、网站、域名、PWA 和 push 广告系列。
  • 自由格式查询——一个只读查询方法，用于处理现成方法 未覆盖的问题。

每个方法都会显示其参数以及它是否会更改数据。使用搜索框可按 名称或描述查找方法。

写入方法是真实生效的

通过 API 暂停广告、删除规则或 Offer 会更改您正在运行的广告系列。 在聊天客户端中，此类操作只有在您确认后才会执行——在批准前 请先审查所提议的内容。

接下来​

连接外部 AI

分步配置 Claude、Cursor 或其他 MCP 客户端。

连接

Qubix 集成的外部服务所需的密钥。

模板

您的角色——以及由此决定的您的令牌——可以访问哪些数据和操作。

On this page