mcp-server-action1

Action1 エンドポイント管理 (RMM/パッチ適用) REST API 3.0 用の MCP サーバー。

免責事項: これは Borgels による独立した非公式プロジェクトです。Borgels は Action1 とは提携しておらず、Action1 からの承認や支援も受けていません。「Action1」および Action1 API は、このサーバーが通信する対象を説明するためだけに言及されています。独自の Action1 資格情報が必要であり、Action1 API の使用は Action1 自身の 利用規約に従います。

ツール

読み取り（常時有効）: 組織、管理対象エンドポイント（インベントリ、ステータスフィルター、不足している更新）、エンドポイントグループ、更新/パッチ（承認ステータス、重大度）、脆弱性（CVE、影響を受けるエンドポイント、修復）、インストール済みソフトウェア、ソフトウェアリポジトリ、スクリプトライブラリ、オートメーション（スケジュールとエンドポイントごとの実行履歴）、レポート + レポートデータ、エンタープライズ監査ログ、機能ディスカバリー。

書き込み（ACTION1_ENABLE_WRITES=true によるオプトイン）: action1_set_update_approvals — 1つの組織に対する更新の承認/拒否（パッチ承認ワークフロー）。 orgId="all" は拒否されます。

意図的に除外（RMM の安全性）: オートメーションの作成または実行（run_script/deploy/reboot — エンドポイント上でのリモートコード実行）、リモートデスクトップセッション、ソフトウェアリポジトリの変更（サプライチェーンリスク）、エンドポイントの削除/移動、ユーザー/ロール/組織の管理、エンタープライズの閉鎖。もしスクリプト実行が必要な場合は、別の職務分離されたコミットツールとすべきです。

Related MCP server: TuxCare ePortal MCP Server

認証とリージョン

OAuth2 クライアント資格情報を {base}/oauth2/token に対して使用します。トークンの有効期間は正確に3600秒で、自動的にキャッシュおよび更新されます。資格情報は Action1 コンソールの「Configuration → Users & API Credentials」で作成します。ACTION1_BASE_URL はデータセンターリージョンに合わせて設定してください（EU: https://app.eu.action1.com/api/3.0）。

ページネーションとレート制限

リストは {items, total_items, from, nextFrom} を返します。nextFrom を from として渡すと続きを取得できます。Action1 はエンタープライズごとに毎分 ~30 リクエスト以下に抑えることを推奨しています。429 レスポンスには retry-after が含まれます。

実行

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

Docker イメージ: ghcr.io/borgels/mcp-server-action1（main へのプッシュ時に公開）。

デプロイ

deploy/ には、docker-compose サービスブロック、hosts.json エントリ、リバースプロキシ サイトブロック、および環境変数のサンプルファイルがあります — 公開したい Action1 組織ごとに1インスタンスを、 フリートの前面にある OAuth 対応ゲートウェイ/リバースプロキシの背後に配置します。