Action1 MCP

Action1 + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。Action1 API 用の、コミュニティが開発した Claude Code スキルおよび MCP サーバーです。Action1 Corporation とは提携しておらず、同社による承認や後援も受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されているコマンドはすべて、実際の CLI で使用できます。}

すべての Action1 エンドポイントに加え、すべての組織を横断したフリート全体のパッチおよび脆弱性ビューを利用できます。すでにお使いの AI に対応しています - ChatGPT（Plus/Pro+、このコネクターが再発行されるまで一時停止中です。mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに対応し、リモート経由ではMicrosoft 365 Copilot / Copilot StudioやGoogle Geminiにも対応します。無料のオープンソースで、ノートパソコン上で動作します。MSP オーナー向けに構築されています。コードは不要です。

お使いのエージェントで利用できます

セキュリティに関する注意（このコネクターが再発行されるまで）。 HTTP モード （--transport http）は、localhost 上であっても実行しないでください。このビルドにはパスワードがなく、 すべてのネットワークインターフェースで待ち受けます。また、ブラウザーのリバインディング対策が導入される前のものなので、 開いたウェブページからアクセスされる可能性があります。MCP ツールは、ユーザーの認証情報を使って変更を加えることもできます。 デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定した場合は、 停止してください。修正版は準備中です。

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスで、現在利用可能）：

お使いの AI エージェント	Action1 スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で action1-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再発行されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードがなく、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスされる可能性があります。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に action1-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、コネクターが再発行されるまで一時停止中です。このビルドの HTTP モードにはパスワードがなく、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスされる可能性があります。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタックにも対応

大規模なインストールベースがありますが、正直にお伝えします。これらは、インストールしたばかりのローカルバイナリではなく、リモート／エンタープライズ向けの方法です。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再配布されるまで一時停止しています。Copilot Studio には HTTP モードが必要ですが、このビルドの HTTP モードはパスワードなしで、すべてのネットワークインターフェイスで待ち受け、開いたウェブページからアクセスできる設定を求めます。mcp-install.md のセキュリティに関する注意事項をご覧ください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作するため、ChatGPT と同じく一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み取り、MCP にも対応しています。以下のインストールセクションをご覧ください。また、MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの詳しい設定方法は、**docs/which-agent.md**をご覧ください。

複数のエージェントを使っていますか？ 1 つのコマンドで、対応する51以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。続いて、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md をご覧ください。

60秒でインストール

Claude Desktop に最速でインストールする方法 - ワンクリック .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは同梱の action1-cli を呼び出します。2026-09-18以降のリリースでは、この CLI がバンドルに含まれています。それ以前のバンドルには MCP サーバーのみが含まれるため、同梱の実行ファイルがない場合は、先に以下のパス A またはパス B のインストーラーを実行するか、既存のバイナリを ACTION1_CLI_PATH に設定してください。詳細： #331。

Action1 MCP をダウンロード（.mcpb） - 次に Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（すべての Action1 リリースはリリースページで確認できます。）

Claude Code プラグインをお使いですか？マーケットプレイスを一度追加してからインストールすれば、ディレクトリ一覧は不要ですぐに使えます：

/plugin marketplace add Servosity/msp-skills
/plugin install action1@msp-skills

パス A - AI エージェントにプロンプトを1つ貼り付ける（推奨）

Claude Code、Codex CLI、または Claude Cowork に以下をコピーします：

このエージェントのワークスペースに、Servosity/msp-skills から Action1 スキルと MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使用している場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/action1/install.sh) を実行してください。Windows PowerShell を使用している場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/action1/install.ps1 | iex を実行してください。その後、README に従って認証し、action1-cli --help を実行して使い方を確認してください。

シェルを実行できるエージェントなら、同じプロンプトを使えます。

パス B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/action1/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/action1/install.sh)

インストーラーは、action1-cli（CLI）と action1-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じてスキルを検出します。

確認：

action1-cli --version

最新バージョンにアップグレード

インストーラーは常に最新リリースを取得します。アップグレードするには、もう一度実行してください：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/action1/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/action1/install.ps1 | iex

Claude Desktop の .mcpb をお使いの場合：最新の .mcpb（このセクションの上部）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインをお使いの場合：/plugin update action1@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、またはその他の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md を参照してください。GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot／Copilot Studio の手順も、各エージェントのセクションに記載されています。Claude Desktop では、Settings > Extensions パネルから設定するのが最も簡単です。JSON を手動で編集する場合の MCP 設定ブロックは、mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から実行します。

