LidFly для Codex

Подключите LidFly к Codex за несколько минут

Codex сможет работать с вашей рекламой, аналитикой, сайтами и Проектами LidFly. API-ключи копировать не нужно.

Выберите, что вам ближе

Скачайте приложение LidFly

Оно само подготовит плагин и установит его в Codex — дальше всего три шага.

Важно для Windows

В версии 1.0.0 нет системной подписи Windows. SmartScreen может показать «Неизвестный издатель». Продолжайте, только если файл скачан с lidfly.ru.

Проверяем доступность файлов…

Любите командную строку? Установить через «терминал»

Видео

Посмотрите, как установить — за пару минут

Открыть видео на YouTube

После скачивания

Три шага до первого запроса

  1. Подготовьте плагин

    Откройте приложение LidFly и нажмите «Подготовить плагин». Это ещё не установка в Codex: приложение только подготовит подключение и проверит, что всё готово.

  2. Подтвердите установку в Codex

    Нажмите «Открыть в Codex», затем в карточке LidFly нажмите Install.

  3. Войдите в LidFly

    Введите email, подтвердите код, полностью перезапустите Codex и начните новый чат.

Готово. Установщик можно закрыть. Теперь вся работа происходит в Codex.

Кнопка откроет новый чат и подготовит безопасный запрос «Проверь статус моей подписки LidFly». Запрос не отправится автоматически — вы сможете проверить его перед отправкой.

Открыть новый чат в Codex

Что написать в Codex

  • «Покажи доступные аккаунты и проекты»
  • «Покажи мои кампании в Яндекс Директе»
  • «Проанализируй статистику за последние 30 дней. Пока ничего не меняй»
  • «Подготовь изменения, но применяй их только после моего подтверждения»
  • «Для базы знаний используй $lidfly-knowledge-maintainer: выполни ingest источника и атомарно обнови knowledge-base»

Где теперь работать

  • Отдельного рабочего интерфейса плагина нет. Все дальнейшие запросы пишутся в Codex.
  • Установщик нужен только для подготовки, проверки, восстановления и удаления подключения.
  • Codex получает только доступные вам аккаунты и проекты.
  • Проверяйте подготовленные изменения перед подтверждением.

Для Codex CLI и Linux

Установка через «терминал»

Выполните команды по очереди:

Terminal
codex plugin marketplace add awaik/lidfly-plugins
codex plugin add lidfly@lidfly

После установки пройдите вход в Codex, полностью перезапустите клиент и откройте новый чат.

Другие способы установки

Ручное подключение MCP

В Codex откройте Settings → Integrations & MCP, нажмите Add custom MCP server и укажите https://lidfly.ru/mcp/v3. Если Codex просит resource, укажите https://lidfly.ru.

Либо создайте .codex/config.toml в корне проекта:

.codex/config.toml
[mcp_servers.lidfly]
url = "https://lidfly.ru/mcp/v3"
startup_timeout_sec = 45
tool_timeout_sec = 120

Нажмите Login / Authenticate для сервера lidfly или выполните codex mcp login lidfly. Команда codex mcp list покажет активную конфигурацию.

Готовый проектный набор Codex: скачать ZIP. В архиве только AGENTS.md, конфигурация Codex и Codex skills.

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

Сначала завершите вход

Если сервер показывает Failed и доступна кнопка Login или Authenticate, нажмите её, завершите браузерный вход и повторите проверку. До этого не меняйте конфиг и не проверяйте рекламные кабинеты.

Codex часто просит войти снова

Поддерживается Codex 0.149 или новее. Сначала обновите все варианты Codex на компьютере и полностью закройте все старые процессы Codex — CLI, приложение и расширение VS Code. Старый процесс может снова сохранить несовместимую запись авторизации.

Только после полного закрытия выполните команды по очереди:

Terminal
codex --version
codex mcp logout lidfly
codex mcp login lidfly
codex mcp list

Затем войдите в LidFly один раз. После истечения короткого access token Codex должен обновлять доступ автоматически, без нового входа в браузере.

Windows: после перезапуска Codex не видит LidFly

Если вчера LidFly работал, а теперь Codex пишет, что инструменты недоступны в текущем сеансе, Codex на Windows не прочитал сохранённый вход (известная ошибка Codex). Полностью закройте Codex и VS Code, откройте файл C:\Users\<имя>\.codex\config.toml (не файл в папке проекта) и добавьте первой строкой:

config.toml
mcp_oauth_credentials_store = "file"

Затем войдите в LidFly заново и проверьте подключение:

Terminal
codex mcp logout lidfly
codex mcp login lidfly
codex mcp list

Windows SmartScreen

Если видите «Неизвестный издатель», продолжайте только для файла, скачанного с lidfly.ru. В версии 1.0.0 системной подписи Windows нет.

macOS Gatekeeper

Если macOS заблокировала запуск, откройте «Системные настройки» → «Конфиденциальность и безопасность» и разрешите запуск скачанного приложения LidFly.

Codex не установлен

Сначала установите и запустите приложение Codex, затем вернитесь к шагу «Подготовьте плагин».

codex:// не открылся

Откройте Codex вручную и создайте новый чат. Запрос можно скопировать из примеров выше.

Корпоративная политика

Если организация запрещает персональные marketplaces, обратитесь к администратору или используйте разрешённое ручное подключение.

Старое подключение дублируется

После успешной проверки плагина отключите прежнюю ручную запись MCP, чтобы один сервер не показывался дважды.

Проверка и восстановление

В приложении установщика используйте Verify для проверки, Repair для восстановления и Remove для удаления.

Два способа авторизации: агенты подключаются к https://lidfly.ru/mcp/v3 через OAuth по email или API-ключ аккаунта в заголовке Authorization: Bearer <account_key>, если клиент позволяет задавать заголовок. Ключ доступен в личном кабинете: Настройки → API-ключ → «Скопировать ключ». Для одного подключения выберите один способ: статический Authorization может перекрыть OAuth-токен. Не публикуйте ключ и не отправляйте его в чат.