mcp-server-action1

MCP-Server für die Action1 Endpunktverwaltung (RMM/Patching) REST-API 3.0.

Haftungsausschluss: Dies ist ein unabhängiges, inoffizielles Projekt von Borgels. Borgels ist nicht mit Action1 verbunden, wird von Action1 nicht unterstützt oder befürwortet. „Action1“ und die Action1-API werden nur referenziert, um zu beschreiben, womit dieser Server kommuniziert. Sie benötigen Ihre eigenen Action1-Anmeldedaten, und die Nutzung der Action1-API unterliegt den eigenen Bedingungen von Action1.

Tools

Lesen (immer aktiv): Organisationen, verwaltete Endpunkte (Inventar, Statusfilter, fehlende Updates), Endpunktgruppen, Updates/Patches (Genehmigungsstatus, Schweregrad), Schwachstellen (CVEs, betroffene Endpunkte, Behebungen), installierte Software, Software-Repository, Skriptbibliothek, Automatisierungen (Zeitpläne und Ausführungsverlauf mit Ergebnissen pro Endpunkt), Berichte + Berichtsdaten, Enterprise-Auditprotokoll, Fähigkeitserkennung.

Schreiben (optional über ACTION1_ENABLE_WRITES=true): action1_set_update_approvals — Updates für eine Organisation genehmigen/ablehnen (der Patch-Genehmigungs-Workflow). orgId="all" wird abgelehnt.

Bewusst nicht vorhanden (RMM-Sicherheit): Erstellen oder Ausführen von Automatisierungen (run_script/deploy/reboot — Remote-Codeausführung auf Endpunkten), Remote-Desktop-Sitzungen, Änderung des Software-Repositorys (Lieferkettenrisiko), Löschen/Verschieben von Endpunkten, Benutzer-/Rollen-/Organisationsverwaltung, Unternehmensschließung. Falls Skriptausführung jemals benötigt wird, sollte sie ein separates, an Berechtigungen gebundenes Commit-Tool sein.

Related MCP server: TuxCare ePortal MCP Server

Authentifizierung & Regionen

OAuth2-Client-Credentials gegen {base}/oauth2/token; Token sind genau 3600 s gültig und werden automatisch zwischengespeichert/erneuert. Anmeldedaten werden in der Action1-Konsole unter Konfiguration → Benutzer & API-Anmeldedaten erstellt. Setzen Sie ACTION1_BASE_URL auf Ihre Rechenzentrumsregion (EU: https://app.eu.action1.com/api/3.0).

Paginierung & Ratenbegrenzung

Listen geben {items, total_items, from, nextFrom} zurück – übergeben Sie nextFrom als from, um fortzufahren. Action1 empfiehlt, unter ~30 Anfragen/Minute pro Unternehmen zu bleiben; 429-Antworten geben retry-after zurück.

Ausführen

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

Docker-Images: ghcr.io/borgels/mcp-server-action1 (bei Push auf main veröffentlicht).

Bereitstellen

In deploy/ finden Sie den Docker-Compose-Dienstblock, hosts.json-Einträge, einen Reverse-Proxy-Site-Block und Beispiel-Umgebungsdateien – eine Instanz pro Action1-Organisation, die Sie zugänglich machen möchten, mit einem vorgelagerten OAuth-fähigen Gateway/Reverse-Proxy vor Ihrer Geräteflotte.