Формат ответа
Любой инструмент возвращает текстовый MCP-контент — один JSON-документ с понятным форматированием:
{
"ok": true,
"status": 200,
"body": {}
}ok—trueдля HTTP 2xx, иначеfalse.status— HTTP-код, который вернул локальный API.body— распарсенный JSON, либо сырой текст, если API ответил не JSON-ом.
При HTTP-ошибке ok становится false, MCP-результат дополнительно помечается флагом isError, а структура остаётся той же, чтобы ассистент мог разобраться в ошибке.
Состояние и аккаунт
| MCP-инструмент | HTTP | Примечания |
|---|---|---|
odetect_health_check | GET /health-check | Без x-api-key. Используется для проверки связности. |
odetect_get_info | GET /info | Подписка, лимиты, счётчики использования, путь к драйверу. |
Профили
| MCP-инструмент | HTTP | Параметры |
|---|---|---|
odetect_get_profiles | GET /profile | — |
odetect_get_profile | GET /profile/:id | id (UUID) |
odetect_delete_profile | DELETE /profile/:id | id (UUID) |
odetect_post_profile_create | POST /profile/:os/create | сегмент os (например, windows, linux), опционально name, опционально authPassword |
odetect_post_profile_start | POST /profile/:id/start | id; опционально geolocationMode — allow, block или user; опционально authPassword |
odetect_post_profile_stop | POST /profile/:id/stop | id |
odetect_post_profile_cookies | POST /profile/:id/cookies | id; опционально authPassword. Полную схему импорта куки сверьте с локальным swagger.json. |
odetect_post_profile_set_tags | POST /profile/set/tags | profileId, tagIds (массив строк). Назначение / замена списка тегов. |
odetect_post_profile_set_proxy | POST /profile/set/proxy | profileId, proxyId |
Прокси
| MCP-инструмент | HTTP | Параметры |
|---|---|---|
odetect_get_proxies | GET /proxy | — |
odetect_get_proxy | GET /proxy/:id | id (UUID) |
odetect_post_proxy | POST /proxy | email, password (поля, которые ожидает локальный API) |
odetect_delete_proxy | DELETE /proxy/:id | id (UUID) |
odetect_post_proxy_verify | POST /proxy/:id/verify | id. Проверяет валидность и доступность сохранённого прокси. |
Теги
| MCP-инструмент | HTTP | Параметры |
|---|---|---|
odetect_get_tags | GET /tag | — |
odetect_get_tag | GET /tag/:id | id (UUID) |
odetect_post_tag | POST /tag | Опционально title, color, user, team |
odetect_patch_tag | PATCH /tag/:id | id; опционально title, color |
odetect_delete_tag | DELETE /tag/:id | id (UUID) |
Инструкции сервера
MCP-сервер дополнительно публикует строку instructions в метаданных — краткое описание возможностей для клиента. Точный текст смотрите в start0detectMcpServer в файле src/index.ts.