Kaseya BMS MCP

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

非公式です。Kaseya BMS API 向けにコミュニティが構築した Claude Code スキルおよび MCP サーバーです。Kaseya US LLC とは提携、承認、後援関係にありません。

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

Kaseya BMS 専用として初の CLI および MCP サーバーです。PSA の全機能に加え、オフライン同期、全文検索、ウェブのグリッドでは計算できないキュー、契約消化、未請求時間の分析機能を備えています。すでにお使いの 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 エージェント	Kaseya BMS スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から kaseya-bms-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再発行されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードが要求されず、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスされる可能性があります。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に kaseya-bms-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモートの HTTPS サーバーが必要です。そのため、このコネクターでは HTTP モードが必要になりますが、コネクターが再発行されるまで一時停止中です。このビルドでは HTTP モードにパスワードがなく、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスされる可能性があります。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 で起動します。すべてのツールは、付属の kaseya-bms-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドルに含まれています。それ以前のバンドルには MCP サーバーのみが含まれているため、お使いのバンドルに付属の CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、KASEYA_BMS_CLI_PATH に既存のバイナリへのパスを設定してください。詳細： #331。

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

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

/plugin marketplace add Servosity/msp-skills
/plugin install kaseya-bms@msp-skills

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

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

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

インストーラーにより、kaseya-bms-cli（CLI）と kaseya-bms-mcp（MCP サーバー）の両方がユーザーの bin パスに配置されます。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を使って Skill を検出します。

確認：

kaseya-bms-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

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

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

/skills install servosity/msp-skills/skills/kaseya-bms --force

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

OpenClaw にインストールする

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

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

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

認証する

Kaseya BMS が発行する JWT の有効期間は短いため、BMS の API ユーザー認証情報から JWT を生成し、CLI に保存させるのが最も簡単です。

export KASEYA_BMS_USERNAME="[email protected]"
export KASEYA_BMS_PASSWORD="<password>"   # env-only; never passed on the command line
export KASEYA_BMS_TENANT="yourmsp"        # your company/tenant name from My Settings
kaseya-bms-cli auth login                 # exchanges these for a JWT and saves it

すでに JWT をお持ちですか？ ログインを省略して、JWT を直接渡すこともできます。

KASEYA_BMS_TOKEN=<jwt> kaseya-bms-cli doctor

米国以外のテナントを使用する場合は、KASEYA_BMS_BASE_URL でリージョンを指定してください（デフォルトは https://api.bms.kaseya.com）。データにアクセスするコマンドを実行する前に、doctor で認証情報が有効か確認できます。コマンドで 401 Security Error が返されるようになった場合は、kaseya-bms-cli auth login を再実行してトークンを更新してください。認証情報が拒否された場合も終了コードは 0 になるため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく聞かれる質問	コマンド
朝会の前に、どのキューが滞っていて、何が古くなりつつありますか？	kaseya-bms-cli queue-health --agent
1 週間触れられていない未解決チケットはどれですか？ 古い順に表示してください。	kaseya-bms-cli stale-tickets --days 7 --agent
誰が過負荷で、次のチケットを担当できるのは誰ですか？	kaseya-bms-cli workload --agent
今四半期、各契約のどれくらいを消化しましたか？	kaseya-bms-cli contract-burn --window-days 90 --agent
請求準備ができている承認済みの請求可能時間は、アカウント別にどれくらいありますか？	kaseya-bms-cli unbilled --agent
ステージ別の未完了営業案件はいくつあり、遅延している案件はどれですか？	kaseya-bms-cli pipeline --agent
テナント全体から、特定のフレーズを含むチケットをすべて検索する	kaseya-bms-cli search "VPN outage"
テナントをローカルミラーに同期して、オフラインで即座に検索する	kaseya-bms-cli sync

これらに加えて、CLI はサービスデスク、CRM、契約、財務、プロジェクト、インベントリ、連携機能にまたがる 472 個のコマンドで、BMS の全機能をカバーします。

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

これが他と異なる点

Kaseya BMS の統合機能や MCP サーバーの多くは、質問のたびにライブ API 呼び出しを行います。1 件のレコードを調べるなら問題ありません。しかし、「今月、すべてのクライアントで請求可能な承認済み時間が未請求のまま何時間あるか」や「更新を控え、最も消化が進んでいる契約はどれか」といった質問では、規模が大きくなると機能しなくなります。さらに、BMS API のエンドポイントごとに 1 時間あたり 1,500 リクエストという制限があるため、ライブでの問い合わせは制限を受けます。

