МануалИнтеграция

Несколько кабинетов Директа через управляющий доступ и client_login

У вас несколько клиентов в Яндекс Директе, но агентского договора с Яндексом нет. Соберите доступы под один Яндекс-логин, сохраните клиентские client_login в LidFly и платите по числу клиентов с потолком агентского пакета.

Ситуация, с которой приходят

Вы — performance-маркетолог на фрилансе или небольшая продакшн-студия. Ведёте 5, 8, а то и 15 клиентов в Яндекс Директе. У каждого свой отдельный кабинет со своим Яндекс-логином. Юридически вы не оформлены как рекламное агентство, агентского договора с Яндексом нет и не планируется.

Подключая lidfly.ru, возникает вопрос:

«Получается, мне надо покупать отдельный MCP-пакет на каждый кабинет? 5 клиентов × 990₽ = почти 5 000₽ за 30 дней. А если их 15 — уже под 15 000₽. Не слишком ли?»

Правильный ответ: не обязательно. В Яндекс Директе есть встроенный механизм управляющих аккаунтов и представителей, который позволяет собрать все клиентские кабинеты под один управляющий логин. В LidFly такой доступ оплачивается честно: 990₽ за каждого сохранённого клиента на 30 дней, но не дороже 4 990₽ за подключение — даже если клиентов 10, 20 или 50.

Коротко: для настоящего агентства список клиентов отдаёт get_agency_clients. Для управляющего или представительского доступа Яндекс API часто возвращает ошибку 54, хотя доступы в интерфейсе есть. В этом случае логины из блока «Доступные аккаунты» нужно один раз сохранить в LidFly, после чего ИИ будет подставлять их как client_login.

Что такое управляющий аккаунт в Яндексе

В Яндекс Директе владелец рекламного кабинета может подключить другой Яндекс-логин как управляющий аккаунт или представителя и выдать ему один из уровней доступа:

Для полноценной работы с lidfly.ru выбирайте Администрирование или Редактирование. Доступ на чтение подходит для аудита, отчётов и аналитики без write-действий.

Ключевой момент: для работы через LidFly один управляющий логин подключается один раз, а нужный клиентский кабинет выбирается через client_login. Эти логины видны в панели «Доступные аккаунты» в Яндекс Директ Про. Дальше ИИ делает операции в рамках прав, которые выдали этому управляющему аккаунту.

С точки зрения нашего сервиса это выглядит как работа агентства: один токен, много клиентских логинов, переключение через параметр client_login. Разница только в источнике списка: агентство получает его через API, а управляющий или представительский доступ нужно сохранить в LidFly вручную.

Экономика: когда это выгодно

При стандартном подключении вы покупаете MCP-пакет «Рекламодатель» за 990₽ на 30 дней для каждого подключённого кабинета. При схеме с управляющим аккаунтом цена считается так же по числу сохранённых клиентов, но с потолком 4 990₽ на 30 дней за подключение.

Кабинетов Отдельные подключения
(990₽ × N)
Управляющий доступ Что выгоднее
2 1 980₽ 1 980₽ Одинаково
3 2 970₽ 2 970₽ Одинаково
4 3 960₽ 3 960₽ Одинаково
5 4 950₽ 4 950₽ Одинаково
6 5 940₽ 4 990₽ Управляющий доступ (−950₽)
8 7 920₽ 4 990₽ Управляющий доступ (−2 930₽)
10 9 900₽ 4 990₽ Управляющий доступ (−4 910₽)
15 14 850₽ 4 990₽ Управляющий доступ (−9 860₽)

До 5 клиентов сумма совпадает с отдельными подключениями. С 6-го клиента срабатывает потолок 4 990₽: дальше цена не растёт, а управлять кабинетами удобнее через один управляющий логин и сохранённые client_login.

Пошаговая инструкция

Шаг 1. Выбрать управляющий логин

Это тот Яндекс-логин, через который вы будете заходить в lidfly.ru и работать со всеми клиентами разом. Есть два варианта:

  1. Использовать один из существующих — например, ваш рабочий Яндекс-логин. Проще.
  2. Создать отдельный технический логин — например, marketing-main@yandex.ru. Чище и безопаснее.