hermes skills install servosity/msp-skills/skills/action1 --force

Hermes のチャットセッション内で実行します。

/skills install servosity/msp-skills/skills/action1 --force

Hermes は MCP をネイティブにサポートしているため、action1-mcp サーバーも直接使用できます。インストール手順と環境変数は同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

https://github.com/servosity/msp-skills/tree/main/skills/action1 から action1 スキルをインストールしてください。このスキルでは、必要な CLI（action1-cli）を openclaw: フロントマターブロック経由でインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの接続設定はあらかじめ含まれており、OpenClaw の公開と同時に有効になります。

認証する

CLI に必要な認証情報を設定します（Action1 ポータルから取得してください）。

ACTION1_CLIENT_ID=<value> ACTION1_CLIENT_SECRET=<value> ACTION1_REGION=<value> action1-cli doctor

doctor は、データを操作するコマンドを実行する前に、認証情報が機能することを確認します。認証情報が拒否された場合でも終了コードは 0 になるため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく寄せられる質問	コマンド
すべてのクライアントのエンドポイントのうち、パッチが最も不足しているのはどれですか？	action1-cli fleet patch-posture
CVE の影響を受けているマシンが最も多いのはどれですか？深刻度と KEV による重み付けもできますか？	action1-cli fleet vuln-triage --kev-only
フリート全体でチェックインが停止しているエージェントはどれですか？	action1-cli fleet stale --days 14
クライアント組織ごとのパッチと脆弱性の状況はどうなっていますか？	action1-cli fleet org-scorecard
パッチサイクルを完了するために、再起動待ちのエンドポイントはどれですか？	action1-cli fleet reboot-pending
更新、CVE、再起動、古さに基づいて、すべてのエンドポイントを総合リスク順に並べる	action1-cli fleet health-score
バージョンごとに重複を除いた、フリート全体にインストール済みのソフトウェアは何ですか？	action1-cli fleet software-rollup
1 つのクライアント組織で管理されているエンドポイントを一覧表示する	action1-cli endpoints managed <orgId>

コマンドの全リファレンスは guide.md を参照してください。AI エージェントの運用契約（--agent、--dry-run、変更を加える前に確認すべき状況）については、AGENTS.md を参照してください。

このスキルの特長

多くの Action1 連携機能や MCP サーバーは、質問ごとに組織単位でライブ API を呼び出します。1 件のレコードを扱うなら問題ありません。しかし、40 社すべてのクライアントにまたがってパッチが最も遅れているエンドポイントや、今四半期に最も多くのマシンに存在する CVE を尋ねるような規模になると、組織ごとに分割された API では 1 回の呼び出しで回答できず、対応できません。

このスキルは、すべての組織を全文検索機能付きのローカル SQLite ミラーに同期します。集計に関する質問は 1 回のローカルクエリで処理できるため、即座にオフラインで回答でき、AI には生データではなく回答が渡されます。fleet patch-posture、fleet vuln-triage、fleet org-scorecard などの組織横断的な集計では、すべての組織のエンドポイント、更新、脆弱性を一度に結合します。これは、ステートレスな API ラッパーでは実現できない処理です。

このギャップが解消する課題

r/msp のパッチ管理に関するスレッドでは、マルチテナントのパッチツールに共通する同じ課題が繰り返し取り上げられています。コンソールはクライアント組織ごとに整理されていますが、MSP のオーナーが答えなければならないのは、フリート全体に関する質問です。「最も更新が遅れているエンドポイントはどれか？」「どの CVE が広く影響しているか？」「このクライアントの QBR に記載するセキュリティ態勢の数値は？」Action1 では、組織を一つずつ切り替えるか、組織ごとにエクスポートしてスプレッドシートを統合する必要があります。クライアントごとのデータはありますが、すべての組織を一つのビューにまとめることはできません。

このスキルは、そのギャップを解消します。

• action1-cli fleet patch-posture - すべての組織の全エンドポイントを、未適用の更新プログラム数が多い順に表示します。
• action1-cli fleet vuln-triage --kev-only - CVE を影響範囲の大きさ（CVSS + CISA KEV）順に表示します。
• action1-cli fleet org-scorecard - クライアント組織ごとにセキュリティ態勢を1行で表示し、QBR に記載する数値をすぐに確認できます。
• action1-cli fleet stale --days 14 - すべての組織で応答のないエージェントを、カバレッジから外れる前に検出します。
• action1-cli fleet reboot-pending - パッチサイクルを完了するためのフリート全体のアクションキューを表示します。

