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

Linken Sphere MCP Setup: підключення AI-агентів до антидетект-браузера

Покроковий гайд з підключення Claude Code, Cursor, Windsurf або Cline до Linken Sphere. Керуйте сесіями природною мовою, без скриптів.

18 квіт. 2026 р.

Що ви отримаєте

До кінця цього посібника AI-агенти (Claude Code, Cursor, Windsurf або Cline) будуть керувати реальними сеансами Linken Sphere — відкривати сторінки, заповнювати форми, розв'язувати CAPTCHA та керувати кількома сеансами — все через команди природною мовою. Без скриптів Playwright. Без CSS-селекторів. Просто скажіть AI, що робити.

Цей посібник охоплює Linken Sphere конкретно. Якщо ви використовуєте Dolphin Anty, Wadex або Vision Browser, перегляньте посібники з налаштування для конкретних браузерів.

Передумови

Linken Sphere встановлена та запущена
Принаймні один сеанс створений у Linken Sphere
Node.js 20+ встановлений (nodejs.org)
AI-агент: Claude Code, Cursor, Windsurf або Cline
Базові навички роботи з терміналом/командним рядком

Крок 1 — Увімкнення API Linken Sphere

Linken Sphere надає локальний HTTP API, який Ornold MCP використовує для запуску та керування сеансами. API увімкнений за замовчуванням на порту 40080.

Відкрийте Linken Sphere
Переконайтеся, що програма запущена
API автоматично доступний за адресою http://localhost:40080
Додаткова конфігурація не потрібна — API Linken Sphere завжди ввімкнений

Якщо ви змінили порт за замовчуванням у параметрах Linken Sphere, запишіть його — він вам знадобиться на кроці 4.

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

Ornold — це міст між AI-агентами та браузерами з антидетекцією. Вам потрібен обліковий запис для отримання токена API.

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

🖼️

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

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

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

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

🖼️

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

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

Крок 4 — Генерування конфігурації MCP через майстер налаштування

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

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

🖼️

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

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

Майстер запитає, який AI-агент ви використовуєте. Виберіть свого агента зі списку (Claude Code, Cursor, Windsurf, Cline або Codex). Кожен агент отримує свій формат конфігурації.

🖼️

Крок 1: Виберіть ваш AI-агент

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

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

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

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

🖼️

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

Крок майстра 3 — Увімкнення Linken Sphere

Увімкніть Linken Sphere та заповніть деталі з'єднання:

Порт API (за замовчуванням: 40080) — використовуйте значення за замовчуванням, якщо ви не змінили його в параметрах Linken Sphere

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

🖼️

Крок 3: Увімкніть Linken Sphere та підтвердіть порт

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

Майстер генерує остаточну конфігурацію на основі ваших виборів. Для більшості AI-агентів у вас є два варіанти:

Варіант A: Команда терміналу (рекомендується)

Скопіюйте однорядкову команду та вставте її у свій термінал. Це одноразове налаштування — MCP буде автоматично запускатися з вашим AI-агентом кожен раз після цього.

claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

🖼️

Крок 4: Скопіюйте команду терміналу та запустіть її

Варіант 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

🖼️

Сервер MCP Ornold успішно зареєстрований

Крок 5 — Запустіть Linken Sphere та протестуйте

Перед запуском вашого AI-агента переконайтеся, що Linken Sphere відкрита та у вас є принаймні один створений сеанс.

Відкрийте Linken Sphere
Переконайтеся, що у вас є принаймні один сеанс у списку
Тримайте Linken Sphere запущеною у фоні

Крок 6 — Перша команда браузера AI

Все підключено. Запустіть ваш AI-агент (Claude Code, Cursor, Windsurf або Cline) та спілкуйтеся з ним природною мовою. Ось кілька команд для початку:

# Start a Linken Sphere session and navigate
> Start a 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

🖼️

AI-агент керує Linken Sphere через природну мову

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

Після підключення ваш AI-агент отримує доступ до 40+ інструментів автоматизації браузера. Ось найбільш часто використовувані:

browser_list — Список усіх доступних сеансів Linken Sphere
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 у контексті сторінки
browser_status — Перевірка, які сеанси запущені

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

Робочі столи Linken Sphere

Linken Sphere організує сеанси в "робочі столи" — ізольовані робочі простори, які групують пов'язані сеанси. Коли ви запускаєте сеанс через MCP, він використовує активний робочий стіл у Linken Sphere.

Щоб контролювати, який робочий стіл використовується, перейдіть на нього в Linken Sphere перед запуском команд AI. Міст MCP поважає ваш вибір активного робочого столу.

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

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

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

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

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

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

# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both --linken-port 40080

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

"No sessions found" — Переконайтеся, що Linken Sphere запущена та у вас є принаймні один створений сеанс.
"Connection refused" — Перевірте, що номер порту (за замовчуванням: 40080) відповідає вашому порту API Linken Sphere. Переконайтеся, що брандмауер не блокує з'єднання localhost.
"MCP server not found" — Запустіть `claude mcp list` для перевірки реєстрації ornold-browser. Якщо його немає, повторно запустіть команду налаштування з кроку 4.
"Permission denied (npm install)" — На macOS додайте префікс sudo. На Windows запустіть PowerShell від імені адміністратора.
"Session launch timeout" — Linken Sphere може повільно запускати сеанси при першому запуску. Зачекайте 10-15 секунд і спробуйте ще раз.

Що далі?

Прочитайте посібник з автоматизації Dolphin Anty (/blog/dolphin-anty-mcp-setup) для порівняння з іншим популярним браузером з антидетекцією
Дізнайтеся про паралельну автоматизацію браузерів (/blog/parallel-browser-automation) для запуску 10+ сеансів одночасно
Перегляньте посібник з розв'язання CAPTCHA (/blog/captcha-solving-guide) для роботи з reCAPTCHA, hCaptcha та Turnstile
Дослідіть режим Vision AI (/blog/vision-vs-selectors) для взаємодії зі складними візуальними інтерфейсами