Назад до блогу
Гайд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
Крок 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.
Варіант B: Десктопний застосунок Codex
Завантажте застосунок Codex з openai.com/codex (лише macOS Apple Silicon). Встановіть його, відкрийте та увійдіть за допомогою акаунту ChatGPT або API-ключа OpenAI. При запиті виберіть папку проекту.
Застосунок Codex читає той самий config.toml, що і CLI, тому налаштування MCP однакове для обох.
Крок 3 — Створення акаунту Ornold
Ornold — це міст між AI-агентами та антидетект-браузерами.
- Перейдіть на mcp.ornold.com
- Натисніть «Реєстрація» і створіть акаунт із вашою електронною поштою
- Підтвердіть електронну пошту 6-значним кодом
- Ви потрапите на дашборд
Крок 4 — Створення API-токена
У дашборді створіть ваш перший API-токен:
- Введіть ім'я токена (наприклад, «Codex»)
- Натисніть «Створити»
- Скопіюйте токен — він знадобиться на наступному кроці
Безкоштовні акаунти отримують 1 слот, 5 вирішень CAPTCHA (після проходження огляду дашборду) і доступ до стандартних браузерів.
Крок 5 — Генерація MCP-конфігу через майстер у дашборді
У дашборді Ornold є вбудований майстер підключення, який генерує точний MCP-конфіг для вашої конфігурації. Жодного ручного складання команд — просто оберіть параметри і скопіюйте результат.
Перейдіть на вкладку API Tokens у дашборді. Знайдіть ваш токен і натисніть кнопку «Connect» поруч із ним.
Майстер, Крок 1 — Оберіть AI-агент
Майстер запитує, який AI-агент ви використовуєте. Оберіть «Codex» зі списку. Майстер згенерує конфіг у форматі TOML (config.toml) замість JSON. Інші підтримувані агенти: Claude Code, Cursor, VS Code, Windsurf і Cline.
Майстер, Крок 2 — Оберіть режим взаємодії
Оберіть, як AI має взаємодіяти зі сторінками браузера:
- DOM mode (за замовчуванням) — AI читає HTML-структуру сторінки. Кожен елемент отримує маркер [ref=N]. Безкоштовно і швидко. Найкращий вибір для форм, структурованих сторінок і стандартних сайтів.
- Vision AI mode — AI робить скриншот і візуально знаходить елементи за їх виглядом. Працює на будь-якій сторінці, навіть з canvas-інтерфейсами. Кожен аналіз коштує 1 vision-кредит.
- Обидва режими — Доступні всі інструменти. AI автоматично обирає найкращий підхід для кожної дії.
Починайте з DOM mode. Він безкоштовний, швидкий і покриває 90% сценаріїв. Завжди можна перейти на «Обидва» пізніше, якщо знадобиться візуальний аналіз.
Майстер, Крок 3 — Увімкніть антидетект-браузери
Увімкніть потрібні браузери та заповніть дані підключення:
- Linken Sphere — Вкажіть API-порт (за замовчуванням: 40080). Переконайтеся, що Sphere запущено.
- Dolphin Anty — Вкажіть локальний порт (за замовчуванням: 3001) і вставте API-токен Dolphin з Налаштувань → API.
- Wadex — Вкажіть API-порт (за замовчуванням: 8080).
- Vision Browser — Вставте X-Token. Опціонально вкажіть локальний порт.
Можна увімкнути кілька браузерів одночасно. MCP-конфіг включатиме всі з них, і AI-агент зможе керувати будь-яким із запущених.
Майстер, Крок 4 — Скопіюйте конфіг
Майстер генерує фінальний конфіг на основі ваших виборів. Для Codex ви отримуєте готовий до вставки TOML-блок для config.toml. Натисніть «Copy», щоб скопіювати його.
Майстер попередньо заповнює ваш реальний токен і значення портів — просто натисніть «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»
У формі налаштування сервера заповніть:
- Server name: ornold-browser
- Transport: stdio
- Command: npx
- Arguments: ornold-mcp --token YOUR_TOKEN --linken-port 40080 (скоригуйте під ваш браузер)
Натисніть «Save» або «Add». 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
Доступні 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 для взаємодії зі складними візуальними інтерфейсами