mcp-server-action1

Servidor MCP para la API REST 3.0 de gestión de endpoints (RMM/parcheado) de Action1.

Aviso: Este es un proyecto independiente y no oficial de Borgels. Borgels no está afiliado, respaldado ni apoyado por Action1. "Action1" y la API de Action1 se mencionan únicamente para describir con qué se comunica este servidor. Necesitas tus propias credenciales de Action1, y el uso de la API de Action1 está sujeto a los propios términos de Action1.

Herramientas

Lectura (siempre activa): organizaciones, endpoints gestionados (inventario, filtros de estado, actualizaciones pendientes), grupos de endpoints, actualizaciones/parches (estado de aprobación, gravedad), vulnerabilidades (CVE, endpoints afectados, remediaciones), software instalado, repositorio de software, biblioteca de scripts, automatizaciones (programaciones e historial de ejecución con resultados por endpoint), informes + datos de informes, registro de auditoría empresarial, descubrimiento de capacidades.

Escritura (opt-in mediante ACTION1_ENABLE_WRITES=true): action1_set_update_approvals — aprobar/rechazar actualizaciones para una organización (el flujo de aprobación de parches). Se rechaza orgId="all".

Deliberadamente ausente (seguridad RMM): crear o ejecutar automatizaciones (run_script/deploy/reboot — ejecución remota de código en endpoints), sesiones de escritorio remoto, modificación del repositorio de software (riesgo de cadena de suministro), eliminación/movimiento de endpoints, gestión de usuarios/roles/organizaciones, cierre empresarial. Si alguna vez se necesita ejecutar scripts, debería ser una herramienta de commit separada con control de funciones.

Related MCP server: TuxCare ePortal MCP Server

Autenticación y regiones

Credenciales de cliente OAuth2 contra {base}/oauth2/token; los tokens duran exactamente 3600 s y se almacenan en caché/renuevan automáticamente. Las credenciales se crean en la consola de Action1 en Configuración → Usuarios y credenciales de API. Establece ACTION1_BASE_URL a la región de tu centro de datos (UE: https://app.eu.action1.com/api/3.0).

Paginación y límites de velocidad

Las listas devuelven {items, total_items, from, nextFrom} — pasa nextFrom como from para continuar. Action1 recomienda mantenerse por debajo de ~30 solicitudes/minuto por empresa; las respuestas 429 muestran retry-after.

Ejecución

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

Imágenes Docker: ghcr.io/borgels/mcp-server-action1 (publicadas al hacer push a main).

Despliegue

Consulta deploy/ para el bloque de servicio de docker-compose, las entradas de hosts.json, un bloque de sitio de proxy inverso y archivos de entorno de ejemplo: una instancia por cada organización de Action1 que quieras exponer, precedida por el gateway/proxy inverso con OAuth que esté delante de tu flota.