# 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-сервера. (Лаунчер лише завантажує його, але не запускає.)