AdCab
Интеграции

Чем управляет коннектор

Один адрес коннектора связывает ИИ-клиента с вашими рекламными кабинетами. Подключается к Claude и ChatGPT, а также к российским платформам — Yandex AI Studio и GigaChat. Мы не перепродаём доступ к ИИ: за модель вы платите её владельцу, а за коннектор — нам.

ИИ-клиенты

Claude

Официальный клиент Anthropic с поддержкой MCP-коннекторов.

Подключить

ChatGPT

Пользовательские коннекторы OpenAI на платных планах.

Подключить

Yandex AI Studio

Агент на YandexGPT или Alice AI в облаке Яндекса — настраивается в интерфейсе, без кода.

Подключить
для разработчиков

GigaChat

Агент на GigaChat API. В чате giga.chat своих MCP-серверов подключить нельзя — нужен небольшой скрипт.

Подключить

Cursor, Codex, VS Code

Редакторы кода и другие программы с поддержкой MCP. Подключаются по тому же адресу.

Подключить
Рекламные кабинеты
работает

Яндекс Директ

Кампании, ставки, статистика и площадки РСЯ — из вашего аккаунта.

Войти через Яндекс
работает

VK Реклама

Кампании, группы объявлений и статистика — из вашего кабинета.

Войти через VK

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

Claude

Официальный клиент Anthropic с поддержкой MCP-коннекторов.

1Settings → Connectors → Add custom connector.
2Вставьте адрес https://app.adcab.ru/mcp
3Нажмите Connect — откроется вход через Яндекс и экран разрешений.
4Инструменты появятся в чате. Начните с «покажи мои рекламные аккаунты».
ChatGPT

Работает через пользовательские коннекторы OpenAI.

1Settings → Connectors → Create (нужен план с поддержкой пользовательских коннекторов).
2MCP Server URL: https://app.adcab.ru/mcp, аутентификация — OAuth.
3Подтвердите доступ и включите коннектор в нужном чате.
Локальная проверка
npx @modelcontextprotocol/inspector
# transport: Streamable HTTP
# url: https://app.adcab.ru/mcp

Статистика по заголовкам и картинкам

Срезы по заголовкам, текстам и изображениям агент строит сам — для обычных объявлений. У комбинаторных объявлений единых перфоманс-кампаний статистики по отдельным элементам нет в API Директа: она есть только в Мастере отчётов в интерфейсе. Выгрузите там отчёт с нужными группировками, пришлите файл или таблицу в чат — агент разберёт её сам и посчитает итоги: сложит строки по заголовку или картинке и пересчитает CTR, цену клика и цену конверсии из сумм.

Cursor, Codex, VS Code и другие клиенты

Отдельной настройки под каждую программу нет. Подойдёт любой клиент, который подключает удалённые MCP-серверы со входом через OAuth: ему нужен только адрес коннектора. При первом подключении откроется вход в AdCab.

Codex
1Добавьте сервер в терминале:
codex mcp add adcab --url https://app.adcab.ru/mcp
2Войдите — откроется браузер:
codex mcp login adcab
3Готово. Настройка общая для Codex в терминале, в редакторе и в приложении ChatGPT для компьютера.
CCursor
1Откройте файл ~/.cursor/mcp.json и добавьте сервер. Для одного проекта — файл .cursor/mcp.json в его папке.
{
  "mcpServers": {
    "adcab": { "url": "https://app.adcab.ru/mcp" }
  }
}
2В настройках Cursor, в разделе MCP, нажмите у сервера adcab кнопку входа и войдите в аккаунт.
VSVS Code
1Палитра команд → MCP: Add Server → HTTP. Вставьте адрес и назовите сервер adcab.
2Или добавьте сервер в .vscode/mcp.json:
{
  "servers": {
    "adcab": { "type": "http", "url": "https://app.adcab.ru/mcp" }
  }
}
3Запустите сервер и войдите в аккаунт, когда откроется браузер. Инструменты появятся в чате Copilot в режиме агента.

