Atera MCP（Codex 用）

公式 Atera REST API 用のスタンドアロン MCP サーバー。

現在の vertical slice には、以下がすでに含まれています:

• MCP stdio トランスポートと、レガシー/モダンのプロトコルネゴシエーション;

• atera_health_check と atera_capabilities;

• Customers、Agents、Tickets、Alerts の読み取り;

• レガシー X-API-KEY または Bearer JWT の自動選択、手動オーバーライド付き;

• タイムアウト、キャンセル、レート制限、Retry-After、安全な GET のリトライ;

• 正規化されたエラーと、管理されたミューテーションポリシー（書き込みと削除はデフォルトで有効）。

Atera の全エンドポイントの完全なカタログは、実際の OpenAPI をインポートした後に追加されます。手順: docs/OPENAPI_IMPORT.md。ドメイン別 Reference baseline: REFERENCE_COVERAGE.md。

ローカル テナント エクスポートは確認済みです: OpenAPI 3.0.4、81 paths、136 オペレーション（69 GET、35 POST、19 PUT、13 DELETE）。ファイルは openapi-private/ にあり、意図的に git から除外されています。起動時にサーバーはこれらのオペレーションを追加の MCP ツールとして公開します。

起動

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

最後のコマンドは、Codex を再起動する前にインポートされたテナント スキーマを検証します。ファイルがまだ存在しない場合は、わかりやすい診断メッセージを表示して終了します。

変数は環境変数で設定します。テンプレートは .env.example にあります。最低限必要なのは ATERA_API_TOKEN またはレガシーの ATERA_API_KEY です。

ATERA_API_TOKEN='…' npm start

シークレットは git に追加せず、MCP ツールの引数にも渡さないでください。

Related MCP server: Codex MCP Server

Codex への接続

Codex の設定にローカルサーバーを追加します。macOS/Linux では、Node.js のパスを which node コマンドで確認し、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 トークンの権限によって制限されます。

GitHub からの従業員によるインストール

従業員は、サポートされている任意の OS で 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"

すべての OS 向けの要件: Git、Node.js 20+、インストール済みの Codex CLI。Windows では、スクリプトは PowerShell から実行されます。ローカルスクリプトを禁止する実行ポリシーの場合は、powershell -ExecutionPolicy Bypass -File .\scripts\install-codex.ps1 を使用してください。

インストーラーは依存関係をインストールし、サーバーをビルドし、Codex に stdio MCP を登録します。各従業員は自分の ATERA_API_TOKEN のみを追加します。共通のトークンはリポジトリに存在しません。デフォルトでは書き込みと削除が有効です。必要に応じて、ATERA_WRITE_ENABLED=false および ATERA_ENABLE_DESTRUCTIVE_OPERATIONS=false で無効にできます。