ImmyBot MCP

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

非公式です。ImmyBot API 向けの、コミュニティが開発した Claude Code スキルおよび MCP サーバーです。ImmyBot, LLC との提携、承認、または後援を受けていません。

_{スキルの全ページ - インストール方法、効果、安全性モデル。}

ImmyBot のすべてのエンドポイントに型を定義し、ウェブ UI では答えられないテナント横断の質問に対応するローカル SQLite ミラーも備えています。すでにお使いの 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 エージェント	ImmyBot スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から immybot-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターを再発行するまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードを求めません。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーに immybot-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの 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 で起動します。各ツールは、同梱の immybot-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドル内に含まれています。それ以前のバンドルに含まれるのは MCP サーバーのみです。同梱ツールが見つからない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを IMMYBOT_CLI_PATH に設定してください。詳細： #331。

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

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

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

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

これを Claude Code、Codex CLI、または Claude Cowork にコピーします。

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

インストーラーは、immybot-cli（CLI）と immybot-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリにある SKILL.md から Skill を検出します。

確認：

immybot-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update immybot@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/immybot --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/immybot --force

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

OpenClaw にインストールする

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

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

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

認証

ImmyBot ポータルで確認できる、CLI に必要な認証情報を設定します。

export IMMYBOT_SUBDOMAIN=acme          # the "acme" in acme.immy.bot
export IMMYBOT_TENANT_ID=<entra-tenant-guid>
export IMMYBOT_CLIENT_ID=<entra-app-client-id>
export IMMYBOT_CLIENT_SECRET=<entra-app-client-secret>
immybot-cli doctor

ImmyBot は独自の API キーを発行しません。Microsoft Entra ID にアプリを登録してクライアントシークレットを作成し、そのエンタープライズアプリケーションのオブジェクト ID を ImmyBot 内で管理者ユーザーとして追加します（Show More > People > New > AD External ID）。IMMYBOT_SUBDOMAIN は必須です。これは OAuth スコープの生成に使われ、設定しない場合、トークンリクエストは自身のアプリ登録を指定するスコープにフォールバックし、Entra に拒否されます。

doctor は設定、パス、API 到達性を確認した後、/auth/me に対する認証済み読み取りを 1 回実行して認証情報自体を検証します。結果として valid、invalid (HTTP 401)、または scope-limited (HTTP 403) を報告します。認証情報が拒否されても終了コードは 0 になるため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく尋ねられる質問	コマンド
昨夜のメンテナンス時間帯に何が失敗し、その原因は何ですか？	immybot-cli session-triage --since 24h
Chrome のバージョンがまだ古いテナントはどれですか？	immybot-cli version-spread "Google Chrome" --min-version 140
このマシンにデプロイメントが一度も適用されなかったのはなぜですか？	immybot-cli assignment-explain 4821
昨夜からフリートで実際に何が変更されましたか？	immybot-cli fleet-diff --snapshot を 1 回実行し、その後 immybot-cli fleet-diff --since 24h
オンボーディングが途中で止まっているコンピューターはどれですか？	immybot-cli onboarding-stalled --older-than 3d
この共有スクリプトを編集する前に、どこまで影響が及ぶか確認できますか？	immybot-cli script-blast-radius "Install Chrome"
一度も成功していないデプロイメントはどれですか？	immybot-cli deployment-health --only-failing
ImmyBot にはあるものの、PSA には存在しないコンピューターはどれですか？	immybot-cli psa-reconcile
このマシン 1 台の全履歴をまとめて確認するにはどうすればよいですか？	immybot-cli computer-dossier WS-01

コマンドの詳細については、guide.md を参照してください。AI エージェントの運用契約（--agent、--dry-run、変更前に確認が必要な場合）については、AGENTS.md を参照してください。

このスキルの特長

ImmyBot の多くの連携や MCP サーバーは、質問のたびにライブ API 呼び出しを行います。1 件のレコードを確認するなら問題ありません。しかし、40 社のクライアントのうち Chrome のビルドが 140 未満のままなのはどれか、といった質問では、テナントごと、タイトルごとに API を 1 回呼び出す必要があり、比較に使える履歴を ImmyBot が保持していないため、大規模な環境では対応できなくなります。

このスキルは ImmyBot のデータを、全文検索に対応したローカルの SQLite ミラーに同期します。集計が必要な質問は、ローカルでの SQL 結合 1 回で処理できるため、即座に、オフラインでも実行でき、AI には生データではなく回答が渡されます。session-triage、version-spread、assignment-explain のような複合コマンドでは、メンテナンスセッション、アクション、コンピューター、テナント、ソフトウェアインベントリ、ターゲット割り当てをまたいでデータを結合できます。これはステートレスな API ラッパーでは実現できない処理です。

解消する課題

