Гайд12 хв читання

Cursor + Ornold MCP: повний гайд з налаштування

Підключіть Cursor до Ornold MCP та автоматизуйте антидетект-браузери за допомогою AI. Покрокове налаштування для Linken Sphere, Dolphin Anty та інших.

19 квіт. 2026 р.

Що ви побудуєте

До кінця цього посібника у вас буде Cursor, який керує реальними сеансами antidetect браузера — навігація по сторінках, заповнення форм, розв'язування CAPTCHA та управління кількома профілями — все через природну мову в чаті Cursor. Без скриптів Playwright. Без CSS селекторів. Просто скажіть AI, що робити.

Цей посібник охоплює macOS та Windows. Кроки для Linux такі ж, як для macOS (використовуйте менеджер пакетів замість Homebrew).

Передумови

Комп'ютер з macOS 12+ або Windows 10/11
Встановлений Cursor (безплатний або Pro план)
Встановлений antidetect браузер: Linken Sphere, Dolphin Anty, Wadex або Vision Browser
Інтернет-з'єднання для завантаження інструментів та пакетів

Крок 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" позначено.

Сторінка завантаження Node.js з селектором версії LTS

Завантажте Node.js LTS з nodejs.org

Перевірте встановлення, відкривши Terminal (macOS) або PowerShell (Windows):

node --version
# Очікуваний результат: v22.x.x або вище

npm --version
# Очікуваний результат: 10.x.x або вище

Terminal, що показує вихід node --version v22

Підтвердьте, що Node.js встановлено правильно

Крок 2 — Встановлення Cursor

Cursor — це редактор коду на базі AI, побудований на VS Code. Він підтримує MCP (Model Context Protocol) нативно, що дозволяє йому використовувати зовнішні інструменти, такі як автоматизація браузера.

Завантажте Cursor з cursor.com
Встановіть та відкрийте його
Увійдіть за допомогою свого облікового запису Cursor (безплатний план працює для MCP)

Якщо у вас уже встановлений Cursor, переконайтесь, що він оновлений до останньої версії — підтримка MCP була додана в останніх випусках.

🖼️

Cursor після першого запуску — увійдіть за допомогою свого облікового запису

Cursor Pro дає вам більше запитів AI на місяць, але безплатний план достатній для тестування автоматизації браузера MCP.

Крок 3 — Створення облікового запису Ornold

Ornold — це міст між AI агентами та antidetect браузерами. Вам потрібен обліковий запис, щоб отримати токен API.

Перейдіть на mcp.ornold.com
Натисніть "Register" та створіть обліковий запис за допомогою своєї електронної пошти
Підтвердьте свою електронну пошту за допомогою 6-значного коду, надісланого на вашу скриньку
Ви потрапите на панель керування — ви в системі!

Сторінка реєстрації Ornold MCP з полями електронної пошти та пароля

Створіть свій обліковий запис Ornold на mcp.ornold.com

Крок 4 — Створення токена API

Після реєстрації панель керування запропонує вам створити свій перший токен API. Цей токен автентифікує ваше з'єднання MCP.

Введіть назву для вашого токена (наприклад, "Cursor")
Натисніть "Create"
Скопіюйте токен та збережіть його в безпечному місці — він вам знадобиться на наступному кроці

Панель керування Ornold, що показує модальне вікно створення токена з кнопкою копіювання

Створіть та скопіюйте свій токен API

Безплатні облікові записи отримують 1 місце, 5 розв'язань captcha (після завершення туру) та доступ до стандартних браузерів. Оновіть свій план для більшої ємності.

Крок 5 — Генерація конфігурації MCP за допомогою майстра панелі керування

Панель керування Ornold має вбудований Connect Wizard, який генерує точну конфігурацію MCP для вашої установки. Без ручного створення JSON — просто виберіть свої параметри та скопіюйте результат.

Перейдіть на вкладку API Tokens на панелі керування. Знайдіть свій токен та натисніть кнопку "Connect" поруч з ним.

Сторінка API Tokens панелі керування Ornold з виділеною кнопкою Connect поруч з токеном

Натисніть "Connect" на вашому токені, щоб відкрити майстер

Крок майстра 1 — Виберіть свого AI агента

Майстер запитує, якого AI агента ви використовуєте. Виберіть "Cursor" зі списку. Майстер генеруватиме конфігурацію у форматі JSON для mcp.json Cursor. Інші підтримувані агенти включають Claude Code, Codex, VS Code, Windsurf та Cline.

