EN RU
Цены Блог

# MCP new

expert team enterprise

MCP (Model Context Protocol) — открытый протокол, через который AI-ассистенты (Claude Code, Codex, Cursor и другие) работают с внешними системами. После подключения к Keitaro агент отвечает на вопросы по статистике, разбирает логи и, если это разрешено настройками, меняет кампании, потоки и офферы.

Агент действует от имени пользователя Keitaro, который его подключил, и видит только данные, доступные пользователю по правам доступа.

TIP

MCP доступен в редакциях Expert, Team и Enterprise. Сравнение редакций — в статье Тарифные планы Keitaro.

# Когда использовать MCP

  • Вопросы к статистике на обычном языке. «Топ-5 кампаний по ROI за неделю», «Какие страны дают лучший EPC по офферу X», «Сравни CR лендингов A и B за вчера».
  • Поиск проблем. «Какие кампании уходят в минус третий день подряд», «Где выросла доля ботов», «Что изменилось в трафике по сравнению со вчерашним днём».
  • Разбор недошедших конверсий и постбеков. Агент читает лог входящих постбеков (от партнерской сети в Keitaro) и исходящих (из Keitaro в источник трафика) и показывает, на каком шаге произошёл сбой.
  • Быстрые точечные правки (только в режиме Редактирование): поставить кампанию на паузу или включить её, клонировать кампанию, добавить или изменить поток, создать оффер.

# Когда MCP не подходит

  • Массовые и регулярные операции, интеграции. «Ставь на паузу все кампании с ROI меньше −20% каждое утро» — задача для Admin API или скрипта: они работают предсказуемо и без участия языковой модели.
  • Администрирование трекера. Настройки трекера, пользователи и права, ботлисты и триггеры через MCP недоступны, домены доступны только для просмотра списком.
  • Выгрузка больших объёмов данных. Отчёты и логи отдаются порциями (по умолчанию 100 строк отчёта и 50 записей лога), а списки кампаний, офферов, лендингов и других объектов — целиком. На большом аккаунте ответы быстро заполняют контекст модели. Для больших выгрузок подходят экспорт отчётов и Admin API.
  • Действия, где ошибка обходится дорого. Модель способна неверно понять запрос. В режиме Редактирование проверяйте план действий агента перед подтверждением.

# Возможности

# Чтение — в обоих режимах

Что Что умеет агент
Статистика Строить отчёты с любой группировкой, метриками, фильтрами и сортировкой; получать итоговые цифры за период
Логи Читать лог кликов, лог конверсий, лог входящих и исходящих постбеков
Кампании Список кампаний и полные настройки одной кампании
Потоки Потоки кампании и настройки одного потока, список доступных действий и фильтров потока
Офферы Список офферов и настройки одного оффера
Лендинги, источники трафика, партнерские сети, домены, группы Только список

# Запись — только в режиме «Редактирование»

Объект Создать Изменить Удалить
Кампания Создать, клонировать Название, источник, группа, тип и сумма расхода; пауза и включение Архивировать (с возможностью восстановления)
Поток Создать Название, тип, схема, действие, офферы, лендинги, фильтры и логика их сочетания, вес, позиция, состояние, сбор кликов, момент выбора оффера, комментарий Архивировать (с возможностью восстановления)
Оффер Создать (только оффер-редирект по URL) Название, URL, партнерская сеть, выплата, группа Недоступно

# Ограничения

  • Настройки трекера и пользователи закрыты в любом режиме, в том числе для агента, подключённого администратором. Поэтому агенту недоступно включение режима редактирования и расширение прав.
  • Лендинги, источники трафика, партнерские сети, домены и группы доступны только для просмотра списком.
  • Через MCP недоступно:
    • создание и правка конверсий;
    • обновление расходов;
    • ботлисты, триггеры, API-ключи;
    • логи ошибок и аудита;
    • просмотр и восстановление архива;
    • удаление офферов;
    • окончательное удаление кампаний и потоков.
  • Валюта расхода кампании задаётся через MCP только при создании кампании. Изменение валюты после создания — только в интерфейсе Keitaro.
  • При изменении потока список офферов, лендингов или фильтров заменяется целиком. Агент учитывает это, но перед правкой полезно попросить его показать текущие настройки потока.
  • Права пользователя действуют в любом режиме. Кампании и логи, к которым у пользователя нет доступа, агенту недоступны. Для разбора постбеков необходим доступ к логам.
  • Режим доступа общий для трекера и действует для всех подключённых пользователей (в пределах прав каждого).
  • Необходим клиент с поддержкой OAuth по Streamable HTTP. Claude Code, Codex и Cursor её поддерживают.

