Рецепт
Почему не подключается один сайт или API
Когда интернет работает, а один адрес — нет, Kilobat по очереди проверяет каждый уровень. Он называет уровень, на котором произошёл сбой, и что делать дальше.
В приложении
Откройте дашборд и перейдите на вкладку «Состояние».
Найдите «Почему нет подключения?».
Вставьте в поле точный адрес, который не открывается, например
github.comили полный URL.Если проблема в одном приложении, выберите его. Тогда Kilobat проверит ещё и его собственный прокси и открытые подключения.
Нажмите «Проверить». Посмотрите, на каком уровне сбой и каков следующий шаг.
Через CLI
Проверьте один хост.
kilobat why api.example.comВывод Каждый уровень со статусом ok, warning, failed или skipped, затем вердикт и следующий шаг. Если какой-то уровень не прошёл, команда завершается с кодом 1.
Проверьте точный URL, которым пользуется одно приложение. Значения параметров запроса в выводе скрыты.
kilobat why https://example.com/file.zip --app com.example.AppПроверьте через адрес прокси, который приложение задаёт в собственных настройках.
kilobat why https://huggingface.co --proxy http://127.0.0.1:7890Сообщите Kilobat, если код работает в контейнере, виртуальной машине или на удалённом компьютере.
kilobat why db.internal --context containerЗапишите время сбоя приложения рядом со временем проверки.
kilobat why api.example.com --failed-at 14:05
Через MCP
Один раз подключите сервер MCP с помощью claude mcp add kilobat -- kilobat mcp. Для других клиентов см. документацию. После этого агент сможет вызывать эти инструменты. Инструменты, которые меняют настройки, велят агенту сначала спросить вас.
| Инструмент и аргументы | Что делает |
|---|---|
diagnose_connection | Возвращает verdict, next и steps, каждый с layer, status и detail. |
Полезно знать
- Проверка выполняется внутри Kilobat, а не через
curl. Строгий профиль Kilobat не может заблокировать саму проверку. - IPv4 и IPv6 проверяются отдельно. Неисправный путь IPv6 получает собственный вердикт.
- Успешная проверка означает, что этот запрос работает с этого Mac по этому пути прямо сейчас. Передачу, которая уже идёт, она не видит.
Вопросы
Что делает --context provider?
Используйте его, когда запрос делает облачный сервис со своих серверов. Частный адрес, например localhost, работает с вашего Mac, но эти серверы до него не достанут.
Источники
- Документация Kilobat: когда что-то не подключается
- Навык Kilobat: mac-network-troubleshooting
- Kilobat llms.txt: справочник по CLI и MCP
Источники проверены 29 октября 2026 г. Man-страницы — те, что установлены вместе с macOS; откройте любую командой man <name> в Терминале.