🖼️

Крок 1: Виберіть Cursor як свого AI агента

Крок майстра 2 — Виберіть режим взаємодії

Виберіть, як AI повинен взаємодіяти зі сторінками браузера:

Режим DOM (за замовчуванням) — AI читає структуру HTML сторінки. Кожен елемент отримує маркер [ref=N]. Безплатно та швидко. Найкраще для форм, структурованих сторінок та стандартних веб-сайтів.
Режим Vision AI — AI робить знімок екрана та візуально знаходить елементи за їх виглядом. Працює на будь-якій сторінці, навіть на UI на основі canvas. Кожен аналіз коштує 1 vision credit.
Обидва режими — Усі інструменти доступні. AI автоматично вибирає найкращий підхід для кожної дії.

Почніть з режиму DOM. Він безплатний, швидкий та обробляє 90% випадків використання. Ви завжди можете перейти на "Both" пізніше, якщо вам потрібен візуальний аналіз.

Крок 2 майстра підключення, що показує три варіанти режиму взаємодії: DOM, Vision AI, Both

Крок 2: Виберіть режим DOM для більшості випадків

Крок майстра 3 — Увімкніть Antidetect браузери

Увімкніть браузери, які ви використовуєте, та заповніть їх деталі підключення:

Linken Sphere — Просто встановіть порт API (за замовчуванням: 40080). Переконайтесь, що Sphere запущена.
Dolphin Anty — Встановіть локальний порт (за замовчуванням: 3001) та вставте свій токен Dolphin API з Settings → API.
Wadex — Встановіть порт API (за замовчуванням: 8080).
Vision Browser — Вставте свій X-Token. За бажанням встановіть локальний порт.

Ви можете увімкнути кілька браузерів одночасно. Конфігурація MCP включатиме всі з них, і Cursor зможе керувати будь-яким, який запущений.

Крок 3 майстра підключення, що показує перемикачі браузера з увімкненою Linken Sphere та заповненим полем порту

Крок 3: Увімкніть свої antidetect браузери та заповніть порти

Крок майстра 4 — Скопіюйте конфігурацію

Майстер генерує остаточну конфігурацію JSON на основі ваших виборів. Натисніть "Copy", щоб отримати її — ви вставите її в параметри MCP Cursor на наступному кроці.

🖼️

Крок 4: Скопіюйте згенеровану конфігурацію JSON

Майстер попередньо заповнює ваші фактичні значення токена та порту — просто натисніть "Copy" та вставте. Ручне редагування не потрібне.

Крок 6 — Додайте Ornold MCP до Cursor

Cursor керує MCP-серверами через JSON-файл конфігурації. Ви можете відкрити його через Cursor Settings → MCP → «Add new MCP server» — це відкриє файл mcp.json у редакторі. Cursor зберігає налаштування MCP у двох місцях:

Якщо ви віддаєте перевагу редагуванню файлу конфігурації безпосередньо, Cursor зберігає параметри MCP в:

# Глобальний (усі проекти)
~/.cursor/mcp.json

# Для кожного проекту (тільки цей проект)
.cursor/mcp.json

Вставте конфігурацію з майстра. Ось як вона виглядає для Linken Sphere:

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
    }
  }
}

Для Dolphin Anty:

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
    }
  }
}

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

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": [
        "ornold-mcp",
        "--token", "YOUR_TOKEN",
        "--linken-port", "40080",
        "--dolphin-port", "3001",
        "--dolphin-token", "DOLPHIN_KEY",
        "--wadex-port", "8080"
      ]
    }
  }
}

Використовуйте ~/.cursor/mcp.json для глобальної установки (доступна у всіх проектах). Використовуйте .cursor/mcp.json у корені проекту, щоб поділитися конфігурацією з вашою командою через контроль версій.

Крок 7 — Запустіть свій браузер та протестуйте

Переконайтесь, що ваш antidetect браузер запущений перед використанням чату AI Cursor. Швидкий контрольний список:

Linken Sphere — Відкрийте додаток. Створіть принаймні один сеанс, якщо у вас його немає.
Dolphin Anty — Відкрийте додаток. Переконайтесь, що локальний API увімкнений у Settings.
Wadex — Відкрийте додаток та перевірте, що порт API відповідає вашій конфігурації.

Відкрийте будь-який проект у Cursor та почніть чат з AI (Cmd+L або Ctrl+L). Переконайтесь, що ви використовуєте режим Agent — саме там доступні інструменти MCP.

