Безопасность
MCP-сервер — это тонкий прокси перед 0detect Local API. Любой, кто может вызывать его инструменты, сможет выполнить всё, что разрешает ваш API-ключ.
- Если 0detect позволяет разделение по ключам, используйте отдельный API-ключ для MCP-сервера и принцип минимальных привилегий.
- Ключ читается из
~/.0detect/config.json, которым управляет сам 0detect. Файл должен быть доступен на чтение только вашему пользователю, и его нельзя коммитить в репозиторий. - Если есть подозрение, что ключ утёк, ротейтите его внутри 0detect и перезапустите MCP-клиента, чтобы сервер подхватил новое значение.
- Запускайте MCP-сервер только на тех машинах, которым доверяете хостить ваши антидетект-профили.
Частые проблемы
| Симптом | Что проверить |
|---|---|
Ошибки соединения / fetch | Запущен ли 0detect? Существует ли ~/.0detect/config.json с корректным localApiPort? Не блокируют ли порт фаервол или адрес привязки? |
Ошибки 401 / аутентификации | Есть ли в ~/.0detect/config.json актуальный localApiKey? После ротации ключа в 0detect перезапустите MCP-клиента, чтобы загрузилось новое значение. |
| MCP-клиент не видит инструментов | Запустите npm start в терминале и убедитесь, что процесс стартует без ошибок. Проверьте логи клиента — нет ли ошибок запуска и неверных путей. |
| Сломанный протокол / неожиданные обрывы соединения | Не направляйте посторонний вывод в тот же stdout. Сервер уже перенаправляет console.log в stderr — делайте так же для любых своих логов. |
Запрос успешен, но body пустой или не такой, как ожидалось | Сверьтесь с локальным swagger.json по адресу http://localhost:56789/swagger.json — он является источником истины для контракта API. |
Диагностика
Быстрые проверки для локализации проблемы:
# Жив ли локальный API?
curl -i http://localhost:56789/health-check
# Есть ли конфиг с нужными полями?
cat ~/.0detect/config.json
# Запускается ли MCP-сервер без ошибок?
cd /absolute/path/to/0detect-mcp && npm startЕсли npm start тут же завершается или пишет ошибку в stderr — сначала чините это: MCP-клиент не может общаться с сервером, который не остаётся живым.
Сообщение об ошибках
Баги и пожелания по MCP-серверу — в трекер github.com/0detect/mcp-server (opens in a new tab). К отчёту приложите:
- версию Node.js (
node --version); - название и версию MCP-клиента (например, Cursor 0.x, Claude Desktop x.y);
- точный вызов инструмента и полный JSON-ответ (без вашего API-ключа).