fleet-mcp — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для подключения AI к Fleet Device Management: выполнение запросов osquery, аудит парка устройств и мониторинг политик безопасности.
claude mcp add --env FLEET_SERVER_URL=<FLEET_SERVER_URL> --env FLEET_API_TOKEN=<FLEET_API_TOKEN> --env FLEET_READONLY=<FLEET_READONLY> --env FLEET_ALLOW_SELECT_QUERIES=<FLEET_ALLOW_SELECT_QUERIES> --env FLEET_VERIFY_SSL=<FLEET_VERIFY_SSL> --transport stdio fleet-mcp -- uvx fleet-mcpЧто делает fleet-mcp
Сервер связывает ассистента с инстансом Fleet Device Management через API. Инструмент открывает модели доступ к инвентарю хостов, списку установленного софта и журналам активности. Ассистент может напрямую отправлять живые osquery-запросы к рабочим станциям для проверки системных параметров.
Запуск выполняется через утилиту uvx. Для работы необходим работающий сервер Fleet и действующий FLEET_API_TOKEN, созданный в веб-интерфейсе или через утилиту fleetctl. Если включить флаг FLEET_READONLY, сервер заблокирует изменение конфигураций и оставит только чтение данных. Без сетевого доступа к инстансу или с неверным токеном сервер завершает сессию с ошибкой авторизации.
Какие задачи решает
- запускать osquery-запросы на подключённых рабочих станциях
- проверять инвентарь установленного софта на наличие уязвимостей
- контролировать соблюдение политик безопасности на устройствах
- получать данные о хостах и командах прямо в диалоге с моделью
Примеры запросов агенту
- Выполни SELECT-запрос через osquery к хостам разработчиков и проверь статус шифрования дисков
- Проверь соблюдение политик безопасности на машинах из команды бэкенда
- Покажи уязвимости в установленном софте для хоста
dev-mac-01
Как установить fleet-mcp
Командой платформы
claude mcp add --env FLEET_SERVER_URL=<FLEET_SERVER_URL> --env FLEET_API_TOKEN=<FLEET_API_TOKEN> --env FLEET_READONLY=<FLEET_READONLY> --env FLEET_ALLOW_SELECT_QUERIES=<FLEET_ALLOW_SELECT_QUERIES> --env FLEET_VERIFY_SSL=<FLEET_VERIFY_SSL> --transport stdio fleet-mcp -- uvx fleet-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fleet-mcp <команда>
Командой платформы
codex mcp add fleet-mcp --env FLEET_SERVER_URL=<FLEET_SERVER_URL> --env FLEET_API_TOKEN=<FLEET_API_TOKEN> --env FLEET_READONLY=<FLEET_READONLY> --env FLEET_ALLOW_SELECT_QUERIES=<FLEET_ALLOW_SELECT_QUERIES> --env FLEET_VERIFY_SSL=<FLEET_VERIFY_SSL> -- uvx fleet-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fleet-mcp <команда>
Файл настроек
{
"mcpServers": {
"fleet-mcp": {
"command": "uvx",
"args": [
"fleet-mcp"
],
"env": {
"FLEET_SERVER_URL": "<FLEET_SERVER_URL>",
"FLEET_API_TOKEN": "<FLEET_API_TOKEN>",
"FLEET_READONLY": "<FLEET_READONLY>",
"FLEET_ALLOW_SELECT_QUERIES": "<FLEET_ALLOW_SELECT_QUERIES>",
"FLEET_VERIFY_SSL": "<FLEET_VERIFY_SSL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fleet-mcp <команда>
Файл настроек
{
"servers": {
"fleet-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fleet-mcp"
],
"env": {
"FLEET_SERVER_URL": "<FLEET_SERVER_URL>",
"FLEET_API_TOKEN": "<FLEET_API_TOKEN>",
"FLEET_READONLY": "<FLEET_READONLY>",
"FLEET_ALLOW_SELECT_QUERIES": "<FLEET_ALLOW_SELECT_QUERIES>",
"FLEET_VERIFY_SSL": "<FLEET_VERIFY_SSL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fleet-mcp <команда>
Командой платформы
gemini mcp add -e FLEET_SERVER_URL=<FLEET_SERVER_URL> -e FLEET_API_TOKEN=<FLEET_API_TOKEN> -e FLEET_READONLY=<FLEET_READONLY> -e FLEET_ALLOW_SELECT_QUERIES=<FLEET_ALLOW_SELECT_QUERIES> -e FLEET_VERIFY_SSL=<FLEET_VERIFY_SSL> fleet-mcp uvx fleet-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fleet-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fleet-mcp
Как установить fleet-mcp в Claude Code?
Запустите команду claude mcp add fleet-mcp -e FLEET_SERVER_URL=<FLEET_SERVER_URL> -e FLEET_API_TOKEN=<FLEET_API_TOKEN> -- uvx fleet-mcp. Замените плейсхолдеры на реальный адрес инстанса и ваш API-токен.
Что делает fleet-mcp?
Он предоставляет AI-ассистенту инструменты для взаимодействия с Fleet Device Management. С его помощью модель читает списки хостов, запускает osquery и инспектирует уязвимости софта.
Как включить режим только для чтения?
Передайте переменные окружения FLEET_READONLY=true и FLEET_ALLOW_SELECT_QUERIES=true. Сервер ограничит команды безопасными SELECT-запросами и запретит менять настройки хостов.