🖼️

Перейдіть у режим Agent у чаті Cursor, щоб використовувати інструменти MCP

Крок 8 — Ваша перша команда AI браузера

Все підключено. Відкрийте чат Cursor та спілкуйтесь з ним природною мовою. Ось деякі команди для спробування:

# Запустіть сеанс Linken Sphere та навігуйте
> Start a new Linken Sphere session and open google.com

# Заповніть форму
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up

# Розв'яжіть CAPTCHA
> There's a CAPTCHA on this page, solve it

# Зробіть знімок екрана для візуального аналізу
> Take a screenshot of the current page and describe what you see

# Працюйте з кількома сеансами
> Start 3 Linken Sphere sessions and open google.com in all of them

🖼️

Cursor керує Linken Sphere через Ornold MCP

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

Після підключення Cursor має доступ до 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 — Закрийте сеанси

Вам не потрібно запам'ятовувати назви інструментів. Просто опишіть, що ви хочете простою англійською мовою, і Cursor автоматично вибере правильні інструменти.

Режими взаємодії

Ornold MCP підтримує два режими взаємодії. Ви можете вибрати під час установки:

Режим DOM (за замовчуванням, безплатно)

AI читає структуру сторінки через знімки DOM. Кожен елемент отримує маркер [ref=N]. Швидко та не коштує жодних vision credits. Найкраще для структурованих сторінок з чітким HTML.

Режим Vision AI (платно за аналіз)

AI робить знімок екрана та використовує візуальний аналіз, щоб знайти елементи за їх виглядом. Працює на будь-якій сторінці, навіть на складних SPA або UI на основі canvas. Кожен аналіз коштує 1 vision credit.

Щоб увімкнути обидва режими, додайте прапор --mode до аргументів конфігурації MCP:

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--mode", "both", "--linken-port", "40080"]
    }
  }
}

Режим Cursor Agent vs режим Ask

Cursor має два режими чату. Інструменти MCP працюють тільки в режимі Agent:

Режим Agent — AI може використовувати інструменти MCP, запускати команди терміналу та редагувати файли. Це те, що вам потрібно для автоматизації браузера.
Режим Ask — AI тільки відповідає на запитання на основі вашої кодової бази. Без доступу до інструментів. Інструменти MCP не з'являтимуться тут.

Переконайтесь, що ви в режимі Agent (перевірте випадаючий список у верхній частині панелі чату) перед спробою команд браузера. Якщо ви не бачите інструменти MCP, перейдіть у режим Agent.

Ви також можете використовувати Composer Cursor (Cmd+I / Ctrl+I) для багатокрокових завдань автоматизації браузера. Composer підтримує інструменти MCP у режимі Agent також.

Усунення неполадок

"MCP server not showing" — Переконайтесь, що mcp.json є дійсним JSON. Навіть кінцева кома розіб'є його. Використовуйте валідатор JSON, якщо ви не впевнені.
"npx: command not found" — Node.js не в PATH. Перезапустіть Cursor після встановлення Node.js. На macOS з nvm вам може знадобитися встановити повний шлях до npx у полі команди.
"Cannot connect to Linken Sphere" — Переконайтесь, що Sphere запущена та порт API правильний (за замовчуванням 40080). Перевірте, що брандмауер не блокує порт.
"Token invalid" — Скопіюйте токен знову з панелі керування mcp.ornold.com. Токени — це довгі рядки — переконайтесь, що ви скопіювали все значення.
"Tools not appearing in chat" — Переконайтесь, що ви в режимі Agent, а не Ask. Перевірте Cursor Settings → MCP, щоб переконатися, що сервер показує зелений статус "connected".
"CAPTCHA solve failed" — Перевірте баланс captcha credits на панелі керування Ornold. Безплатний план включає обмежену кількість розв'язань.
"Server disconnected" — Cursor може відключити сервери MCP після простою. Перезапустіть чат або перемикніть сервер у Settings → MCP.

Що далі?

Прочитайте посібник Claude Code + Ornold MCP, якщо ви також використовуєте Claude Code
Прочитайте посібник Codex + Ornold MCP, якщо ви також використовуєте OpenAI Codex
Дізнайтесь про паралельну автоматизацію браузера для запуску 10+ сеансів одночасно
Перевірте посібник розв'язування CAPTCHA для обробки reCAPTCHA, hCaptcha та Turnstile
Дослідіть режим Vision AI для взаємодії зі складними візуальними інтерфейсами