Назад до блогу
Гайд15 хв читання
Claude Code + Ornold MCP: повний гайд з налаштування
Встановлення Node.js, налаштування Claude Code, підключення Ornold MCP та AI-автоматизація антидетект-браузерів. macOS і Windows.
17 квіт. 2026 р.Що ви отримаєте в результаті
До кінця цього посібника Claude Code керуватиме реальними сесіями антидетект-браузера — відкривати сторінки, заповнювати форми, вирішувати CAPTCHA та керувати кількома профілями — все через команди природною мовою. Жодних Playwright-скриптів. Жодних CSS-селекторів. Просто скажіть ШІ, що потрібно зробити.
Цей посібник охоплює macOS та Windows. Кроки для Linux аналогічні macOS — використовуйте свій менеджер пакетів замість Homebrew.
Вимоги
- Комп'ютер з macOS 12+ або Windows 10/11
- Встановлений антидетект-браузер: Linken Sphere, Dolphin Anty, Wadex або Vision Browser
- Підключення до інтернету для завантаження інструментів і пакетів
- Базові навички роботи з терміналом (macOS) або PowerShell (Windows)
Крок 1 — Встановлення Node.js
Ornold MCP працює як Node.js-пакет. Потрібна версія Node.js 20 або вища.
macOS
Найпростіший спосіб — використати Homebrew. Якщо Homebrew не встановлено, спочатку встановіть його з brew.sh. Потім:
brew install node@22
Windows
Завантажте офіційний інсталятор з nodejs.org. Оберіть LTS-версію (22.x). Запустіть інсталятор і дотримуйтесь інструкцій. Переконайтеся, що відмічено пункт «Add to PATH».
Перевірте встановлення, відкривши Terminal (macOS) або PowerShell (Windows):
node --version
# Expected output: v22.x.x or higher
npm --version
# Expected output: 10.x.x or higher
Крок 2 — Встановлення Claude Code
Claude Code — це AI-агент для програмування від Anthropic, який працює в терміналі. Він підтримує MCP (Model Context Protocol), що дозволяє використовувати зовнішні інструменти — наприклад, автоматизацію браузера.
macOS
npm install -g @anthropic-ai/claude-code
Windows
Відкрийте PowerShell від імені адміністратора і виконайте:
npm install -g @anthropic-ai/claude-code
Після встановлення запустіть Claude Code для завершення автентифікації:
claude
# Follow the prompts to sign in with your Anthropic account
Claude Code потребує API-ключ Anthropic або підписку Claude Pro/Team. Якщо у вас її ще немає, зареєструйтесь на console.anthropic.com.
Крок 3 — Створення облікового запису Ornold
Ornold — це міст між AI-агентами та антидетект-браузерами. Для отримання API-токена необхідний обліковий запис.
- Перейдіть на mcp.ornold.com
- Натисніть «Зареєструватися» і створіть обліковий запис за допомогою email
- Підтвердіть email за допомогою 6-значного коду, надісланого на вашу поштову скриньку
- Ви опинитесь у панелі керування — готово!
Крок 4 — Створення API-токена
Після реєстрації панель керування запропонує створити перший API-токен. Цей токен автентифікує MCP-підключення.
- Введіть назву для токена (наприклад, «Claude Code»)
- Натисніть «Створити»
- Скопіюйте токен і збережіть його в надійному місці — він знадобиться на наступному кроці
На безкоштовному тарифі доступне 1 місце, 5 вирішень CAPTCHA (після проходження ознайомлення) та доступ до стандартних браузерів. Оновіть план для розширених можливостей.
Крок 5 — Генерація конфігурації MCP через майстер налаштування
У панелі керування Ornold є вбудований майстер підключення, який генерує точну конфігурацію MCP для вашого налаштування. Не потрібно вводити команди вручну — просто оберіть параметри та скопіюйте результат.
Перейдіть на вкладку «API Tokens» у панелі керування. Знайдіть свій токен і натисніть кнопку «Connect» поруч з ним.
Майстер, крок 1 — Оберіть AI-агент
Майстер запитає, який AI-агент ви використовуєте. Виберіть «Claude Code» зі списку. Серед підтримуваних агентів також є Cursor, VS Code, Windsurf, Cline і Codex — кожен отримує свій формат конфігурації.
Майстер, крок 2 — Оберіть режим взаємодії
Оберіть, як ШІ має взаємодіяти зі сторінками браузера:
- DOM-режим (за замовчуванням) — ШІ читає HTML-структуру сторінки. Кожен елемент отримує маркер [ref=N]. Безкоштовно і швидко. Найкращий вибір для форм, структурованих сторінок і звичайних сайтів.
- Vision AI режим — ШІ робить знімок екрана і візуально знаходить елементи за їх виглядом. Працює на будь-якій сторінці, включно з canvas-інтерфейсами. Кожен аналіз коштує 1 vision-кредит.
- Обидва режими — доступні всі інструменти. ШІ автоматично обирає найкращий підхід для кожної дії.
Почніть з DOM-режиму. Він безкоштовний, швидкий і впорається з 90% завдань. Ви завжди можете переключитись на «Обидва режими», якщо знадобиться візуальний аналіз.
Майстер, крок 3 — Увімкнення антидетект-браузерів
Увімкніть потрібні браузери та вкажіть деталі підключення:
- Linken Sphere — Вкажіть API-порт (за замовчуванням: 40080). Переконайтеся, що Sphere запущено.
- Dolphin Anty — Вкажіть локальний порт (за замовчуванням: 3001) і вставте API-токен з розділу «Налаштування → API».
- Wadex — Вкажіть API-порт (за замовчуванням: 8080).
- Vision Browser — Вставте X-Token. За потреби вкажіть локальний порт.
Можна увімкнути кілька браузерів одночасно. Конфігурація MCP включатиме всі з них, і AI-агент зможе керувати тим, який запущено.
Майстер, крок 4 — Скопіюйте та застосуйте конфігурацію
Майстер генерує підсумкову конфігурацію на основі ваших виборів. Для Claude Code доступні два варіанти:
Варіант A: Команда в терміналі (рекомендовано)
Скопіюйте однорядкову команду і вставте її в термінал. Це одноразове налаштування — MCP автоматично запускатиметься разом з Claude Code при кожному наступному використанні.
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Варіант B: Файл .mcp.json у проєкті
Якщо ви хочете поділитись конфігурацією MCP з командою через систему контролю версій, скопіюйте JSON і збережіть його як .mcp.json у кореневій директорії проєкту:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
Майстер автоматично підставляє ваш токен і значення портів — просто натисніть «Копіювати» і вставте. Ручне редагування не потрібне.
Перевірте, що MCP-сервер зареєстровано:
claude mcp list
# You should see "ornold-browser" in the list
Крок 6 — Запустіть браузер і перевірте роботу
Перед запуском Claude Code переконайтеся, що ваш антидетект-браузер запущено. Короткий чеклист:
- Linken Sphere — Відкрийте застосунок. Якщо сесій немає, створіть хоча б одну.
- Dolphin Anty — Відкрийте застосунок. Переконайтеся, що локальний API увімкнено в налаштуваннях.
- Wadex — Відкрийте застосунок і перевірте, що API-порт збігається з конфігурацією.
Крок 7 — Перша команда AI-браузера
Все підключено. Запустіть Claude Code у будь-якій директорії:
claude
Тепер спілкуйтесь з ним природною мовою. Ось кілька команд для початку:
# Start a Linken Sphere session and navigate
> Start a new Linken Sphere session and open google.com
# Fill a form
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up
# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it
# Take a screenshot for visual analysis
> Take a screenshot of the current page and describe what you see
# Work with multiple sessions
> Start 3 Linken Sphere sessions and open google.com in all of them
Доступні MCP-інструменти
Після підключення Claude Code отримує доступ до 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 — Візуальний аналіз сторінок за допомогою ШІ
- browser_solve_captcha — Автоматичне вирішення reCAPTCHA, hCaptcha, Turnstile та інших
- browser_parallel_evaluate — Виконання JavaScript у контексті сторінки
- linken_stop_instances / dolphin_stop_profiles — Закриття сесій
Не потрібно запам'ятовувати назви інструментів. Просто опишіть звичайною мовою, що хочете зробити, і Claude Code автоматично вибере потрібні інструменти.
Режими взаємодії
Ornold MCP підтримує два режими взаємодії. Обрати їх можна під час налаштування:
DOM-режим (за замовчуванням, безкоштовно)
ШІ читає структуру сторінки через DOM-знімки. Кожен елемент отримує маркер [ref=N]. Швидко і не витрачає vision-кредити. Найкращий вибір для структурованих сторінок з чітким HTML.
Vision AI режим (платний, за кожен аналіз)
ШІ робить знімок екрана і використовує візуальний аналіз для пошуку елементів за їх виглядом. Працює на будь-якій сторінці, включно зі складними SPA або canvas-інтерфейсами. Кожен аналіз коштує 1 vision-кредит.
# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
Усунення несправностей
- «npx: command not found» — Node.js не додано до PATH. Перезапустіть термінал після встановлення Node.js. На Windows переконайтеся, що під час встановлення було відмічено пункт «Add to PATH».
- «Cannot connect to Linken Sphere» — Переконайтеся, що Sphere запущено і API-порт вказано правильно (за замовчуванням 40080). Перевірте, чи не блокує брандмауер цей порт.
- «Token invalid» — Скопіюйте токен повторно з панелі керування mcp.ornold.com. Токени — це довгі рядки, переконайтеся, що скопіювали значення повністю.
- «MCP server not responding» — Виконайте `claude mcp list` для перевірки реєстрації. Спробуйте видалити і додати знову: `claude mcp remove ornold-browser`, потім повторіть команду додавання.
- «CAPTCHA solve failed» — Перевірте баланс captcha-кредитів у панелі керування Ornold. На безкоштовному плані кількість вирішень обмежена.
- «Permission denied (npm install)» — На macOS додайте префікс sudo. На Windows запустіть PowerShell від імені адміністратора.
Що далі?
- Прочитайте посібник з автоматизації Linken Sphere для розширеного керування сесіями
- Дізнайтеся про паралельну автоматизацію браузерів для запуску 10+ сесій одночасно
- Ознайомтеся з посібником із вирішення CAPTCHA для роботи з reCAPTCHA, hCaptcha та Turnstile
- Дослідіть Vision AI режим для взаємодії зі складними візуальними інтерфейсами