Рекомендую второй вариант. Отдельный технический логин:

Шаг 2. Добавить управляющий аккаунт в каждый клиентский кабинет

Это самая трудозатратная часть — нужно один раз пройтись по каждому клиентскому кабинету. Повторяем для каждого:

  1. Залогиниться в direct.yandex.ru под логином клиентского кабинета или под главным логином этого рекламодателя
  2. В меню слева открыть ИнструментыВаши представители
  3. Перейти в раздел Управляющие аккаунты
  4. Нажать Добавить управляющий аккаунт
  5. В поле «Логин Яндекса» ввести управляющий логин (без @yandex.ru)
  6. Выбрать доступ Администрирование, Редактирование или Чтение
  7. Нажать «Добавить»

Владельцу управляющего логина придёт уведомление о назначении. Его нужно принять — после этого аккаунт появится в списке доступных.

Шаг 3. Подтвердить доступ из управляющего логина

  1. Залогиниться в direct.yandex.ru под управляющим логином
  2. Открыть уведомление о назначении управляющим аккаунтом
  3. Принять доступ и проверить список «Доступные аккаунты»
  4. Если есть приглашения с пометкой «Ожидает подтверждения» — принять каждое

После этого в «Доступных аккаунтах» отображается полный список клиентов. Именно эти логины нужно сохранить в LidFly и использовать как client_login при работе в чате (например, pure-home1, track-199, lotosflowers74).

Шаг 4. Подключить lidfly.ru

Делаем одно подключение — через управляющий логин:

  1. Зайти на lidfly.ru/app, зарегистрироваться или войти
  2. Привязать Яндекс OAuth — важно: выбирать управляющий логин, не клиентский
  3. В разделе Яндекс Директ → «Доступные аккаунты» добавить логин каждого клиента. Цена следующей явной покупки MCP-доступа считается по числу сохранённых клиентов с потолком 4 990₽, но сам MCP-пакет покупается отдельно кнопкой в блоке «Баланс и MCP-доступ»
  4. Скопировать API-ключ из раздела «Подключение»
  5. В файле .mcp.json (или в настройках вашего MCP-клиента — Claude Code, Claude Desktop, Cursor, Cline, Cherry Studio) прописать один сервер:
.mcp.json
{ "mcpServers": { "yandex-direct": { "url": "https://lidfly.ru/mcp", "headers": { "Authorization": "Bearer ВАШ_API_КЛЮЧ" } } } }

Всё. Один сервер, один ключ, один OAuth-токен — дальше нужно только сохранить клиентские логины.

Шаг 5. Сохранить client_login клиентов в LidFly

Важно: этот шаг нужен только для управляющих аккаунтов и представительского доступа, где клиенты видны в «Доступных аккаунтах». Для настоящих агентских аккаунтов вручную сохранять client_login не нужно: список клиентов сразу доступен в LidFly через агентский API.
  1. В личном кабинете LidFly откройте раздел Яндекс Директ
  2. В блоке «Кабинеты Директа» добавьте каждый логин из «Доступных аккаунтов» Яндекс Директ Про
  3. Для названия укажите понятное имя клиента: бренд, ИП или проект
  4. LidFly проверит доступ через Direct API и сохранит только рабочие логины

Основной подключённый логин сохранять не нужно: он уже доступен без client_login. Если клиент в списке Яндекса имеет роль «Читатель», аналитика и отчёты будут работать, но write-действия могут быть запрещены правами Яндекса.

Шаг 6. Работать через client_login в чате

В диалоге с ИИ просто называйте логин клиента прямо в вопросе. Агент сам передаст его в параметр client_login при вызове нужного инструмента:

Промпт
Покажи кампании клиента pure-home1 за последнюю неделю

→ ИИ вызовет get_campaigns(client_login="pure-home1"), затем get_campaign_stats по тем же ID.

Промпт
Сделай аудит кампаний у track-199, найди кампании с остановленным обучением стратегий

agency_campaign_audit(client_login="track-199"), потом get_strategy_learning_status(client_login="track-199").