詳しい説明については、pain-point.md を参照してください。

MCP サーバー経由のリモートデスクトップ

MCP では、Action1 のリモートセッション API がすでに公開されています。API 認証情報には、対象エンドポイントの組織またはエンドポイントグループに対する Remote Connect 権限が必要です。スクリプトを実行する権限があっても、デスクトップに接続する権限があるとは限りません。認可された管理者は、意図するスコープを指定して、認証情報に既存のロールへ Remote Connect を追加できます。403 エラーはアクセス拒否を意味し、MCP ツールが存在しないことを示すものではありません。

コードオーケストレーションを行うクライアントの場合：

1. start remote session を指定して action1_search を呼び出します。

2. エンドポイント ID endpoints.managed-id-remote-sessions-post と、以下のパラメーターを指定して action1_execute を呼び出します。

   {"orgId":"<organization-id>","endpointId":"<endpoint-id>","connection_type":"assistance"}
   

3. 返された id を使い、orgId、endpointId、sessionId を指定して endpoints.managed-id-remote-sessions-session-id-get を呼び出します。最大1分間、たとえば5秒ごとにポーリングし、API エラーが発生したら停止します。タイムアウトは接続が確認できなかったことを意味します。別のセッションを自動的に作成しないでください。

4. connected が yes になったら、返された remote_session URL をブラウザーで開きます。操作する前に、意図したエンドポイントのデスクトップが表示されていることを確認してください。この接続 URL は他人に知られないようにしてください。

同等の開始コマンドは次のとおりです。

action1-cli endpoints managed-id-remote-sessions-post <orgId> <endpointId> --connection-type assistance --json

現在、API がサポートしている接続タイプは assistance です。セッションを開始しても、デスクトップの入力が自動化されるわけではありません。操作にはブラウザー、またはエージェントに認可されたコンピューター操作ツールを使用してください。Action1 リモートセッション API と API 認証情報のロールを参照してください。

MCP サーバー経由のソフトウェアインストーラーパッケージ

MCP はすでに、Software Repository のパッケージとバージョンの読み取りおよび更新に対応しています。API キー認証はブラウザー／Entra SSO とは別です。コンソールへのサインインに失敗しても、パッケージ API が利用できないとは限りません。

• orgId はスコープを選択する値です。組織 ID を指定するとその組織のビューを要求し、all を指定すると Enterprise スコープを要求します。一部の Enterprise 共有パッケージは組織ビューから読み取れますが、これは Enterprise の書き込み権限があることを意味しません。Enterprise 共有パッケージを更新する場合は、all を使用してください。
• 読み取りには、指定したスコープの View Software Repository 権限が必要です。更新には、パッケージのスコープで Manage Software Repository 権限が必要で、これには View が暗黙的に含まれます。バージョンの PATCH では、approval_status に Approve Updates 権限が必要で、EULA_accepted には API の accept_eula 権限が必要です。スクリプトアクションにも、適切な Use Scripts スコープが必要です。組み込みパッケージのバージョンは変更できません。権限がある場合、管理者は認証情報に設定されている既存のロールを拡張できます。HTTP 403 は権限またはスコープによる拒否であり、MCP エンドポイントが存在しないという意味ではありません。
• versionId はバージョンオブジェクトの id であり、表示される version ではありません。たとえば、id: "21.07.00.0_1640795090369" と version: "21.07.00.0" は別のフィールドを示します。推測せず、必ず現在の ID を確認してください。

コードオーケストレーションを行うクライアントの場合：

1. installer を指定して action1_search を呼び出し、パッケージとバージョンのツールを検索します。

2. エンドポイント ID software-repository.packages-all-package-id-get と以下の params を指定して、action1_execute を呼び出します。

   {"orgId":"<organization-id-or-all>","packageId":"<package-id>","fields":"versions"}
   

3. 選択したオブジェクトの versions[].id を取得します。orgId、packageId、その versionId を指定して software-repository.versions.packages-all-package-id-id-get を使用し、構成を読み取ります。

4. 既存の構成を保持し、許可されている範囲で最小限の更新を準備します。パッケージのメタデータには software-repository.packages-all-package-id-patch を使用し、インストーラーのデプロイ構成には software-repository.versions.packages-all-package-id-id-patch を使用します。同じ識別子と、編集可能なバージョンプロパティのうち編集したものだけを action1_execute に渡します。たとえば、プロパティは params に直接指定します。

   {"orgId":"<organization-id-or-all>","packageId":"<package-id>","versionId":"<returned-version-id>","silent_install_switches":"<reviewed silent-install switches>"}
   

   フィールド名と型は、ベンダー API リファレンスにある Windows または Mac のバージョン PATCH スキーマを使用してください。GET レスポンス全体をそのまま渡したり、プロパティを body-json の下にネストしたりしないでください。このフラグは同等の CLI コマンド用で、更新オブジェクトは --body-json または --stdin で受け取ります。

