mcp-server-action1

MCP-сервер для REST API 3.0 управления конечными точками (RMM/патчинг) Action1.

Дисклеймер: Это независимый неофициальный проект Borgels. Borgels не связан с Action1, не одобрен и не поддерживается Action1. "Action1" и Action1 API упоминаются только для описания того, с чем взаимодействует этот сервер. Вам нужны собственные учётные данные Action1, и использование Action1 API регулируется условиями самой Action1.

Инструменты

Чтение (всегда включено): организации, управляемые конечные точки (инвентаризация, фильтры статуса, отсутствующие обновления), группы конечных точек, обновления/патчи (статус утверждения, критичность), уязвимости (CVE, затронутые конечные точки, исправления), установленное ПО, репозиторий ПО, библиотека скриптов, автоматизации (расписания и история запусков с результатами по конечным точкам), отчёты + данные отчётов, корпоративный журнал аудита, обнаружение возможностей.

Запись (включается через ACTION1_ENABLE_WRITES=true): action1_set_update_approvals — разрешает/отклоняет обновления для одной организации (рабочий процесс утверждения патчей). orgId="all" отклоняется.

Сознательно исключено (безопасность RMM): создание или запуск автоматизаций (run_script/deploy/reboot — удалённое выполнение кода на конечных точках), сеансы удалённого рабочего стола, изменение репозитория ПО (риск цепочки поставок), удаление/перемещение конечных точек, управление пользователями/ролями/организациями, закрытие enterprise. Если когда-либо потребуется выполнение скриптов, это должен быть отдельный инструмент коммита с разграничением обязанностей.

Related MCP server: TuxCare ePortal MCP Server

Аутентификация и регионы

Для OAuth2 client-credentials используется {base}/oauth2/token; токены живут ровно 3600 с и автоматически кэшируются/обновляются. Учётные данные создаются в консоли Action1 в разделе Конфигурация → Пользователи и API-учётные данные. Установите ACTION1_BASE_URL в соответствии с регионом вашего центра обработки данных (ЕС: https://app.eu.action1.com/api/3.0).

Постраничная навигация и ограничения частоты запросов

Списки возвращают {items, total_items, from, nextFrom} — передавайте nextFrom как from, чтобы продолжить. Action1 рекомендует оставаться в пределах ~30 запросов в минуту на enterprise; в ответах 429 отображается retry-after.

Запуск

npm install
npm run dev          # stdio
npm run dev:http     # streamable HTTP on :3000/mcp (stateless)
npm test

Docker-образы: ghcr.io/borgels/mcp-server-action1 (публикуются при пуше в main).

Развёртывание

Смотрите deploy/ для блока сервиса docker-compose, записей hosts.json, блока сайта обратного прокси и примеров env-файлов — по одному экземпляру на организацию Action1, которую вы хотите предоставить, перед которыми стоит тот же OAuth-совместимый шлюз/обратный прокси, что и перед вашим парком устройств.