Для других клиентов: транспорт — Streamable HTTP, вход — OAuth с автоматической регистрацией клиента. Если программа не умеет входить через OAuth, подключите её по ключу доступа: заголовок Authorization: Bearer adcab_…. Правки в рекламе из любого клиента работают одинаково: сначала черновик, в аккаунт — после вашего подтверждения.

Российские модели

Эти платформы не умеют входить в AdCab по кнопке, поэтому подключаются по личному ключу доступа. Выпустите ключ на странице Ключи доступа — отдельный для каждой платформы, чтобы при необходимости отозвать только его.

Yandex AI Studio

Агент в AI Studio работает на моделях Яндекса, запросы идут через Yandex Cloud.

1Создайте ключ на странице Ключи доступа.
2AI Studio → MCP Hub → подключить внешний MCP-сервер. URL: https://app.adcab.ru/mcp, транспорт — Streamable HTTP.
3Тип авторизации — «Токен доступа»: заголовок Authorization, значение Bearer adcab_… (ваш ключ).
4Agent Atelier → создайте агента, добавьте инструмент MCP и выберите этот сервер. Включите подтверждение вызовов инструментов.
5Проверьте в Playground: «покажи мои рекламные аккаунты».

Карточки с кнопкой «Применить» AI Studio не показывает: изменения применяются, когда вы подтверждаете их словами в чате. Если в настройках аккаунтов включено «Применять только кнопкой», из AI Studio изменения применить не получится — черновики и отчёты работают.

GigaChat

Готового места для своих MCP-серверов в чате GigaChat нет. Подключение — через GigaChat API и агента на Python.

1Получите ключ GigaChat API в личном кабинете разработчика Сбера.
2Создайте ключ на странице Ключи доступа.
3Установите библиотеки и запустите агента:
pip install langchain-gigachat langchain-mcp-adapters langgraph

import asyncio, os
from langchain_gigachat.chat_models import GigaChat
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async def main():
    client = MultiServerMCPClient({
        "adcab": {
            "url": "https://app.adcab.ru/mcp",
            "transport": "streamable_http",
            "headers": {"Authorization": "Bearer " + os.environ["ADCAB_KEY"]},
        }
    })
    tools = await client.get_tools()
    model = GigaChat(model="GigaChat-2-Max",
                     credentials=os.environ["GIGACHAT_CREDENTIALS"])
    agent = create_react_agent(model, tools)
    answer = await agent.ainvoke(
        {"messages": [("user", "Покажи мои рекламные аккаунты")]})
    print(answer["messages"][-1].content)

asyncio.run(main())

Инструменты

Полный список: 81 инструмент, доступных ИИ через коннектор.

чтение 42 · черновики 35 · подтверждение 4

Читают

