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

Подключение внешнего 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" }
    }
  }
}

Что умеет ассистент​

После подключения ассистент может читать вашу аналитику и выполнять действия — всё в пределах ваших прав:

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

Ассистент видит ровно то, что видите вы в интерфейсе: администратор получает весь аккаунт, байер — только данные своей команды. Действия ограничены вашими правами так же, как в админ-панели.

Действия — настоящие

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

Безопасность​

  • Токен — ваш ключ доступа, обращайтесь с ним как с паролем, не кладите его в общие файлы или публичные репозитории.
  • Один токен на пользователя. Чтобы отозвать доступ, откройте страницу MCP/API и нажмите Отозвать (или Перегенерировать, чтобы заменить его).

Что дальше​

AI-чат-аналитик

встроенный ассистент, настройка не нужна.

MCP/API

эндпоинт, ваш токен и полный каталог методов.

AI (обзор)

данные аналитика, стоящие за инструментами.

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