Гайд14 мин чтения

Codex + Ornold MCP: гайд по настройке автоматизации

Подключение Codex CLI и десктоп-приложения к Ornold MCP. Настройка config.toml и AI-автоматизация антидетект-браузеров.

17 апр. 2026 г.

Что вы получите в итоге

К концу этого руководства OpenAI Codex — как CLI, так и десктопное приложение — будет управлять реальными сессиями антидетект-браузера через Ornold MCP. Открывать страницы, заполнять формы, решать CAPTCHA и управлять несколькими профилями — всё через естественный язык. Никаких скриптов, никаких селекторов.

Это руководство охватывает Codex CLI (macOS, Windows, Linux) и десктопное приложение Codex (macOS Apple Silicon). Codex Cloud (веб-версия ChatGPT) использует другой процесс и не требует MCP — в этом руководстве он не рассматривается.

Codex CLI vs Codex App vs Codex Cloud

OpenAI предлагает Codex в трёх форматах. Вот какой нужен вам:

Codex CLI — Агент в терминале. Запускается локально командой `codex`. Поддерживает MCP через config.toml. Работает на macOS, Windows и Linux.
Codex App — Десктопное приложение для macOS (Apple Silicon). Визуальный интерфейс с той же поддержкой MCP, что и в CLI.
Codex Cloud — Браузерный агент внутри ChatGPT. Подключается напрямую к GitHub-репозиториям. НЕ использует MCP — задачи выполняются в облачной песочнице OpenAI.

Это руководство охватывает CLI и App. Оба подключаются к Ornold MCP одинаково — через config.toml.

Требования

Компьютер с macOS 12+, Windows 10/11 или Linux
API-ключ OpenAI или подписка ChatGPT Plus/Pro/Team
Установленный антидетект-браузер: Linken Sphere, Dolphin Anty, Wadex или Vision Browser
Установленный Node.js 20+ (см. Шаг 1)

Шаг 1 — Установка Node.js

Ornold MCP работает как Node.js-пакет. Необходима версия Node.js 20 или выше.

macOS

Проще всего использовать Homebrew:

brew install node@22

Windows

Скачайте LTS-установщик с nodejs.org (22.x). Запустите его и убедитесь, что отмечен пункт «Add to PATH».

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Or use nvm
nvm install 22

Проверьте установку:

node --version   # v22.x.x or higher
npm --version    # 10.x.x or higher

Terminal showing node --version output v22

Подтвердите корректную установку Node.js

Шаг 2 — Установка Codex

Вариант A: Codex CLI

Установите Codex CLI глобально через npm:

npm install -g codex

Запустите для проверки и аутентификации:

codex
# Sign in with your OpenAI API key when prompted

Вместо интерактивного входа можно задать переменную окружения OPENAI_API_KEY.

🖼️

Codex CLI запущен в терминале

Вариант B: Десктопное приложение Codex

Скачайте приложение Codex с openai.com/codex (только macOS Apple Silicon). Установите его, откройте и войдите с помощью аккаунта ChatGPT или API-ключа OpenAI. При запросе выберите папку проекта.

Приложение Codex читает тот же config.toml, что и CLI, поэтому настройка MCP одинакова для обоих.

Шаг 3 — Создание аккаунта Ornold

Ornold — это мост между AI-агентами и антидетект-браузерами.

Перейдите на mcp.ornold.com
Нажмите «Регистрация» и создайте аккаунт с вашим email
Подтвердите email 6-значным кодом
Вы окажетесь на дашборде

Ornold MCP registration page with email and password fields

