MSPbots MCP

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

非公式です。MSPbots API 向けにコミュニティが開発した Claude Code Skill および MCP サーバーです。 MSPbots, Inc. とは提携、推奨、後援の関係にありません。

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

私たちが見つけた初の MSPbots ツール（2026 年 6 月）です。読みやすいフィルター、エイリアス名のリソース、完全なエクスポート、そして MSPbots 自体では保持されない KPI 履歴を備えています。すでにお使いの 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 上でも実行しないでください。このビルドにはパスワードがなく、すべてのネットワークインターフェースで待ち受け、ブラウザーの再バインディングを防ぐ仕組みが導入される前のものなので、開いた Web ページから接続できてしまいます。また、MCP ツールは認証情報を使ってデータを読み取ることができます。デフォルトの stdio トランスポートを使用してください。リモートエージェント向けにトンネルを設定している場合は、停止してください。修正を準備中です。

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

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

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

Microsoft および Google のスタック向け

大きなインストールベースですが、正直なところ、これらはリモート／エンタープライズ向けの方法であり、今インストールしたローカルバイナリではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再配布されるまで一時停止中です。Copilot Studio には HTTP モードが必要ですが、このビルドではそのモードにパスワードが不要で、すべてのネットワークインターフェイスで待ち受け、開いた Web ページからアクセスできます。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 で起動します。すべてのツールは、付属の mspbots-cli を呼び出します。2026-09-18 以降にリリースされたバンドルには、この CLI が同梱されています。それ以前のバンドルには MCP サーバーしか含まれていません。付属の CLI がない場合は、先に以下のパス A またはパス B のインストーラーを実行するか、MSPBOTS_CLI_PATH に既存のバイナリを設定してください。詳細： #331。

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

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

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

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

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

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

このプロンプトは、シェルを実行できるすべてのエージェントで使えます。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

mspbots-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

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

/skills install servosity/msp-skills/skills/mspbots --force

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

OpenClaw にインストールする

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

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

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

認証する

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

MSPBOTS_API_KEY=<value> mspbots-cli doctor

doctor は設定、パス、API の到達可能性を確認し、認証情報が読み込まれているかを報告します。MSPBots API には引数なしで呼び出せる GET エンドポイントがないため、doctor はキー自体を検証できません。正常であると断言する代わりに not verified と表示します。キーが実際に使えることを確認するには、読み取りコマンドを実行してください。

このスキルでできること

MSP からよく寄せられる質問	コマンド
未処理チケットのバックログは先週と比べて増えていますか、減っていますか？	mspbots-cli trend open_tickets --agg count
前回のスナップショットから未処理チケットにどのような変化がありましたか？	mspbots-cli diff open_tickets
6 月 1 日以降に更新された未処理チケットを取得する	mspbots-cli pull open_tickets --where "Update Date >= 2026-06-01"
このデータセットにはどのような列と型がありますか？	mspbots-cli describe open_tickets
QBR 資料用にデータセット全体を CSV にエクスポートする	mspbots-cli export open_tickets --format csv
今日の KPI スナップショットを記録する（スケジュールして履歴を蓄積）	mspbots-cli snapshot open_tickets
19 桁の ID を貼り付けるのをやめて、データセットに一度だけ名前を付ける	mspbots-cli registry add open_tickets 1534956341424005122
API キーとリソースの紐付けは正しく機能していますか？	mspbots-cli doctor

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

このスキルの特長

比べる対象となる MSPbots ツールはありませんでした。2026 年 6 月時点で、MSPbots Public API 向けに公開された CLI、SDK、MCP サーバーは見つかりませんでした。また、薄いラッパーでは、この API の厄介な点がすべて引き継がれてしまいます。エンドポイントは 2 つ、リソース ID は 19 桁、フィルターはカンマ区切りでエンコードされ、一覧取得用エンドポイントもメタデータも履歴もありません。「バックログは先週と比べて増えていますか、減っていますか？」と尋ねた途端に行き詰まります。API が把握できるのは 現在 の状態だけだからです。

このスキルは、不足しているレイヤーをローカルに追加します。registry add を使うと、スノーフレーク ID の代わりにリソースへ名前を付けられます。pull --where "Update Date >= 2026-06-01" は、読みやすい条件式を API 通信用 DSL にコンパイルします。export はすべてのページを自動的に処理します。また、snapshot + diff + trend は、タイムスタンプ付きのコピーをローカルの SQLite ストアに保存します。MSPbots 自体では保持されない KPI 履歴を、API 呼び出しなしでオフライン計算できます。

解決する課題