# Требования

  1. Редакция Expert, Team или Enterprise.
  2. Домен с включённой админ-панелью (вкладка Домены).
  3. Домен открывается по HTTPS с действительным сертификатом. Без него AI-клиенты не подключатся: они принимают только HTTPS. Самоподписанный сертификат не подходит.

# Как включить

MCP включает администратор: страница настроек MCP доступна только администратору.

  1. Откройте Настройки → MCP.
  2. Отметьте Включить MCP.
  3. В поле Домен выберите домен для работы MCP. В списке только домены с включённой админ-панелью.
  4. Выберите значение в поле Режим доступа.
    • Только чтение (по умолчанию) — агент читает данные без права изменения. Инструменты записи агенту не показываются.
    • Редактирование — агент читает данные, создаёт и меняет кампании, потоки и офферы.
  5. Нажмите Сохранить.

# Как подключить агента

Адрес сервера — https://домен-MCP/mcp, где домен — выбранный в настройках MCP. Администратор видит готовые команды на странице Настройки → MCP в блоке Подключить агента. Остальным пользователям администратор сообщает адрес, и они подключаются аналогичными командами.

Для Claude Code:

claude mcp add --transport http keitaro https://example.com/mcp
1

Для Codex:

codex mcp add keitaro --url https://example.com/mcp
codex mcp login keitaro
codex mcp list
1
2
3

Для Cursor добавьте в ~/.cursor/mcp.json (если файл уже существует, допишите keitaro в существующий mcpServers):

{
  "mcpServers": {
    "keitaro": {
      "url": "https://example.com/mcp"
    }
  }
}
1
2
3
4
5
6
7

Затем выполните в терминале — первая команда откроет браузер для входа, вторая покажет инструменты keitaro:

agent mcp login keitaro
agent mcp list-tools keitaro
1
2

Другие клиенты с поддержкой MCP подключаются по адресу https://домен-MCP/mcp.

При первом обращении откроется браузер: войдите в Keitaro и подтвердите доступ. Создавать API-ключ заранее не требуется — Keitaro выпустит ключ с именем MCP автоматически.

# Управление доступом

  • Доступ для пользователей. Агента подключает любой пользователь трекера, агент получает права подключившего пользователя. Запрет MCP для отдельного пользователя не предусмотрен — только выключение MCP целиком.

  • Один ключ на пользователя. Все агенты пользователя (например, Claude Code и Cursor одновременно) работают через один ключ MCP.

  • Не используйте имя MCP для собственных API-ключей. Трекер считает любой ключ с таким именем ключом MCP: на него действуют ограничения MCP, а при выключении MCP он удаляется.

  • Как отключить агентов. Удалите ключ MCP:

    • пользователь — Профиль → API ключи;
    • администратор за любого пользователя — Пользователи → API ключи нужного пользователя.

    Отключаются сразу все агенты пользователя, отключение одного агента не предусмотрено. Это не запрет: при следующем входе через браузер ключ выпускается заново.

  • Выключение MCP (или отключение админ-панели на домене MCP) сразу отзывает ключи всех пользователей. После повторного включения агентов необходимо подключить заново.

  • Смена домена MCP. Адрес сервера меняется, поэтому в каждом клиенте удалите старое подключение и добавьте новое с новым адресом.

  • Смена режима доступа закрывает текущие сессии. Агенты переподключаются автоматически, повторный вход не требуется. После переключения на Только чтение запись блокируется трекером сразу, а список инструментов в клиенте обновляется с небольшой задержкой.

  • Повторный вход. Если агент не обращался к трекеру больше 30 дней, при следующем обращении потребуется повторно войти через браузер.

← Дашборд →