# MCP-сервер

Отдельный **MCP** (Model Context Protocol) сервер позволяет AI-клиенту
управлять лаунчером через *этот* API, а браузером профиля по CDP.
Это самостоятельный Node-процесс; **не** часть данного HTTP API и
не хостируется им. Скачать можно прямо из лаунчера
(**Settings → MCP server → Download MCP server** или кнопка «Download MCP»
в боковой панели); лаунчер сохранит исходники в выбранную папку.
Также доступен в репозитории: `rust/shardx-launcher/mcp/`.

Внутри он просто вызывает этот API: настройте
`SHARDX_API` (базовый URL) и `SHARDX_TOKEN` (Bearer-токен из
*Settings → Automation API*). MCP-сервер предоставляет:
- **API-инструменты**: тонкие обёртки над эндпоинтами ниже
  (профили, отпечатки, прокси, папки, cookies, запуск/остановка).
- **Браузерные инструменты** (patchright поверх CDP). `browser_navigate`,
  `browser_evaluate`, `browser_screenshot`, `browser_click`,
  `browser_fill`, вкладки, ожидания и т.д., применяются к профилю,
  запущенному через `POST /profiles/{id}/start` (который возвращает
  CDP-эндпоинт).

Запуск: либо через **stdio** (клиент стартует его сам), либо через HTTP
на `127.0.0.1:<port>/mcp` (если задана `MCP_HTTP_PORT`). Подробнее см. README MCP-сервера. (Лаунчер только скачивает его, но не запускает.)