Управление рекламными кампаниями VK Ads через MCP-протокол. Кампании, группы, объявления, статистика, VK Mini Apps, аудитории, справочники и несколько доступных кабинетов.
Подключение Claude Code, Codex, ChatGPT и других MCP-клиентов идёт через единый сервер https://lidfly.ru/mcp/v3 и OAuth-авторизацию в браузере. API-ключ вручную копировать не нужно.
Для новых подключений используйте единый endpoint /mcp/v3. Полный VK endpoint /mcp/vk остаётся для legacy/advanced сценариев. Все meta-инструменты из tools/list, включая get_provider_context и resolve_campaign_scope, AI вызывает напрямую; в call_tool/call_write_tool передаются только внутренние инструменты, найденные через search_tools.
Если доступно несколько VK Ads подключений или кабинетов, AI сначала вызывает get_provider_context; если известна кампания — resolve_campaign_scope, который сначала ищет её в Пространствах. Затем AI передаёт в рабочие инструменты точные workspace_project_id, connection_id и при необходимости client_id. Campaign write без workspace_project_id проходит только когда call_write_tool preflight по campaign id нашёл единственный Workspace/provider scope. Для собственного кабинета нужен только connection_id. Если пользователь явно добавил VK user ID из переключателя, LidFly использует скрытый _user_id для чтения и ограниченных write-действий.
После 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 проверяет доступ к объектам через недокументированный фильтр _user_id и дальше подставляет этот фильтр автоматически для чтения и ограниченных write-действий.
Тарификация считает все активные VK Ads кабинеты, доступные ИИ: 1–4 кабинета по 990 ₽, с 5-го — MCP-пакет «Агентство».
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. Объектная статистика и realtime в таком manual режиме зависят от VK API и могут возвращать пустые или нулевые данные; тогда LidFly подставляет доступный агрегат кабинета через statistics/users и faststat/users. Для надёжной детализации по кампаниям, группам и объявлениям нужен official agency/manager API-доступ или отдельный VK OAuth клиента. В manual режиме можно менять max_price и статусы через mass-action, часть полей кампаний (budget_limit, budget_limit_day, даты, max_price) и название лид-формы. price групп, создание, загрузка креативов и single update объектов требуют official agency/manager API-доступ или отдельный VK OAuth клиента.
Для групп с автостратегией max_goals ставочный лимит меняется через max_price. Обычное поле price может дать успешный ответ API, но остаться прежним при проверочном чтении.
Добавлена диагностика статистики мини-приложений, включая сценарии Senler: агент отличает подписку в приложении от social_network.vk_subscribe, находит приложение, трекер, событие и сверяет результат с колонкой «Результат» в интерфейсе VK Ads.
vk_get_mobile_apps
vk_get_inapp_events
vk_get_inapp_stats
vk_get_statistics
priced_event_type=43
priced_goal: tracker.id + event.name