Atera MCP 用于 Codex

用于官方 Atera REST API 的独立 MCP 服务器。

当前的垂直切片已包含：

• MCP stdio transport，支持 legacy/modern 协议协商；

• atera_health_check 和 atera_capabilities；

• 读取 Customers、Agents、Tickets 和 Alerts；

• 自动选择 legacy X-API-KEY 或 Bearer JWT，并支持手动 override；

• timeout、cancellation、rate limiting、Retry-After 以及安全 GET 的 retry；

• 规范化错误和受控的变更策略（写操作和删除默认启用）。

所有 Atera endpoint 的完整目录会在导入最新 OpenAPI 后添加。说明：docs/OPENAPI_IMPORT.md。按领域的参考基线：REFERENCE_COVERAGE.md。

本地 tenant 导出已验证：OpenAPI 3.0.4，81 个 paths 和 136 个操作（69 个 GET、35 个 POST、19 个 PUT、13 个 DELETE）。文件位于 openapi-private/ 目录下，并有意排除在 git 之外；服务器启动时会将这些操作发布为额外的 MCP tools。

启动

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

最后一条命令会在重启 Codex 之前检查导入的 tenant 架构。如果文件还不存在，它会以清晰的诊断信息结束。

变量通过环境变量设置；模板位于 .env.example。最少需要 ATERA_API_TOKEN 或 legacy ATERA_API_KEY。

ATERA_API_TOKEN='…' npm start

不要将密钥添加到 git，也不要通过 MCP tool 参数传递。

Related MCP server: Codex MCP Server

连接到 Codex

在 Codex 配置中添加本地服务器。在 macOS/Linux 上，用 which node 命令检查 Node.js 路径；在 Windows 上，用 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"

写操作和删除默认启用。你可以通过将相应值设置为 false 在本地禁用它们。能力仍然受 Atera token 权限的限制。

员工通过 GitHub 安装

员工可以在任何受支持的操作系统上给 Codex 下达这样的任务：

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

对于 macOS/Linux，可以在本地执行：

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

对于 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"

所有操作系统的要求：Git、Node.js 20+ 和已安装的 Codex CLI。在 Windows 上，脚本从 PowerShell 运行；如果执行策略禁止本地脚本，请使用 powershell -ExecutionPolicy Bypass -File .\scripts\install-codex.ps1。

安装程序会安装依赖、构建服务器并在 Codex 中注册 stdio MCP。每位员工只添加自己的 ATERA_API_TOKEN；仓库中没有共享 token。默认情况下写操作和删除已启用；如有需要，可以通过 ATERA_WRITE_ENABLED=false 和 ATERA_ENABLE_DESTRUCTIVE_OPERATIONS=false 禁用它们。