runZero MCP

runZero + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するすべてのエージェント向け

非公式です。runZero API 向けにコミュニティが構築した Claude Code スキルおよび MCP サーバーです。runZero, Inc. とは提携、推奨、スポンサー関係にありません。

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

あらゆる runZero クエリに加え、攻撃対象領域全体のローカル SQLite コピーを利用できます。時間経過による差分を確認し、オフラインでアセットと脆弱性を結合でき、再度切り出す際に API の割り当てを消費しません。すでにお使いの AI で動作します - ChatGPT（Plus/Pro+。このコネクターが再公開されるまで一時停止中です。詳細は mcp-install.md をご覧ください）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot に加え、リモート経由で Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応します。無料のオープンソースで、ノート PC 上で動作します。MSP のオーナー向けに構築されています。コーディングは不要です。

エージェントでの利用

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

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

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

ChatGPT にはリモート HTTPS サーバーが必要です。そのため、このコネクターの HTTP モードが必要になりますが、コネクターが再公開されるまで一時停止中です。このビルドでは HTTP モードはパスワードを求めず、すべてのネットワークインターフェースで待ち受け、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意をご覧ください。

Microsoft と Google のスタックの場合も

大きな導入実績がありますが、正直にお伝えすると、こちらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリではありません。

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

スキルネイティブなエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。以下のインストール手順をご覧ください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。各ツールの詳細な接続手順は、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 で起動します。すべてのツールは付属の runzero-cli を呼び出します。2026-09-18 以降のリリースには、バンドル内にこの CLI が含まれています。それより前のバンドルには MCP サーバーのみが含まれているため、付属の CLI がない場合は、まず以下の Path A または Path B のインストーラーを実行するか、RUNZERO_CLI_PATH に既存のバイナリへのパスを設定してください。詳細： #331。

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

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリの一覧表示は不要で、すぐに使えます。

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

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

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください。

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

シェルを実行できるエージェントであれば、どれでも同じプロンプトを使えます。

Path B — インストーラーを自分で実行する

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

runzero-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で選択し直してください。Claude Code プラグインのユーザー：/plugin update runzero@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 では「設定」>「拡張機能」パネルを使うのが最も簡単です。JSON を編集したいユーザー向けの MCP 設定ブロックは、mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から実行します。

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

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

/skills install servosity/msp-skills/skills/runzero --force

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

OpenClaw にインストールする

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

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

OpenClaw はまだ一般公開されていません。frontmatter による接続設定はあらかじめ組み込まれており、OpenClaw の公開と同時に有効になります。

認証する

runZero ポータルから取得した認証情報を設定します。

RUNZERO_API_KEY=<value> runzero-cli doctor

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

このスキルでできること

MSP からよく寄せられる質問	コマンド
現在、最もリスクにさらされている資産はどれですか？	runzero-cli triage --agent
インターネットに公開されている資産だけに絞れますか？	runzero-cli triage --internet-facing --agent
先週から攻撃対象領域にどのような変化がありましたか？	runzero-cli diff --since 7d
前回の同期以降、新たに露出した、または脆弱になったものは何ですか？	runzero-cli exposure-delta --agent
特定の CVE の影響を受ける資産はどれですか？	runzero-cli affected "CVE-2024-3094" --agent
サブネット内でリスクの高いサービスが集中している場所はどこですか？	runzero-cli exposure-map "10.0.0.0/8" --agent
まもなく期限切れになる TLS 証明書、または暗号強度の低い暗号を使用している証明書はどれですか？	runzero-cli certs-expiring --days 90 --weak
古くなっている、サポート終了している、または所有者が設定されていない資産はどれですか？	runzero-cli stale --days 90 --json
特定のソフトウェア製品を実行している資産は、バージョンごとに何件ありますか？	runzero-cli software rollup "openssl" --agent

上記のコマンドはすべてローカルの SQLite コピーを参照します。まず runzero-cli inventory sync を一度実行してください。diff と exposure-delta で比較するスナップショットが 2 つ必要な場合は、2 回実行してください。

コマンドの詳細については、guide.md を参照してください。AI エージェントの運用規約（--agent、--dry-run、変更を加える前に確認するタイミング）については、AGENTS.md を参照してください。

このスキルの特長

多くの runZero インテグレーションや MCP サーバーは、質問のたびにライブ API を呼び出します。単一レコードを取得する用途には適しています。しかし、「脆弱なサービスを実行している重要な資産はどれか」といった質問を大規模に処理する場合には対応できません。runZero の API はエンティティ単位（/org、/account、/export）のため、この質問には 3 回の呼び出しと手動での結合が必要になるからです。

