Гайд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-селекторов. Просто скажите ИИ, что нужно сделать.

Это руководство охватывает 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
Нажмите «Зарегистрироваться» и создайте аккаунт с помощью email
Подтвердите email с помощью 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 — Выберите режим взаимодействия

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

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

Начните с 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-режим (по умолчанию, бесплатно)

ИИ читает структуру страницы через 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 --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) для взаимодействия со сложными визуальными интерфейсами