VK Ads — 97 инструментов MCP

Подключение

{
  "mcpServers": {
    "lidfly": {
      "url": "https://lidfly.ru/mcp/v3",
      "headers": {
        "Authorization": "Bearer {ваш_api_key}"
      }
    }
  }
}

Быстрый старт — инструкции для всех AI-клиентов

Для новых подключений используйте единый endpoint /mcp/v3. Полный VK endpoint /mcp/vk остаётся для legacy/advanced сценариев.

Если доступно несколько VK Ads подключений или кабинетов, AI сначала вызывает get_provider_context или resolve_campaign_scope, а затем передаёт в рабочие инструменты точный connection_id и при необходимости client_id. Для собственного кабинета нужен только connection_id. Если пользователь явно добавил VK user ID из переключателя, LidFly использует скрытый _user_id для read-инструментов.

Несколько подключений и кабинетов VK Ads

После OAuth LidFly сохраняет отдельное VK Ads подключение, синхронизирует его основной кабинет, клиентов агентства и клиентов менеджера, показывает их в личном кабинете и позволяет выбрать default OAuth-подключение и рабочий кабинет ИИ. Встроенный чат, /mcp/v3, /mcp/vk и /mcp/vk/lite автоматически передают нужный connection_id, а для клиентского кабинета ещё и client_id.

Важно: OAuth подключает не выбранный в верхнем меню кабинет VK Ads, а VK-пользователя, который подтвердил доступ. Если в браузере можно переключиться на кабинет клиента, но после «Найти кабинеты VK Ads» он не появляется в LidFly, значит VK API не отдаёт этот кабинет как клиента агентства или менеджера для текущего токена.

Для таких случаев в личном кабинете есть ручное добавление VK user ID из переключателя VK Ads. VK Ads API не показывает список этих скрытых клиентов отдельным методом, поэтому ID вводится вручную один раз. LidFly проверяет его read-запросом через недокументированный фильтр _user_id и дальше подставляет этот фильтр автоматически.

Тарификация считает все активные VK Ads кабинеты, доступные ИИ: 1–4 кабинета по 990 ₽, с 5-го — MCP-пакет «Агентство».

Синхронизируйте OAuth подключает VK-пользователя. Клиентские кабинеты подтягиваются через «Найти кабинеты VK Ads», а затем выбираются рабочими для ИИ.

Выберите default Если кампании у клиента, сделайте клиентский кабинет кабинетом по умолчанию.

Привяжите к Пространству Для агентств каждый клиентский проект должен иметь provider entity vk_ads; AI получит connection_id из provider context.

Если клиентский кабинет — отдельный VK-логин, подключите его дополнительным OAuth: выйдите из текущего VK/VK Ads или откройте отдельный профиль браузера, войдите под нужным логином и нажмите «Подключить ещё VK Ads OAuth». Так можно держать в одном аккаунте LidFly несколько разных VK-логинов.

Если кабинет должен быть доступен через агентство или менеджера, он должен вернуться из agency/clients.json или /api/v3/manager/clients.json. Ручной ID из интерфейса VK Ads не заменяет official API-доступ: для agency_client_credentials нужен user id клиента из AgencyClients/ManagerClients, иначе VK отвечает Unknown client.

Переключение sudo в браузере VK Ads не равно official API-доступу. Но если клиент виден в переключателе, можно добавить его VK user ID в LidFly: чтение кампаний, групп, объявлений и статистики пойдёт через скрытый _user_id. Для изменений кампаний нужен официальный agency/manager API-доступ или отдельный VK OAuth клиента.

VK Ads — 97 инструментов

Подключение

Несколько подключений и кабинетов VK Ads

VK Mini Apps и in-app события