このスキルは、runZero のデータを全文検索機能付きのローカル SQLite ミラーに同期します。集計を伴う質問はローカル SQL の結合 1 回で処理できるため、即座にオフラインで結果を得られ、AI には生データではなく回答が渡されます。triage、affected、exposure-delta などの複合コマンドは、資産、サービス、脆弱性をまとめて一度に結合します。これはステートレスな API ラッパーでは実現できません。また、inventory sync のたびにスナップショットが作成されるため、diff と exposure-delta で 2 時点のデータを比較できます。ライブ API ラッパーでは、この比較はまったくできません。

この問題を解決します

「見えないものは守れない」という言葉が r/msp で繰り返されるのには理由があります。資産インベントリは実態とずれ、シャドー IT は予告なく現れ、重要な問いは決して単一の資産についてではありません。複数のエンティティをまたぐ問いです。どの重要なマシンがこの脆弱なサービスを実行しているのか、先週以降に新たに開いたポートは何か、新しい CVE の影響を実際に受けるホストはどれか。runZero はすべてを検出しますが、API からは一度に 1 つのエンティティしか取得できないため、3 つのエクスポートを手作業で結合したスプレッドシートに答えが埋もれてしまいます。

このスキルは、環境全体をローカルに同期し、複数のエンティティをまたぐ問いに直接答えることで、そのギャップを埋めます。

• 露出しているものを優先順位付けする - runzero-cli triage --agent は、重要度、サービス、脆弱性を一度に結合します。
• 変更点を確認する - runzero-cli diff --since 7d と runzero-cli exposure-delta --agent で、同期間の変化や新たに露出したサービスを確認できます。
• CVE の影響範囲を追跡する - runzero-cli affected "CVE-2024-3094" --agent は、影響を受けるすべての資産とそのサービス、重要度を一覧表示します。
• 衛生管理の残作業を整理する - runzero-cli stale --days 90 --json は、未確認、サポート終了、所有者不明の資産を分類し、一括コマンドに渡せる ID を出力します。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

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

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

はい。いずれも MCP に対応しています。ツールごとのインストールコマンドは、上記の表と docs/which-agent.md の詳しい説明をご覧ください。

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

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

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

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

runZero API のクォータを消費しますか？

API を呼び出すのは inventory sync とライブクエリのみです。エンティティをまたぐ分析である triage、diff、affected、exposure-map、exposure-delta、certs-expiring、software rollup は、すべてローカルの SQLite コピーに対して実行されます。そのため、攻撃対象領域を 100 通りに切り分けて分析しても、API 呼び出しは追加で一切発生しません。

セルフホストの runZero でも使えますか？

はい。デフォルトではホスト型コンソール console.runzero.com を使用しますが、RUNZERO_BASE_URL で独自のコンソールを指定できます。同じ API トークンのスコープが適用されます。

どのトークンのスコープが必要ですか？

読み取り／エクスポート用トークン（Export ET、Organization OT、または Account CT キー）があれば、inventory sync とすべての分析コマンドを実行できます。scan-watch または org create-scan でスキャンを開始するには、スキャン権限のあるトークンが必要です。認証情報のスコープは、ワークフローで使用する機能に必要な範囲だけに設定してください。

これは runZero コンソールに取って代わるものですか？

いいえ。検出の信頼できる情報源は、引き続きコンソールと API です。このスキルは、API では一度の呼び出しで取得できない、エンティティを横断するオフラインレイヤーを追加します。特定時点の差分、CVE から資産への影響範囲、エクスポージャーのランキングなどを使い、AI がセキュリティに関する質問へ一度の手順で回答できるようにします。

費用はかかりますか？

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

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り	triage、diff、affected、exposure-delta、exposure-map、stale、certs-expiring、software rollup、search、inventory list / status、および以下のシークレットを返す読み取りを除く、シークレットを含まない account / org の get-* レポート（assets、sites、services、tasks、organizations、users）	許可
書き込み（通常）	inventory sync（ローカルコピーを書き込みます）、org create-site、org create-scan、scan-watch（これらは対象に対して実際のネットワークスキャンを実行します）、import / runzero-import、資産のタグ／所有者の更新	--dry-run でプレビューし、確認後に書き込みます
認証情報／破壊的操作／設定	シークレットを返す読み取り（トークンを発行する account get-apitoken、get-credential / get-credentials、get-key / get-keys、get-organization-export-token / -tokens）、すべての認証情報とキーの書き込み（create-credential、create-key、rotate-key、reset-user-password / reset-user-mfa）、およびすべての delete-* / remove-* と org の一括消去操作	必ず人間が介在

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

ステータス

ベータ版です。runZero 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。