Перейти к содержимому
100CTR

Автоматизация

Как подключить Claude к Яндекс Директу

Пошаговое подключение Claude Code и Claude Desktop к Яндекс Директу через MCP-сервер 100CTR: команда, конфигурация, права ключа и безопасность.

Работает в кабинете 100CTRЕсть бесплатный тариф

На входе
Аккаунт 100CTR, подключённый кабинет Директа, Claude Code или Claude Desktop
На выходе
Claude видит кампании, статистику и поисковые запросы и вносит правки по вашей команде
Для чего
Разбирать статистику и готовить изменения в Директе в диалоге с Claude

Работает в кабинете 100CTR

Инструмент использует сервер 100CTR, поэтому запускается из личного кабинета. Регистрация бесплатная и занимает минуту — нужен только e-mail.

Как подключить Claude к Яндекс Директу

Claude умеет работать с внешними сервисами через MCP-серверы. Чтобы он видел ваши кампании в Яндекс Директе, ему нужен сервер с инструментами Директа и доступ к рекламному кабинету. 100CTR даёт и то, и другое: облачный MCP-сервер по адресу https://mcp.100ctr.com/mcp и подключение кабинета Директа в одну кнопку.

На этой странице — пошаговая настройка для Claude Code (терминал и IDE) и Claude Desktop. После неё вы сможете попросить Claude разобрать статистику кампаний, найти нецелевые поисковые запросы, собрать минус-фразы, проверить ставки или подготовить комбинаторные объявления для группы — а изменения Claude будет вносить только с вашего разрешения и в рамках прав API-ключа.

Как пользоваться

  1. Зарегистрируйтесь в 100CTR

    Бесплатного аккаунта достаточно. Откройте раздел «Интеграции и API».

  2. Подключите Яндекс Директ

    Нажмите «Подключить Яндекс Директ» и подтвердите доступ на странице Яндекса. Агентству нужно выбрать клиента; для организации в Яндекс ID сначала переключитесь в неё в аккаунте Яндекса.

  3. Создайте API-ключ

    Отметьте нужные права. Для первого знакомства хватит «Чтения» и «Отчётов». Скопируйте ключ — он показывается один раз.

  4. Добавьте сервер в Claude Code

    Выполните в терминале claude mcp add --transport http 100ctr https://mcp.100ctr.com/mcp --header "Authorization: Bearer <ключ>". Флаг --scope user сделает сервер доступным во всех проектах.

  5. Или в Claude Desktop

    Добавьте в claude_desktop_config.json сервер, который запускает мост npx -y mcp-remote с адресом и заголовком авторизации (готовый блок — ниже), и перезапустите приложение.

  6. Проверьте

    В Claude Code выполните /mcp — сервер 100ctr должен быть подключён. Затем попросите: «Покажи мои кампании в Директе».

Примеры

Claude Code: команда и проектный файл .mcp.json

Исходные данные

claude mcp add --transport http 100ctr \
  https://mcp.100ctr.com/mcp \
  --header "Authorization: Bearer $CTR100_API_KEY" \
  --scope user

Результат

{
  "mcpServers": {
    "100ctr": {
      "type": "http",
      "url": "https://mcp.100ctr.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CTR100_API_KEY}"
      }
    }
  }
}

Команда сохраняет сервер в настройках пользователя. Вариант с файлом .mcp.json удобен для команды: ключ подставляется из переменной окружения CTR100_API_KEY и не попадает в репозиторий.

Claude Desktop: claude_desktop_config.json

Исходные данные

Настройки → Разработчик → Изменить конфигурацию
(файл claude_desktop_config.json)

Результат

{
  "mcpServers": {
    "100ctr": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://mcp.100ctr.com/mcp",
        "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer <ключ>" }
    }
  }
}

Нужен установленный Node.js. Мост mcp-remote запускается локально и передаёт запросы на сервер 100CTR с вашим ключом. Значение заголовка вынесено в переменную без пробела после двоеточия — так конфигурация одинаково работает в Windows и macOS.