5. 更新後にパッケージ／バージョンを読み返します。書き込みが成功しても、エンドポイントへのインストールやデプロイが確認されたことにはなりません。

拡張パッケージデータおよびリポジトリの権限を参照してください。

よくある質問

ChatGPT で使用できますか？

このビルドでは使用できません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode が利用できません）が接続できるのは、HTTPS 経由の リモート MCP サーバーのみです。つまり、Action1 MCP サーバーを HTTP モードで実行する必要があります。このビルドでは、HTTP モードはパスワードを要求せず、すべてのネットワークインターフェイスで待ち受け、開いた Web ページからアクセスできます。そのため、コネクターを再公開するまでは、実行したりトンネルの背後に置いたりしないでください。その理由については、mcp-install.md のセキュリティに関する注意事項を参照してください。それまでは、Claude Desktop、Claude Code、または Codex を使用してください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使用できますか？

はい。どれも MCP に対応しています。複数のツールで使えるインストールコマンドは上記の表に、詳細な説明はこちらにあります。

コーディングの知識は必要ですか？

いいえ。推奨するインストール方法は、Claude Code または Codex に一文を貼り付けることです。エージェントが SKILL.md を読み込んでインストールします。代替方法として、OS ごとの1行インストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。Action1 の認証情報を一度入力するだけです。

Action1 のデータは安全ですか？

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーは、ユーザーアカウント配下のディレクトリに置かれます。AI エージェントに表示されるのは CLI が返す情報だけです。通常はクエリ結果であり、生の一括データではありません。認証情報は環境またはエージェントの設定から読み込まれます。MSP Skills に含められたり、どこかに送信されたりすることはありません。

必要な Action1 のリージョンと認証情報は何ですか？

Action1 コンソールの API Credentials ページで作成した API クライアント（Client ID と Client Secret）に加え、コンソールの URL に合わせて ACTION1_REGION を us、eu、または au に設定する必要があります。CLI はこれらを /oauth2/token に POST し、ベアラートークンを発行して更新します。レポート作成のみが必要な場合は、クライアントに読み取り専用の権限テンプレートを適用してください。詳しくは governance.md をご覧ください。

これは Action1 コンソールの代わりになりますか？

いいえ。自動化の設定やパッチの対話的な承認には、引き続きコンソールを使用します。このスキルは、コンソールでは一度に1つの組織しか表示されない、複数組織にまたがる質問（デバイス群のパッチ適用状況、CVE の影響範囲、クライアントごとのスコアカードなど）に回答し、AI エージェントからターミナル上で実行できるようにします。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。お使いの AI エージェント（Claude、ChatGPT、Codex など）の料金のみがかかります。料金は当社ではなく、AI プロバイダーから請求されます。

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	fleet patch-posture、fleet vuln-triage、endpoints managed <orgId>、search、export、doctor	許可
書き込み（定型）	endpoints groups、endpoints managed-id-patch、settings org-id-post、automations policies-schedules-org-id-post、import	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
エンドポイント／パッチの実行	automations policies-instances-org-id-post（自動化を実行）、updates approvals updates-org-id、endpoints managed-id-remote-sessions-post、scripts org-id-post	人間の介在が必要。無人では実行しない
認証情報／セキュリティ	oauth2（トークンを発行）、users post、roles post、roles id-patch	人間の介在が必要
破壊的操作／アカウント	endpoints managed-id-delete、organizations org-id-delete、users id-delete、enterprise request-closure	人間の介在が必要。明示的な確認を行う

最も強力な制御は、Action1 の認証情報に付与するスコープです。CLI が実行できるのは、その認証情報に許可された操作だけです。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Action1 API の仕様に照らして検証済みで、毎週の Build Sessions では、MSP が本番テナントで実際に稼働させながら検証を進めています。compoundingteams.com/build-sessions から参加をお申し込みください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025年12月、40以上のエージェント）に準拠しています。MCP 互換で、Hermes を含む MCP 対応エージェントで動作します。OpenClaw 対応済みです（フロントマター設定済み。OpenClaw のリリース待ち）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-06-06.