MSPbots 独自の Public API ドキュメント（wiki.mspbots.ai の Public API 記事、2024 年 4 月にアーカイブ）には、プログラムから利用できる機能がすべて記載されています。GET エンドポイントは 2 つ、リソース ID は Settings > Public API から 1 つずつコピーする必要があり、フィルターはクエリパラメーター内のカンマ区切りルールとしてエンコードされ、レート制限の具体的な数値は明示されておらず、負荷の高いウィジェット取得では HTTP 502 が断続的に発生します。履歴機能も、一覧取得機能も、ツールもありません。curl の例すらありません。

そのため、MSPbots のダッシュボードを使っている運用マネージャーは、週次の推移を手作業で記録し続けます。月曜日にウィジェットのスクリーンショットを撮り、件数をスプレッドシートに貼り付け、これを繰り返します。誰かが忘れた週には、推移が途切れてしまいます。

• mspbots-cli snapshot open_tickets - 任意のデータセットまたはウィジェットのタイムスタンプ付きコピーをローカルの SQLite に保存します。スケジュールを設定すれば、履歴が蓄積されます。
• mspbots-cli trend open_tickets --agg count - スナップショットからオフラインで算出する、週次の推移です。
• mspbots-cli diff open_tickets - 任意の 2 つのスナップショット間で、行レベルの追加、削除、変更を表示します。
• mspbots-cli pull open_tickets --where "Update Date >= 2026-06-01" - 読みやすいフィルターをカンマ区切りの DSL に変換し、最初から正しく取得します。
• mspbots-cli export open_tickets --format csv - 全ページを自動取得してテーブル全体をエクスポートします。ページ上限に達した場合は、データが一部であることを示すフラグを正直に付けます。

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

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは HTTPS 経由のリモート MCP サーバーのみです。そのため、MSPbots 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 に一文を貼り付けるだけです。エージェントが SKILL.md を読み込み、インストールを行います。代替手段として、OS ごとの 1 行インストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。MSPbots の認証情報を一度入力するだけです。

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

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

MSPbots に書き込めますか？

いいえ。MSPbots Public API は読み取り専用です。データセットとウィジェットを取得するだけで、書き込みはできません。このスキルが書き込むのはローカルデータのみです。エイリアスの登録、スナップショット、およびご自身の SQLite ストア内の同期キャッシュが対象です。MSPbots テナントの内容を変更できるコマンドはありません。

どの認証情報が必要ですか？

MSPbots API キーが必要です。管理者が MSPbots アプリの Settings > Public API で作成し、各データセットまたはウィジェットをそのキーに紐付けます。環境変数 MSPBOTS_API_KEY を設定するか、mspbots-cli auth set-token を実行してください。紐付けがアクセス許可の境界となります。キーで読み取れるのは明示的に紐付けられたリソースのみで、全体に適用される Enable Public API の切り替え設定がすべてのアクセスを制御します。

取得前にデータセットを登録する必要があるのはなぜですか？

Public API には一覧取得エンドポイントがないため、キーに何が紐付けられているかを確認できません。Settings > Public API から各リソース ID を一度コピーし、mspbots-cli registry add open_tickets <resourceId> で登録すれば、その後はどのコマンドでもエイリアスを使えます。

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

API ではレート制限について説明されていますが、具体的な数値は公開されていません。CLI には --rate-limit によるスロットリング機能があり、export は --max-pages でページ取得の上限を設定し、上限に達した場合はその旨を報告します。また、履歴に関する質問（trend、diff）はすべてローカルのスナップショットを対象に実行されるため、スナップショットの取得後に API を呼び出すことはありません。

データセットだけでなく、ウィジェットにも対応していますか？

はい。pull、export、snapshot、describe、registry add はすべて --type widget を受け付けます。API に由来する例外が1つあります。measure レイヤーまたは calculate レイヤーを含むウィジェットは、Public API 自体でサポートされていません。

費用はいくらですか？

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

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り（ライブ API）	mspbots-cli pull、export、describe、dataset、widget、doctor	許可
ローカルのみの書き込み（テナントには一切アクセスしません）	mspbots-cli registry add、snapshot、sync — すべての書き込みはローカルの SQLite ストアに保存されます。API には書き込み用エンドポイントがありません	許可 — 安全にスケジュール実行できます
認証情報／ローカル設定	mspbots-cli auth set-token、auth logout、registry rm	必ず人間が確認して実行

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

ステータス

ベータ版です。MSPbots API の機能を対象に検証済みで、毎週開催される Build Sessions では、独自の本番テナントで実際に運用している MSP とともに検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025年12月；40以上のエージェント）に準拠しています。MCP 互換であり、Hermes を含む、MCP に対応したあらゆるエージェントで動作します。OpenClaw に対応済みです（frontmatter の設定は完了しており、OpenClaw のリリース待ちです）。

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