Что Claude сможет делать в Директе

  • Показывать кампании, группы, объявления, ключевые фразы и ставки — в том числе заголовки и тексты комбинаторных объявлений.
  • Строить отчёты: расход, клики, CTR и конверсии за период, отчёт по поисковым запросам.
  • Находить нецелевые запросы и предлагать минус-фразы; добавлять их, если у ключа есть право «Изменение кампаний».
  • Останавливать и запускать кампании, менять ставки и дневной бюджет — с правами «Изменение кампаний» и «Бюджеты и ставки».
  • Готовить и проверять объявления на ограничения Директа и создавать комбинаторные объявления в группе.
  • Собирать частотность WordStat и прогноз показов — с правом «WordStat и прогноз».

Как не дать Claude лишнего

Права задаются на уровне API-ключа, а не промпта. Если ключ создан только с правами на чтение и отчёты, инструменты изменения кампаний даже не попадут в список, который видит Claude. Для работы с изменениями заведите отдельный ключ и используйте его там, где готовы подтверждать действия.

У изменяющих инструментов есть пробный режим dryRun: Claude отправляет вызов, сервер проверяет аргументы и права и возвращает предпросмотр, но в Директ ничего не уходит. Попросите Claude всегда начинать с пробного прогона и показывать итог перед реальным изменением. Claude Code к тому же по умолчанию спрашивает подтверждение перед вызовом инструментов.

Агентства и несколько клиентов

Для агентского аккаунта выберите клиента по умолчанию в разделе «Интеграции и API» — запросы пойдут с заголовком Client-Login. Чтобы обратиться к другому клиенту, достаточно назвать его логин в запросе: Claude передаст его в параметре clientLogin. Список клиентов агентства Claude получает инструментом yd_list_clients.

Claude.ai в браузере

Веб-версия Claude подключает удалённые серверы как коннекторы с авторизацией через OAuth. Сервер 100CTR авторизует запросы по API-ключу в заголовке, поэтому для работы с Директом используйте Claude Code или Claude Desktop с мостом mcp-remote.

Если что-то не работает

  • Ошибка 401 — ключ скопирован не полностью, отозван или в заголовке нет слова Bearer.
  • Нет инструментов Директа — кабинет не подключён в 100CTR или у ключа нет прав «Чтение».
  • Кампании пустые — выберите клиента агентства или переподключите кабинет, переключившись в нужную организацию Яндекса.
  • Сервер не стартует в Claude Desktop — проверьте, что установлен Node.js и команда npx доступна.

Частые вопросы

Какой план Claude нужен?

Подойдёт любой, в котором доступны Claude Code или Claude Desktop с MCP-серверами. Со стороны 100CTR для чтения статистики хватит бесплатного тарифа (до 100 вызовов MCP в сутки); чтобы ассистент менял кампании и ставки, нужен Pro.

Где хранить API-ключ?

В переменной окружения (например, CTR100_API_KEY) или менеджере паролей. Не коммитьте ключ в git: в .mcp.json используйте подстановку ${CTR100_API_KEY}.

Можно ли подключить и Директ, и VK Рекламу?

Да, через тот же сервер. Подключите оба кабинета в 100CTR — Claude увидит инструменты обеих платформ.

Claude сам опубликует объявления?

Только если у ключа есть право «Изменение кампаний» и вы это разрешили. Генерация объявлений 100CTR сама по себе ничего не публикует — она возвращает черновики.

Сколько стоят запросы?

Работа с кампаниями расходует баллы API Директа вашего аккаунта. Генерация объявлений и WordStat — месячные лимиты тарифа 100CTR.

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

Отзовите ключ в разделе «Интеграции и API» или отключите кабинет Директа — доступ прекратится сразу.

Похожие инструменты

Соберите всю кампанию за один проход

В проекте 100CTR фразы группируются автоматически, в каждую группу пишутся объявления с подстановкой ключа, а результат выгружается файлом для Директ Коммандера.

Как это работает