Atera MCP für Codex

Eigenständiger MCP-Server für die offizielle Atera REST API.

Der aktuelle Vertical Slice enthält bereits:

• MCP-stdio-Transport mit Legacy/Modern-Protokollaushandlung;

• atera_health_check und atera_capabilities;

• Lesen von Customers, Agents, Tickets und Alerts;

• automatische Auswahl von Legacy-X-API-KEY oder Bearer JWT, mit manuellem Override;

• Timeout, Abbruch, Rate-Limiting, Retry-After und Retry für sichere GET-Anfragen;

• normalisierte Fehler und eine kontrollierte Mutationsrichtlinie (Schreiben und Löschen sind standardmäßig aktiviert).

Der vollständige Katalog aller Atera-Endpunkte wird nach dem Import des aktuellen OpenAPI-Dokuments hinzugefügt. Anleitung: docs/OPENAPI_IMPORT.md. Referenz-Baseline nach Domänen: REFERENCE_COVERAGE.md.

Der lokale Tenant-Export wurde bereits geprüft: OpenAPI 3.0.4, 81 Paths und 136 Operationen (69 GET, 35 POST, 19 PUT, 13 DELETE). Die Datei befindet sich in openapi-private/ und ist bewusst von git ausgeschlossen; beim Start veröffentlicht der Server diese Operationen als zusätzliche MCP-Tools.

Start

npm install
npm run typecheck
npm test
npm run build
npm run openapi:validate -- openapi-private/atera-openapi.json

Der letzte Befehl prüft das importierte Tenant-Schema vor dem Neustart von Codex. Wenn die Datei noch nicht vorhanden ist, endet er mit einer verständlichen Diagnose.

Die Variablen werden über die Umgebung gesetzt; die Vorlage befindet sich in .env.example. Mindestens wird ATERA_API_TOKEN oder der Legacy-ATERA_API_KEY benötigt.

ATERA_API_TOKEN='…' npm start

Das Secret darf nicht in git aufgenommen und nicht in den Argumenten des MCP-Tools übergeben werden.

Related MCP server: Codex MCP Server

Verbindung zu Codex

Fügen Sie in der Codex-Konfiguration einen lokalen Server hinzu. Unter macOS/Linux prüfen Sie den Pfad zu Node.js mit dem Befehl which node, unter Windows mit where node:

[mcp_servers.atera]
command = "/opt/homebrew/bin/node"
args = ["/Users/vardahei/Documents/atera-mcp/dist/src/index.js"]
startup_timeout_sec = 30

[mcp_servers.atera.env]
ATERA_API_TOKEN = "<Atera token>"
ATERA_BASE_URL = "https://api.atera.com/api/v3"
ATERA_AUTH_MODE = "bearer"
ATERA_OPENAPI_PATH = "/Users/vardahei/Documents/atera-mcp/openapi-private/atera-openapi.json"
ATERA_WRITE_ENABLED = "true"
ATERA_ENABLE_DESTRUCTIVE_OPERATIONS = "true"

Schreiben und Löschen sind standardmäßig aktiviert. Sie können lokal deaktiviert werden, indem der entsprechende Wert auf false gesetzt wird. Die Möglichkeiten werden dennoch durch die Berechtigungen des Atera-Tokens begrenzt.

Installation durch Mitarbeiter über GitHub

Der Mitarbeiter kann Codex auf jedem unterstützten Betriebssystem eine solche Aufgabe stellen:

Установи Atera MCP из https://github.com/Oleksandr-Kliuiev/atera-mcp.
Определи мою ОС. На macOS/Linux выполни scripts/install-codex.sh, на Windows — scripts/install-codex.ps1.
Не запрашивай и не выводи мой Atera token в чат. После установки объясни, как добавить мой token локально в окружение MCP-сервера atera.

Für macOS/Linux kann Folgendes lokal ausgeführt werden:

git clone https://github.com/Oleksandr-Kliuiev/atera-mcp.git ~/.local/share/codex/atera-mcp
~/.local/share/codex/atera-mcp/scripts/install-codex.sh

Für Windows PowerShell:

$dir = Join-Path $HOME ".local\share\codex\atera-mcp"
git clone https://github.com/Oleksandr-Kliuiev/atera-mcp.git $dir
& "$dir\scripts\install-codex.ps1"

Anforderungen für alle Betriebssysteme: Git, Node.js 20+ und installierte Codex CLI. Unter Windows wird das Skript aus PowerShell ausgeführt; wenn eine Ausführungsrichtlinie lokale Skripte verbietet, verwenden Sie powershell -ExecutionPolicy Bypass -File .\scripts\install-codex.ps1.

Der Installer installiert die Abhängigkeiten, baut den Server und registriert das stdio-MCP in Codex. Jeder Mitarbeiter fügt nur seinen eigenen ATERA_API_TOKEN hinzu; ein gemeinsames Token ist nicht im Repository enthalten. Standardmäßig sind Schreiben und Löschen aktiviert; bei Bedarf können sie über ATERA_WRITE_ENABLED=false und ATERA_ENABLE_DESTRUCTIVE_OPERATIONS=false deaktiviert werden.