Создайте аккаунт Ornold на [mcp.ornold.com](https://mcp.ornold.com)

Шаг 4 — Создание API-токена

В дашборде создайте ваш первый API-токен:

Введите имя токена (например, «Codex»)
Нажмите «Создать»
Скопируйте токен — он понадобится на следующем шаге

Ornold dashboard showing token creation modal with copy button

Создайте и скопируйте ваш API-токен

Бесплатные аккаунты получают 1 слот, 5 решений CAPTCHA (после прохождения обзора дашборда) и доступ к стандартным браузерам.

Шаг 5 — Генерация MCP-конфига через мастер в дашборде

В дашборде Ornold есть встроенный мастер подключения, который генерирует точный MCP-конфиг для вашей конфигурации. Никакого ручного составления команд — просто выберите параметры и скопируйте результат.

Перейдите на вкладку API Tokens в дашборде. Найдите ваш токен и нажмите кнопку «Connect» рядом с ним.

Ornold dashboard API Tokens page with Connect button highlighted next to a token

Нажмите «Connect» на вашем токене, чтобы открыть мастер

Мастер, Шаг 1 — Выберите AI-агент

Мастер спрашивает, какой AI-агент вы используете. Выберите «Codex» из списка. Мастер сгенерирует конфиг в формате TOML (config.toml) вместо JSON. Другие поддерживаемые агенты: Claude Code, Cursor, VS Code, Windsurf и Cline.

🖼️

Шаг 1: Выберите Codex в качестве AI-агента

Мастер, Шаг 2 — Выберите режим взаимодействия

Выберите, как AI должен взаимодействовать со страницами браузера:

DOM mode (по умолчанию) — AI читает HTML-структуру страницы. Каждый элемент получает маркер [ref=N]. Бесплатно и быстро. Лучший выбор для форм, структурированных страниц и стандартных сайтов.
Vision AI mode — AI делает скриншот и визуально находит элементы по их внешнему виду. Работает на любой странице, даже с canvas-интерфейсами. Каждый анализ стоит 1 vision-кредит.
Оба режима — Доступны все инструменты. AI автоматически выбирает наилучший подход для каждого действия.

Начните с DOM mode. Он бесплатный, быстрый и покрывает 90% сценариев. Всегда можно переключиться на «Оба» позже, если понадобится визуальный анализ.

Connect wizard step 2 showing three interaction mode options: DOM, Vision AI, Both

Шаг 2: Выберите DOM mode для большинства задач

Мастер, Шаг 3 — Включите антидетект-браузеры

Включите нужные браузеры и заполните данные подключения:

Linken Sphere — Укажите API-порт (по умолчанию: 40080). Убедитесь, что Sphere запущен.
Dolphin Anty — Укажите локальный порт (по умолчанию: 3001) и вставьте API-токен Dolphin из Настройки → API.
Wadex — Укажите API-порт (по умолчанию: 8080).
Vision Browser — Вставьте X-Token. Опционально укажите локальный порт.

Можно включить несколько браузеров одновременно. MCP-конфиг будет включать все из них, и AI-агент сможет управлять любым из запущенных.

Connect wizard step 3 showing browser toggles with Linken Sphere enabled and port field filled in

Шаг 3: Включите антидетект-браузеры и заполните порты

Мастер, Шаг 4 — Скопируйте конфиг

Мастер генерирует финальный конфиг на основе ваших выборов. Для Codex вы получаете готовый к вставке TOML-блок для config.toml. Нажмите «Copy», чтобы скопировать его.

🖼️

Шаг 4: Скопируйте сгенерированный TOML-конфиг

Мастер предварительно заполняет ваш реальный токен и значения портов — просто нажмите «Copy» и вставьте в config.toml. Ручное редактирование не нужно.

Шаг 6 — Добавление Ornold MCP в Codex

Есть два способа добавить MCP-сервер — через GUI приложения Codex App или вручную отредактировав config.toml. Оба метода дают одинаковый результат.

Вариант A: Через интерфейс приложения Codex App (рекомендуется)

Если вы используете десктопное приложение Codex, MCP-серверы можно добавить прямо из настроек UI — без редактирования файлов.

Откройте приложение Codex и нажмите иконку шестерёнки (⚙️) в правом верхнем углу
Перейдите в раздел Integrations & MCP
Нажмите «Add Server» или «Add Custom Server»

🖼️

Откройте Settings → Integrations & MCP в приложении Codex

В форме настройки сервера заполните:

Server name: ornold-browser
Transport: stdio
Command: npx
Arguments: ornold-mcp --token YOUR_TOKEN --linken-port 40080 (скорректируйте под ваш браузер)

🖼️

Заполните данные MCP-сервера — имя, команду и аргументы

Нажмите «Save» или «Add». Ornold MCP-сервер появится в списке серверов. Codex загрузит его автоматически при следующей сессии.

🖼️

Ornold MCP-сервер добавлен и готов в приложении Codex

Настройки хранятся в config.toml под капотом, поэтому они автоматически синхронизируются между Codex App, CLI и расширением IDE.

Вариант B: Ручное редактирование config.toml (для CLI)

Если вы предпочитаете CLI или хотите настроить Codex на сервере без GUI, отредактируйте файл конфигурации напрямую:

# macOS / Linux
~/.codex/config.toml

# Windows
%USERPROFILE%\.codex\config.toml

Вставьте блок MCP-сервера из мастера. Вот как он выглядит для Linken Sphere:

# ~/.codex/config.toml

[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]

Для Dolphin Anty аргументы включают Dolphin-токен:

[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]

Для нескольких браузеров одновременно:

[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--dolphin-port", "3001", "--dolphin-token", "DOLPHIN_KEY", "--wadex-port", "8080"]

Вариант C: Однострочная команда CLI

Сервер также можно добавить одной командой в терминале:

codex mcp add ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

Все три метода записывают в один и тот же config.toml. Выберите тот, который удобнее — результат одинаковый.

Шаг 7 — Запустите браузер и Codex

Убедитесь, что ваш антидетект-браузер запущен, затем запустите Codex:

CLI

codex

Десктопное приложение

Откройте приложение Codex. Выберите режим «Local». MCP-серверы из config.toml загрузятся автоматически.

Codex обнаружит Ornold MCP-сервер и покажет доступные инструменты для браузера. Теперь можно общаться с ним:

# Start a Linken Sphere session
> Start a new Linken Sphere session and open google.com

# Fill a form
> Navigate to example.com/signup, fill email "test@mail.com" and password "Pass123", click Sign Up

# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it

# Multi-session
> Start 3 Linken Sphere sessions and open google.com in all of them

# Visual analysis
> Take a screenshot and describe what you see on the page

🖼️

Codex управляет Linken Sphere через Ornold MCP

Доступные MCP-инструменты

После подключения Codex получает доступ к 40+ инструментам автоматизации браузера:

linken_start_instances / dolphin_start_profiles — Запуск сессий браузера
browser_parallel_navigate — Открытие URL во всех активных браузерах
browser_parallel_snapshot — Получение DOM страницы с кликабельными маркерами [ref=N]
browser_parallel_click — Клик по элементам по ref или селектору
browser_parallel_fill — Ввод текста в поля формы
browser_parallel_screenshot — Снимки экрана всех сессий
browser_parallel_vision_analyze_grouped — Визуальный анализ страницы с помощью AI
browser_solve_captcha — Автоматическое решение reCAPTCHA, hCaptcha, Turnstile и других
browser_parallel_evaluate — Запуск JavaScript в контексте страницы
linken_stop_instances / dolphin_stop_profiles — Закрытие сессий

Не нужно запоминать названия инструментов. Просто опишите, что хотите сделать, на обычном языке — Codex автоматически выберет нужные инструменты.

Политика подтверждения инструментов

Codex имеет три режима подтверждения, управляющих запуском инструментов:

«untrusted» — Codex запрашивает разрешение перед каждым вызовом инструмента (самый безопасный, по умолчанию)
«on-request» — Codex спрашивает только для деструктивных или неизвестных инструментов
«never» — Codex запускает все инструменты без подтверждения (самый быстрый, используйте с осторожностью)

Задайте значение по умолчанию в config.toml:

# ~/.codex/config.toml
approval_policy = "on-request"

Или переопределите для конкретных инструментов Ornold:

[mcp_servers.ornold-browser.tools.browser_parallel_navigate]
approval_mode = "approve"

[mcp_servers.ornold-browser.tools.browser_solve_captcha]
approval_mode = "approve"

Устранение неполадок

«npx: command not found» — Node.js не добавлен в PATH. Перезапустите терминал после установки.
«MCP handshake failed» в десктоп-приложении Codex — Десктоп-приложение не наследует PATH из терминала (пути nvm/fnm отсутствуют). Решение: выполните `which npx` в терминале, затем укажите полный путь в config.toml: `command = "/Users/you/.nvm/versions/node/v22.x.x/bin/npx"` вместо просто `"npx"`.
«codex: command not found» — Запустите `npm install -g codex` ещё раз. На macOS может потребоваться `sudo`.
«Cannot connect to Linken Sphere» — Убедитесь, что Sphere запущен и API-порт указан верно (по умолчанию 40080).
«Token invalid» — Скопируйте токен заново с mcp.ornold.com. Убедитесь, что скопирована вся строка.
«MCP server not loading» — Проверьте синтаксис config.toml. TOML чувствителен к форматированию. При сомнениях используйте TOML-валидатор.
«CAPTCHA solve failed» — Проверьте баланс кредитов для решения CAPTCHA в дашборде Ornold.
Приложение Codex не находит конфиг — Убедитесь, что config.toml находится по пути ~/.codex/config.toml (не внутри папки проекта).

Что дальше?

Прочитайте руководство по Claude Code + Ornold MCP, если вы также используете Claude Code
Узнайте о параллельной автоматизации браузера для одновременного запуска 10+ сессий
Ознакомьтесь с руководством по решению CAPTCHA для работы с reCAPTCHA, hCaptcha и Turnstile
Изучите Vision AI mode для взаимодействия со сложными визуальными интерфейсами