Подключение · 10 минут

Ваш Директ внутри ChatGPT, Claude и Codex.

Три шага. Личный ключ вместо возни с настройками: скопировали строку — вставили — работает.

Шаг 1 · обязательный

Подключите кабинет Яндекс Директа

Это делается у нас, а не в ассистенте. Ключ из шага 2 даёт агенту доступ к тем кабинетам, которые вы подключили здесь — без них ему не с чем работать.

✓
Кабинет → «Подключить Яндекс Директ».
✓
Яндекс спросит разрешение и покажет код — вставьте его у нас. Код вместо возврата на сайт требует сам Яндекс для приложений с доступом к API Директа.
✓
Кампании остаются на вашем аккаунте, токен хранится зашифрованным и агенту не передаётся.
✓
Кабинетов может быть несколько — повторите для каждого.

Шаг 2

Возьмите личный ключ

Кабинет → ИИ-ассистент → «Создать ключ». Получится строка вида mcp-xxxxxxxx. Один ключ на все ваши кабинеты, отзывается там же в один клик.

Ключ — это пароль от вашей рекламы. Не публикуйте его и не вставляйте в чат — только в настройки агента.

Шаг 3

Вставьте готовую строку

Везде одно и то же: адрес https://kontekstolog.online/mcp и заголовок Authorization: Bearer ваш-ключ. В кабинете блоки уже с подставленным ключом — копируйте оттуда.

Codex — файл ~/.codex/config.toml

[mcp_servers.kontekstolog]
enabled = true
url = "https://kontekstolog.online/mcp"

[mcp_servers.kontekstolog.http_headers]
Authorization = "Bearer ваш-ключ"

Сохранить → перезапустить codex.

Codex, приложение — поля в настройках

✓
Настройки → Plugins → вкладка MCPs → Add.
✓
Name: kontekstolog · Type: Streamable HTTP
✓
URL: https://kontekstolog.online/mcp
✓
Header: Authorization → Bearer ваш-ключ
✓
Save и включить тумблер в списке Servers.

Claude Code — одна команда

claude mcp add --transport http kontekstolog https://kontekstolog.online/mcp --header "Authorization: Bearer ваш-ключ"

Проверить: /mcp в чате.

Cursor, VS Code, Windsurf — mcp.json

{
  "mcpServers": {
    "kontekstolog": {
      "url": "https://kontekstolog.online/mcp",
      "headers": { "Authorization": "Bearer ваш-ключ" }
    }
  }
}

Claude на сайте и в приложении

Здесь ключ не нужен — вход через браузер:

Аватар → Settings → Connectors → Add custom connector.
Name: kontekstolog · URL: https://kontekstolog.online/mcp.
Client ID и Secret оставьте пустыми → Add → Connect.
Откроется Контекстолог → Разрешить.

ChatGPT на сайте

Настройки → Connectors. Если раздела нет — включите режим разработчика; на бесплатном тарифе своих коннекторов нет.
Create → Name: kontekstolog · MCP Server URL: https://kontekstolog.online/mcp · Authentication: OAuth.
Connect → войдите в Контекстолог → Разрешить.
В чате включите коннектор кнопкой +.

Бонус

Навык: агент сам знает, как вести рекламу

Короткий файл с правилами — с чего начинать, что чем делать, где Директ капризничает. Ставится одной командой:

mkdir -p ~/.claude/skills/kontekstolog && curl -s https://kontekstolog.online/skill.md -o ~/.claude/skills/kontekstolog/SKILL.md

Для Codex положите тот же файл в его папку навыков. Посмотреть текст: https://kontekstolog.online/skill.md.

Проверка

Первая фраза

Покажи мои рекламные аккаунты

Агент перечислит кабинеты: номер, логин Яндекса, режим и цель Метрики. Дальше можно словами: «где сливается бюджет», «поставь на паузу всё без заявок за 14 дней», «собери кампанию по этой ссылке».

Если не получилось

Частые причины

Что видите	Что делать
401 или «нет доступа»	Ключ скопирован не целиком или отозван — возьмите новый в разделе «ИИ-ассистент».
«Аккаунт Яндекса не подключён»	Шаг 1: кабинет Директа подключается у нас, а не в агенте.
Агент не видит инструменты	Перезапустите приложение — конфиг читается при старте.
«Подписка не активна»	Проверьте тариф на странице «Тариф и оплата».
«Только чтение для ИИ»	Режим включён вами в настройках кабинета — снимите галочку.
Правит не тот кабинет	Называйте номер: «в аккаунте 7…».

Подробнее о коннекторе — MCP для Директа и Метрики, вопросы — справка.