ИнструментЧто делает
list_ad_accountsСписок рекламных аккаунтов
list_agency_clientsКлиенты агентского аккаунта
list_campaignsКампании
get_campaign_settingsНастройки кампании Яндекс Директа
list_ad_imagesКартинки в библиотеке аккаунта
get_campaign_structureСтруктура кампании
wordstat_researchПодбор семантики (Вордстат)
cluster_keywordsКластеризация запросов
get_statsСтатистика Директа
audit_placementsАудит площадок РСЯ
list_metrika_countersСчётчики Метрики и цели
metrika_reportОтчёт Метрики
analyze_report_exportРазбор выгрузки из Мастера отчётов
generate_ad_imageНарисовать изображение для объявления
edit_ad_imageПеределать изображение для объявления
get_channel_linksСсылки на каналы Telegram и MAX
list_dictionariesСправочники Яндекс Директа
keywords_researchПроверка ключевых фраз
list_ad_extensionsУточнения аккаунта
list_negative_keyword_setsНаборы минус-фраз
list_retargeting_listsСписки ретаргетинга
list_changesЧто изменилось в аккаунте
get_client_settingsНастройки рекламодателя
list_account_objectsОбъекты аккаунта: фиды, креативы, турбо-страницы, условия показа
list_leadsЛиды с турбо-страниц
direct_api_referenceСправочник Direct API
direct_api_callПрямой запрос в Direct API (только чтение)
vk_list_campaignsКампании VK Рекламы
vk_get_campaign_structureСтруктура кампании VK Рекламы
vk_get_statsСтатистика VK Рекламы
avito_list_campaignsКампании Авито Рекламы
avito_get_campaign_structureСтруктура кампании Авито Рекламы
avito_get_statsСтатистика Авито Рекламы
avito_get_balanceБаланс Авито Рекламы
avito_items_listОбъявления Авито
avito_item_infoОбъявление Авито
avito_items_statsСтатистика объявлений Авито
avito_items_balanceКошелёк Авито
avito_autoload_statusАвтозагрузка Авито
gsc_list_sitesСайты в Google Search Console
gsc_search_queriesЗапросы сайта в поиске Google
gsc_pagesСтраницы сайта в поиске Google

Готовят черновики

ИнструментЧто делает
draft_campaignЧерновик кампании
draft_bid_changesЧерновик правки ставок
draft_negative_keywordsЧерновик минус-фраз
draft_block_placementsЧерновик блокировки площадок РСЯ
draft_ad_editsЧерновик правки объявлений
draft_campaign_stateЧерновик остановки/запуска кампаний
draft_campaign_settingsЧерновик правки настроек кампании
draft_bid_modifiersЧерновик корректировок ставок
draft_autotargetingЧерновик включения/выключения автотаргетинга
draft_ad_group_editsЧерновик правки групп объявлений
draft_add_adsЧерновик новых объявлений в группу
draft_combinatorial_ad_editsЧерновик правки комбинаторных объявлений
draft_add_combinatorial_adsЧерновик новых комбинаторных объявлений
draft_lifecycleЧерновик остановки, архивации и удаления объектов
draft_time_targetingЧерновик расписания показов
draft_add_ad_groupsЧерновик новых групп в кампанию
draft_add_keywordsЧерновик новых ключевых фраз
draft_upload_imagesЧерновик загрузки картинок в библиотеку
draft_ad_extensionsЧерновик уточнений
draft_negative_keyword_setЧерновик набора минус-фраз
draft_retargeting_listЧерновик условия ретаргетинга или сегмента интересов
draft_audience_targetsЧерновик условий подбора аудитории в группе
draft_client_settingsЧерновик настроек рекламодателя
draft_feedЧерновик товарного фида
draft_mediaЧерновик загрузки видео и креативов
draft_dynamic_targetsЧерновик условий динамических объявлений
draft_smart_targetsЧерновик условий смарт-баннеров
draft_auto_bidsЧерновик автоматических правил для ставок
draft_keyword_settingsЧерновик настроек ключевых фраз
draft_agency_clientЧерновик клиента агентства
draft_direct_api_callЧерновик прямого изменения через Direct API
vk_draft_campaignЧерновик кампании VK Рекламы
vk_draft_campaign_stateЗапустить или остановить кампанию VK Рекламы
avito_draft_bidЧерновик ставки группы Авито
avito_draft_budgetЧерновик бюджета группы Авито

Подтверждение

ИнструментЧто делает
list_pending_changesПоказать подготовленные изменения пользователю
apply_changeПрименить одно подготовленное изменение
apply_changesПрименить несколько подготовленных изменений
cancel_changeОтменить подготовленное изменение

Безопасность изменений

Инструменты draft_* не обращаются к API на запись. Они сохраняют подготовленное изменение и возвращают его id. Изменение уходит в Директ только через apply_change с этим id и явным подтверждением. Неподтверждённые черновики сгорают через 30 минут.