Как дать ИИ доступ к серверным логам по SSH и не давать доступ к SSH ключу
«Посмотри последние двадцать строк лога checkout» — для дежурного это просьба на минуту. С ИИ-ассистентом возникает встречный вопрос: какие права я ему для этого выдам? По соседству с нужным файлом лежит журнал HTTP-запросов, а моим SSH-ключом можно читать оба. Передавать ассистенту ключ ради одного tail я бы не стал.
Покажу на тестовом примере, как я открываю ассистенту один журнал по SSH. У доступа будет простой критерий проверки: последние строки app.log читаются, а соседний access.log остаётся недоступен даже тогда, когда ассистент знает его имя.
Кто открывает SSH-соединение
На рабочей машине я использую GateRook. Ассистент вызывает его инструменты через MCP (Model Context Protocol). Например, передаёт имя файла и число последних строк. Шлюз проверяет разрешения, сам строит команду чтения, подключается к серверу и возвращает результат. В параметрах вызова нет поля, куда можно вписать произвольную команду.
Для этого подключения я завожу на сервере отдельную учётку logreader. Ей даю право пройти по каталогам до /var/log/shop/app.log и прочитать сам файл. На сервере прописываю публичный ключ. Путь к закрытому ключу указываю в шлюзе. Перед первым просмотром каталогов сверяю отпечаток ключа хоста по доверенному каналу: при первом интерактивном просмотре редактор может принять ранее неизвестный ключ.
У локального ИИ-клиента бывает и собственный терминал. Если из него можно прочитать тот же ключ или обратиться к сокету ssh-agent с загруженным ключом, ограничение в MCP легко обойти обычным SSH. Поэтому файл и сокет оставляю за пределами окружения, доступного клиенту.
Открываю один файл
В Connections → Add connection → SSH log files создаю подключение с именем shop-logs. Ввожу адрес хоста, пользователя logreader и выбираю Private key file. В разделе Remote log files указываю каталог /var/log/shop. Здесь легко ошибиться: выбор каталога задаёт начало просмотра дерева. Чтобы разрешить чтение, нужно отдельно отметить Allow read у app.log.
Запускаю Test connection. Видеть файл в дереве ещё недостаточно: за просмотр каталогов и метаданных отвечает SFTP, а для чтения шлюз выполняет ограниченные команды по SSH. Поэтому с учёткой в режиме SFTP-only каталоги могут открываться, хотя запрос содержимого завершится ошибкой.
Проверенное подключение добавляю в отдельную точку доступа MCP и подключаю к ней ИИ-клиент. Для этой задачи хватает трёх инструментов: ssh_logs_list показывает разрешённые имена и размеры, ssh_logs_read читает фрагмент файла, ssh_logs_search отбирает записи по заданным условиям.
Три запроса, которыми я проверяю доступ
1. Какие журналы видны? Прошу ассистента: «Перечисли файлы в подключении shop-logs». Вызову ssh_logs_list достаточно имени подключения. Для нашей настройки я ожидаю в списке только app.log. Затем прошу прочитать соседний access.log по имени. Ожидаемый результат — отказ без содержимого файла. Эта вторая проверка важна: отсутствие имени в списке само по себе ещё ничего не говорит о прямом чтении.
2. Можно ли получить последние двадцать строк? Прошу: «Покажи конец app.log, максимум двадцать строк». Вот все аргументы для ssh_logs_read:
{ «connection»: «shop-logs», «file»: «app.log», «tail»: true, «maxLines»: 20 }
Это снимок хвоста файла на момент вызова. Если через минуту сервис допишет строки, нужен новый вызов. Тем же инструментом можно прочитать известный диапазон физических строк через startLine и endLine.
3. Можно ли забрать только часть журнала? Вместо выгрузки всего файла прошу: «Верни до десяти записей уровня ERROR за первые пять минут после 14:05 UTC». Для ssh_logs_search запрос выглядит так:
{ «connection»: «shop-logs», «file»: «app.log», «levels»: [ «ERROR» ], «from»: «2026-11-18T14:05:00Z», «to»: «2026-11-18T14:10:00Z», «maxLines»: 10 }
Фильтр смотрит на время записи: 14:05 входит в выборку, ровно 14:10 — уже нет. Строки без распознанной метки времени в выборку не попадут. Так легко потерять продолжение стектрейса. За ними можно вернуться отдельным чтением диапазона.
Пустая страница тоже требует внимания. Если в ответе есть scanComplete: false и nextCursor, просмотрена лишь часть данных. Чтобы дочитать выборку, передаю полученный курсор в поле cursor следующего вызова с теми же фильтрами и лимитами. Иначе ассистент вполне может сообщить «ошибок нет», хотя ему пока не встретилось ни одной.
Что произойдёт завтра после ротации
Сегодня ассистент читает app.log. Ночью этот файл переименовывают в app.log.1, и сервис начинает писать в новый app.log. Разрешение относится к выбранному имени: вчерашний журнал под новым именем нужно разрешить отдельно. Права серверной учётки на новый активный файл тоже стоит проверить. Так объясняется знакомая ситуация, когда утром недоступна история, хотя никто не менял настройки ассистента.
В конце я смотрю в Activity, какой файл и каким инструментом запрашивал клиент. Если доступ был нужен на время дежурства, ставлю точку доступа на паузу: новые вызовы через неё прекращаются. Уже прочитанные строки могли попасть в историю чата или к провайдеру модели. Поэтому начинать я предпочитаю с простого вопроса: какой конкретно журнал я готов отдать целиком, даже если сегодня из него попросят всего двадцать строк?
Документация коннектора с параметрами чтения и поиска.
Теги:
- SSH
- MCP
- логи
- контроль доступа
Хабы:
- DevOps