Atera MCP para Codex

Servidor MCP independiente para la API REST oficial de Atera.

El vertical slice actual ya contiene:

• transporte stdio de MCP con negociación de protocolo legacy/modern;

• atera_health_check y atera_capabilities;

• lectura de Customers, Agents, Tickets y Alerts;

• auto-selección de legacy X-API-KEY o Bearer JWT, con anulación manual;

• timeout, cancelación, rate limiting, Retry-After y reintento de GET seguros;

• errores normalizados y política de mutaciones controlada (escritura y eliminaciones habilitadas por defecto).

El catálogo completo de todos los endpoints de Atera se añade después de importar el OpenAPI actual. Instrucción: docs/OPENAPI_IMPORT.md. Reference baseline por dominios: REFERENCE_COVERAGE.md.

La exportación local del tenant ya ha sido verificada: OpenAPI 3.0.4, 81 paths y 136 operaciones (69 GET, 35 POST, 19 PUT, 13 DELETE). El archivo se encuentra en openapi-private/ y está excluido intencionalmente de git; al iniciar, el servidor publica estas operaciones como herramientas MCP adicionales.

Ejecución

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

El último comando verifica el esquema del tenant importado antes de reiniciar Codex. Si el archivo aún no existe, finalizará con un diagnóstico claro.

Las variables se configuran a través del entorno; la plantilla se encuentra en .env.example. Como mínimo se necesita ATERA_API_TOKEN o legacy ATERA_API_KEY.

ATERA_API_TOKEN='…' npm start

No agregar el secreto a git ni pasarlo en los argumentos de la herramienta MCP.

Related MCP server: Codex MCP Server

Conexión con Codex

En la configuración de Codex, añadir el servidor local. En macOS/Linux compruebe la ruta de Node.js con el comando which node, en Windows con 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"

La escritura y las eliminaciones están habilitadas por defecto. Se pueden desactivar localmente estableciendo el valor correspondiente en false. Las capacidades siguen limitadas por los permisos del token de Atera.

Instalación por un empleado desde GitHub

Un empleado puede darle a Codex esta tarea en cualquier sistema operativo compatible:

Установи 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.

Para macOS/Linux se puede ejecutar localmente:

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

Para 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"

Requisitos para todos los SO: Git, Node.js 20+ y Codex CLI instalado. En Windows, el script se ejecuta desde PowerShell; si la política de ejecución impide los scripts locales, use powershell -ExecutionPolicy Bypass -File .\scripts\install-codex.ps1.

El instalador instala las dependencias, compila el servidor y registra stdio MCP en Codex. Cada empleado añade solo su propio ATERA_API_TOKEN; no hay ningún token compartido en el repositorio. Por defecto, la escritura y las eliminaciones están habilitadas; si es necesario, se pueden desactivar mediante ATERA_WRITE_ENABLED=false y ATERA_ENABLE_DESTRUCTIVE_OPERATIONS=false.