このスキルは、Kaseya BMS を全文検索に対応したローカル SQLite ミラーに同期します。集計に関する質問は、ローカルで 1 回の SQL 結合を実行するだけです。即座にオフラインで結果が得られ、AI に生データではなく回答を提示できます。workload（未解決チケットと技術者ごとの記録時間を結合）や contract-burn（タイムログをチケットの契約経由で集計）などの複合コマンドは、チケット、タイムログ、契約をまたいで結合します。ステートレスな API ラッパーでは実現できない処理です。

このスキルが解決する課題

Kaseya BMS を運用している MSP にレポート機能について尋ねると、r/msp や MSPGeek コミュニティで返ってくる答えは一貫しています。そこが弱点だということです。サービスデスクが毎朝確認する、どのキューが処理しきれない状態か、どのチケットが滞留しているか、誰が仕事を抱え込み、次のエスカレーションを引き受けられるのは誰か、といった問いに答えるには、クリックするだけでは済まず、Excel にエクスポートしてピボットテーブルを作る必要があります。月末も同じ手間がかかります。請求書発行に向けて、クライアントごとの承認済み・未請求の作業時間を集計し、更新の相談をする前に、前払い契約のうちクライアントがどれだけ消化したかを確認する必要があります。

このスキルを使えば、こうした作業をそれぞれ 1 つのコマンドで実行し、ローカルミラーから結果を取得できます。

• kaseya-bms-cli queue-health --agent - キュー、優先度、ステータスごとの未解決チケット数を表示し、朝会の前に滞留件数を特定します。
• kaseya-bms-cli stale-tickets --days 7 --agent - 1 週間誰も対応していない未解決チケットを、古い順に表示します。
• kaseya-bms-cli workload --agent - 技術者ごとの未解決作業量と記録済み時間をまとめて表示し、次の割り当てを調整できます。
• kaseya-bms-cli unbilled --agent - 承認済み・請求可能・未請求の作業時間をアカウントごとに時間単位で集計し、請求準備状況を確認できます。
• kaseya-bms-cli contract-burn --window-days 90 --agent - 契約ごとの消化時間と期間経過率を表示し、リスクの高いものから確認できます。

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

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは、HTTPS 経由のリモート MCP サーバーのみです。そのため、Kaseya BMS 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）もあります。どちらの方法でもコードを書く必要はありません。Kaseya BMS の認証情報を 1 回入力します。

Kaseya BMS のデータは安全ですか？

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

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

ほとんどありません。BMS ではエンドポイントごとに 1 時間あたり 1,500 リクエストが許可されています。読み取りはデフォルトでローカル SQLite ミラー（--data-source auto）を使用するため、日常的な問い合わせで API 呼び出しを消費することはありません。予算を消費するのは、sync を実行するか、--data-source live を指定して明示的にライブデータを問い合わせる場合だけです。

Kaseya の顧客である必要がありますか？また、認証方法を教えてください。

はい。Kaseya BMS のテナントと API ユーザーが必要です。このスキルは kaseya-bms-cli auth login を使ってそのユーザーとして認証します（BMS のユーザー名、パスワード、テナント名を入力します）。または、発行済みの JWT を KASEYA_BMS_TOKEN に貼り付けることもできます。このスキルで実行できる操作は、BMS ユーザーに許可された操作に限られます。

Kaseya BMS ポータルの代わりになりますか？

いいえ。キューの状況、未請求時間、案件の進捗など、日々確認する情報にすばやくアクセスしたり、AI エージェントにサービスデスクの操作を任せたりするための手段です。正式な記録の管理には、引き続き BMS ポータルをお使いください。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。料金が発生するのは、使用する AI エージェント（Claude、ChatGPT、Codex など）の利用料のみで、お支払い先は AI プロバイダーであり、当社ではありません。

安全性モデル

Tier	Examples	Recommended agent policy
読み取り (243)	queue-health、stale-tickets、unbilled、pipeline、servicedesk get-ticket、search	許可
書き込み - 定型 (124)	servicedesk post-ticket、servicedesk assign-ticket、crm post-account、finance mark-invoices-as-sent、import	--dry-run でプレビューした後、レビュー済みの書き込みを実行
認証情報／セキュリティ	integrations get-itgpassword-value、integrations get-vsa-access-info、security refresh-token、auth login	必ず人間が介在
破壊的操作 (21)	servicedesk delete-ticket、crm delete-contact、system delete-attachment	必ず人間が介在
管理者 (75)	admin グループ：webhook、workflow、service、K1 アクセス制御、Teams チャネル	オペレーター専用。エージェントには使用させない

すべての GET コマンドに付与された mcp:read-only アノテーションにより、MCP クライアントは書き込み操作を自動的に制限できます。定型の書き込みには、動詞のない import に加え、すべての POST／PUT／PATCH が含まれます。最も強力な制御は、Kaseya BMS の認証情報に付与するスコープです。CLI で実行できるのは、その認証情報に許可された操作だけです。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Kaseya BMS 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-07。