Перейти к основному содержимому

MCP/API

MCP/API — единый программный интерфейс Qubix. Внешние клиенты — ИИ-ассистент, BI-скрипт, инструмент автоматизации — подключаются к одному эндпоинту по протоколу MCP (Model Context Protocol) и вызывают методы, перечисленные на этой странице. Каждый вызов выполняется строго в рамках ваших прав: администратор получает доступ ко всему аккаунту, байер — только к данным своей команды.

Отдельного REST API учить не нужно: методы, которые вы здесь видите, — это ровно то, что обслуживает эндпоинт, поэтому каталог никогда не расходится с реальным интерфейсом.

Эти же методы питают встроенного ассистента​

Эти методы нужны не только внешним клиентам. Встроенный ИИ-ассистент Qubix — панель, доступная на каждом экране админки без какой-либо настройки, — вызывает тот же самый каталог. Поэтому спрашиваете ли вы встроенного ассистента или подключаете собственного ИИ-агента по MCP — оба читают ваши данные и выполняют действия через одни и те же методы, всегда в рамках ваших прав.

Где найти​

В админке откройте меню аккаунта (вверху справа, рядом с вашим именем) и выберите MCP/API.

Эндпоинт​

Всё идёт на один адрес:

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

Транспорт — Streamable HTTP (JSON-RPC 2.0): единый эндпоинт, который готовые MCP-клиенты понимают нативно и который можно вызывать напрямую из любого языка (см. Примеры кода ниже).

Ваш API-токен​

Программный доступ использует персональный токен (PAT) — он создаётся и управляется прямо на этой странице, в блоке API Token.

  1. Нажмите Сгенерировать API-токен (или Перегенерировать, если он у вас уже есть).
  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) см. Подключение внешнего ИИ.

Примеры кода​

Чтобы вызвать эндпоинт из своего кода, отправьте JSON-RPC-запрос с заголовками авторизации и Streamable-HTTP. Страница предлагает готовые сниппеты для 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​

Страница перечисляет полный каталог методов — сегодня около сотни — и каждый помечен как чтение или запись. В рамках ваших прав они охватывают:

  • Аналитику — дашборд, гео, офферы, партнёрки, источники трафика, экраны Facebook и воронку посетителей, а также детализацию по отдельному объявлению, кампании, офферу, креативу, PWA, гео или источнику трафика.
  • Креативы — семантический поиск и самые результативные темы креативов.
  • Britva — просмотр автоправил, приостановленных объявлений и истории срабатываний; создание, редактирование и снятие правил.
  • Действия — приостановка и возобновление объявлений и кампаний; управление офферами, партнёрками, источниками трафика, кампаниями трекера, пикселями, сайтами, доменами, PWA и push-кампаниями.
  • Произвольные запросы — метод запросов только для чтения, для вопросов, которые не покрывают готовые методы.

Каждый метод показывает свои параметры и то, меняет ли он данные. Используйте поле поиска, чтобы найти метод по имени или описанию.

Методы записи — настоящие

Приостановка объявления, удаление правила или оффера через API меняет ваши живые кампании. В чат-клиентах такие действия выполняются только после вашего подтверждения — проверяйте предложенное перед одобрением.

Что дальше​

Подключение внешнего ИИ

пошаговая настройка Claude, Cursor или другого MCP-клиента.

Подключения

ключи для внешних сервисов, с которыми интегрируется Qubix.

Шаблоны

какие данные и действия доступны вашей роли — а значит, и токену.

На этой странице