Skip to content
MCP сервер
Вступление

MCP-сервер 0detect

0detect MCP — это сервер протокола Model Context Protocol (opens in a new tab), который позволяет ИИ-агентам (Claude Desktop, Cursor и любым другим MCP-совместимым клиентам) управлять локально запущенным антидетект-браузером 0detect.

Исходный код: github.com/0detect/mcp-server (opens in a new tab)

Что он делает

Сервер общается с MCP-клиентом по stdio через JSON-RPC, а каждый вызов инструмента превращает в HTTP-запрос к 0detect Local HTTP API. По умолчанию используется адрес http://localhost:56789 — тот же базовый URL, что и у локального Swagger.

С его помощью можно попросить ИИ-ассистента:

  • получать список профилей, создавать, запускать, останавливать и удалять профили;
  • импортировать куки и привязывать к профилям теги и прокси;
  • работать с библиотекой прокси: добавлять, проверять и удалять;
  • работать с тегами: создавать, переименовывать, менять цвет, удалять;
  • читать информацию об аккаунте, квоты и состояние подписки;
  • выполнять health check локального API.

Как это работает

  1. MCP-клиент (Claude Desktop, Cursor и т. п.) запускает сервер как дочерний процесс.
  2. Клиент и сервер обмениваются сообщениями JSON-RPC через stdin/stdout.
  3. Каждый вызов MCP-инструмента превращается в HTTP-запрос к 0detect Local API через fetch.
  4. Ответы возвращаются как текстовый контент MCP — единый JSON-документ с полями ok, status и body (распарсенный JSON, либо сырой текст, если разобрать не получилось).

Вывод console.log перенаправлен в stderr, чтобы случайные сообщения не ломали поток stdio MCP.

Требования

  • Node.js 22+ — сервер использует глобальный fetch.
  • Установленный и запущенный 0detect с доступным Local API. Быстрая проверка: открыть http://localhost:56789/swagger.json или /health-check в браузере либо через curl.
  • Корректный файл ~/.0detect/config.json, созданный самим 0detect. На старте сервер читает из него localApiPort и localApiKey и передаёт ключ в заголовке x-api-key во всех вызовах, кроме odetect_health_check.

Когда это нужно

  • Хотите управлять 0detect из ИИ-ассистента без написания собственной интеграции.
  • Уже пользуетесь Claude Desktop или Cursor и хотите включить операции с антидетект-браузером в более крупные сценарии.
  • Прототипируете автоматизации и нужен единый, не зависящий от языка интерфейс вместо прямых вызовов Local API.

Если нужен низкоуровневый доступ — Selenium, Puppeteer, прямой HTTP — смотрите раздел Документация Local API.

Запуск браузераУстановка и запуск