Промпт
Добавь минус-слово «бесплатно» в группу 12345 у клиента lotosflowers74

→ соответствующий вызов update_keywords с client_login="lotosflowers74".

Если где-то забыли, как клиент записан в Яндексе — загляните в раздел «Доступные аккаунты» в Директ Про или в сохранённый список «Кабинеты Директа» в LidFly.

Обратите внимание: инструмент get_agency_clients в этой схеме может возвращать пояснительную ошибку 54. Это нормально — Яндекс API не отдаёт список представительских «Доступных аккаунтов» так же, как список клиентов настоящего агентства. Сохранённые в LidFly логины закрывают этот пробел: обычные инструменты Директа и агентские сводки используют их как client_login.

Важные ограничения

Управляющий аккаунт — это не полная владельческая учётка. Некоторые вещи остаются в зоне владельца клиентского кабинета:

Большинство задач performance-маркетолога доступны полностью: создавать и изменять кампании, подбирать ключевые фразы, крутить ставки, отключать слабые группы, смотреть статистику, запускать аудиты, проверять обучение стратегий, работать с Reports API.

Безопасность — критично. Блокировка управляющего логина = потеря доступа ко всем клиентам одновременно. Поэтому:

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

Альтернативы

2–4 клиента — оставайтесь в пакете «Рекламодатель»

Если у вас 2–4 клиента — схема с управляющим аккаунтом не окупается. Проще подключить Яндекс-логин каждого клиента отдельным подключением в одном кабинете LidFly:

  1. В разделе Яндекс Директ нажать «Подключить аккаунт Яндекса» и пройти OAuth под логином клиента (или взять у клиента токен и добавить его вручную — как договоритесь)
  2. Повторить для каждого клиента. Отдельные регистрации на lidfly.ru и отдельные API-ключи не нужны

В .mcp.json при этом остаётся один сервер с одним ключом:

.mcp.json — один сервер на все подключения
{ "mcpServers": { "yandex-direct": { "url": "https://lidfly.ru/mcp", "headers": { "Authorization": "Bearer ВАШ_API_КЛЮЧ" } } } }

Между кабинетами ИИ переключается сам: назовите логин клиента в чате — агент передаст его как client_login, и LidFly подставит токен нужного подключения. Без логина запрос уходит в подключение, отмеченное основным. Если один логин сохранён сразу в нескольких подключениях, агент уточнит выбор через connection_id.

Стоимость — 990₽ за 30 дней за каждое подключение обычного рекламодателя. Режим «Агентство» от количества отдельных подключений не включается: он нужен только агентским токенам и схеме с управляющим аккаунтом из этой статьи. В Яндексе ничего настраивать не нужно, и у каждого клиента остаётся свой изолированный токен.

Настоящее агентство с агентским договором

Если вы юридически оформленное агентство с договором с Яндексом (клиенты созданы в вашем агентском кабинете, логины вида porg-...) — подключайтесь напрямую по агентскому пути:

Разница со схемой управляющего аккаунта чисто юридическая: в настоящем агентстве вы взаимодействуете с Яндексом от имени клиента, можете пополнять баланс с агентского счёта, брать комиссию, выставлять единые счета. В управляющем сценарии финансовые отношения клиент ведёт с Яндексом напрямую.

Итого

Если у вас несколько кабинетов Яндекс Директа под управлением — схема «управляющий аккаунт + сохранённые client_login» начинает экономить деньги и упрощает работу:

Настройка — 5–10 минут на кабинет, один раз. Потом всё управление происходит через чат с фразами вроде «создай кампанию для клиента X» или «покажи статистику клиента Y за вчера».

Главное — используйте отдельный технический логин как управляющий, включите 2FA и не раздавайте его никому лишнему. Доступ управляющего аккаунта — это ключ ко всем клиентским кабинетам одновременно, и относиться к нему надо соответственно.

Попробовать схему

Зарегистрируйтесь, привяжите управляющий Яндекс-логин и добавьте клиентские кабинеты. Аккаунт перейдёт в режим «Агентство», а после триала вы сами решите, когда пополнить баланс и включить MCP-пакет на 30 дней.

Получить API-ключ