ImmyBot のコミュニティスレッドや r/msp の導入に関する議論では、同じ問題が繰り返し話題になります。プラットフォームはマシンへのソフトウェア配布には優れていますが、その翌朝の対応には役立ちません。数百台のエンドポイントにまたがるメンテナンスウィンドウで一部が失敗すると、コンソールにはマシンごとに同じエラーテキストが表示されるだけで、グループ化も根本原因も、「壊れているのはパッケージ1つなのか、エージェント40台なのか」と尋ねる手段もありません。さらに厄介なのは、テナントをまたぐ質問です。どのクライアントがまだ最低バージョンを下回っているのか、隣のマシンには適用されたのに、なぜあるマシンにはデプロイが適用されなかったのか、夜間に何が変わったのか。ImmyBot は比較用の履歴を保持しないため、現時点での誠実な答えはスプレッドシートです。

• session-triage --since 24h - 一晩に発生したアクションの失敗を根本原因ごとにまとめるため、同じ失敗を40回読む必要がありません。
• version-spread "Google Chrome" --min-version 140 - 実際の semver 比較を使い、文字列順ではなく、すべてのテナントにおける1つのタイトルをランク付けします。
• assignment-explain 4821 - 1台のコンピューターに解決されるすべてのターゲット割り当て、一致したスコープ、優先度の低いルールを表示します。「なぜこのマシンには適用されないのか？」への答えです。
• fleet-diff --since 24h - API が保持しない履歴をもとに、2回の同期の間に実際に何が変わったかを表示します。ImmyBot は更新日時を指定するカーソルを公開していないため、ローカルスナップショットと比較します。初回のベースラインを記録するには、同期後に immybot-cli fleet-diff --snapshot を実行してください。次回の同期以降、比較できるようになります。
• deployment-health --only-failing - 一度も成功していないデプロイを表示します。アラートが一度も発生しないために気づかれない失敗です。

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

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode が公開されていません）は、HTTPS 経由のリモート MCP サーバーにのみ接続します。つまり、ImmyBot MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードではパスワードが要求されないため、コネクターを再公開するまでは実行したり、トンネルの背後に配置したりしないでください。その理由については 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）を用意しています。どちらの方法でもコードを書く必要はありません。ImmyBot の認証情報を一度入力するだけです。

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

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

ImmyBot のパートナーまたは MSP の顧客である必要がありますか？

ImmyBot のインスタンスと、そのインスタンスが信頼する Microsoft Entra テナントにアプリを登録する権限が必要です。このスキルが行う処理はすべて、ご自身のインスタンス内に作成した管理者として実行されます。

ImmyBot API のレート制限に達しますか？

API に一括でアクセスするコマンドは sync のみで、スケジュール設定するのもこのコマンドです。上記のテナント横断ビューはすべてローカルの SQLite ミラーを読み取るため、同じ質問を10回しても API 呼び出しは発生しません。

これは ImmyBot コンソールに置き換わりますか？

いいえ。デプロイ、承認、望ましい状態の構成はコンソールに残ります。これはコンソールにない読み取りレイヤーです。テナントをまたいだ結合、根本原因によるグループ化、差分比較できる履歴を提供します。

費用はいくらですか？

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

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	session-triage、drift、version-spread、fleet-diff、assignment-explain、および以下の認証情報の読み取りを除く、その他すべての list / get	許可
エンドポイントおよびフリートでの実行	scripts create-run-adhoc-metascript（指定したマシンで、指定したスクリプト本文を実行）、run-immy-service、maintenance-actions create-latest-action-for-tenants、schedules create-bulk-run-now、computers registry create-keys、target-assignments create、software create-global-upload	人間による確認を必須とし、明示的な確認を得る
書き込み（データ）	tenants create、persons create、tags create、preferences update-application、import	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報／セキュリティ	auth login、oauth get-access-tokens、access get-get-azure-tenant-auth-details-by-azure-tenant-principal-id（シークレットを返す読み取り操作）、roles create	人間による確認を必須とする
破壊的操作	computers create-bulk-delete、scripts delete-global-by-id、software delete-global-by-identifier、brandings delete-by-id	人間による確認を必須とし、明示的な確認を得る
ローカル設定	profile save、auth logout、sync、export、feedback	許可（サーバーには影響しません）

ImmyBot は実際のクライアントマシンにソフトウェアをデプロイし、メンテナンスを実行します。そのため、最も注意が必要なのは エンドポイントおよびフリートでの実行 ティアです。1 回の create-latest-action-for-tenants で、テナント内のすべてのコンピューターに処理が及びます。

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

ステータス

実環境で検証済みです。@geekbrownbear（MSP）が自身の本番テナントで確認しました（確認記録）。ほかの MSP も、毎週開催される Build Sessions で実環境での運用を行っています。参加登録は compoundingteams.com/build-sessions からどうぞ。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP と互換性があり、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw 対応済みです（フロントマターは事前設定済みで、OpenClaw の公開を待っています）。

Servosity が保守しています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-08-22。