Adv.Cake через MCP: заказы и визиты партнёрской сети без захода в кабинет

Обзор

Adv.Cake — российская партнёрская сеть: рекламодатель платит комиссию за заказы, которые пришли через партнёров и вебмастеров (кэшбэк-сервисы, купонные площадки, блогеры). У рекламодателя свой личный кабинет и свой API — не путать с API вебмастера или партнёра, у которых там же, в документации Adv.Cake, свои разделы и свои ключи.

API рекламодателя маленький — три метода, все GET, все под одним персональным ключом. Mira подключает его целиком и отдаёт в Claude через MCP.

Что доступно рекламодателю

Три метода — это не сокращённое покрытие, а вся документация: страница support.advcake.com/docs/api/advertiser-api/ не называет других адресов для рекламодателя. Управление офферами и кампаниями, которое иногда мелькает в маркетинговых описаниях сервиса, в документации API не задокументировано — если оно и существует, то по индивидуальному запросу к менеджеру, а не как публичный контракт. Придумывать методы по названию раздела — тот же риск, что уже стоил дорого на других коннекторах: 400-й ответ на каждый выдуманный вызов.

Deталь, которую легко пропустить: GET, который не просто читает

У «Валидации рефералов» в ответе есть поле just_created — «создан ли реферал». Это значит, что сам запрос может завести нового вебмастера в партнёрской сети рекламодателя, если такого email там ещё не было, и выдать ему API-ключ. Внешне — обычный GET с параметром email, но по эффекту это запись, а не чтение.

Mira ставит этот метод под тот же барьер, что и обычные POST/PUT/DELETE у других коннекторов: без разрешения на запись у источника вызов отказывает, и запрос к Adv.Cake вообще не уходит. Разбирать метод HTTP как признак «читает / пишет» здесь было бы ошибкой — решает не глагол запроса, а то, что происходит на стороне поставщика. Похожий случай уже был у Ozon Performance: включение и выключение продвижения «Оплата за заказ» тоже идёт GET-ом.

Авторизация — одним ключом, в строке запроса

Ключ один — «Апи ключ» из настроек профиля, копируется и подставляется в каждый запрос параметром pass, а не заголовком:

https://api.advcake.ru/orders/advertiser/offer?pass={API-key}&date_from=2026-08-01&date_to=2026-08-31

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

Как это выглядит через MCP

Сколько мы заплатили комиссии партнёрам за август?

Claude запрашивает список заказов за август с фильтром по датам, складывает commission по всем строкам и отвечает суммой — без захода в кабинет Adv.Cake и без ручного экспорта в Excel.

Какой партнёр привёл больше всего заказов на прошлой неделе?

Claude получает список заказов за неделю и группирует их по полю partner — та же задача, что раньше решалась фильтрами в интерфейсе кабинета.

Что это даёт на практике

Маркетологу. Расход на партнёрский канал и его отдача (ДРР) — рядом с прямым трафиком и позициями, без переключения между кабинетами разных площадок.

Финансисту. Комиссия партнёрам — статья расходов, которую можно свести с остальными платежами одним вопросом.

Разработчику. Готовый клиент вместо трёх ручных интеграций: сборки строки запроса, разбора отказа (форма которого нигде не документирована) и решения о том, что валидация реферала — не безобидное чтение.

Как подключить

1. Личный кабинет Adv.Cake → Настройки профиля.
2. Скопировать «Апи ключ».
3. В Mira: проект → источники → Adv.Cake → вставить ключ.

Дальше Adv.Cake доступен и в чате Mira, и через MCP-сервер — в Claude, Cursor или другом клиенте с поддержкой протокола.