Назад в блог
Гайд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 режим для взаимодействия со сложными визуальными интерфейсами