MSP360 について
MSP360 Managed Backup Service の管理・監視に使う MCP サーバーです。企業、コンピューター、バックアッププラン、状態、ライセンスを扱い、バックアップの開始・停止も行えます。
主な機能
- 01企業の一覧・取得
- 02管理対象コンピューターの確認
- 03プランと実行履歴の確認
- 04バックアップの開始・停止
- 05監視状態とライセンスの確認
活用シーン
- 01エンドポイント全体のバックアップ状態確認
- 02プランの実行履歴の確認
- 03バックアップの開始または停止
MCP 対応
MSP360 Managed Backup Service API の操作を、AI アシスタントや WYRE Conduit ゲートウェイ向けの MCP ツールとして公開します。stdio と HTTP のトランスポートに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm -e MSP360_USERNAME -e MSP360_PASSWORD -e MCP_TRANSPORT -e AUTH_MODE -e LOG_LEVEL ghcr.io/wyre-ai/msp360-mcp:v1.0.1MSP360_USERNAMEMSP360 Managed Backup Service provider-portal usernameMSP360_PASSWORDシークレットMSP360 Managed Backup Service provider-portal passwordMCP_TRANSPORTTransport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.AUTH_MODEシークレットCredential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.LOG_LEVELLog verbosity: debug, info, warn, errorローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ghcr.io/wyre-ai/msp360-mcp:v1.0.1stdioツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MSP360 MCP サーバー
MSP360 の Managed Backup Service API(旧 CloudBerry Lab)向け MCP サーバーです。企業、管理対象コンピューター、バックアッププラン、監視、ライセンスを、AI アシスタントおよび WYRE Conduit ゲートウェイ向けに提供します。
認証
Managed Backup Service のプロバイダーポータルの UserName/Password のペアを指定します。このサーバーは POST /api/Provider/Login を介して短期間有効なベアラートークンと交換し、そのトークンをキャッシュします。ベンダーがキャッシュ済みトークンを拒否(HTTP 401)した場合は自動的に再認証するため、呼び出し元が指定する必要があるのは有効期間の長いユーザー名/パスワードだけです。
設定
| 環境変数 | 説明 |
|---|---|
MSP360_USERNAME | MSP360 プロバイターポータルのユーザー名です。 |
MSP360_PASSWORD | MSP360 プロバイダーポータルのパスワードです。 |
MCP_TRANSPORT | stdio(デフォルト)または http です。 |
AUTH_MODE | env(デフォルト。上記の変数を読み込みます)または gateway(認証情報はリクエストごとに X-MSP360-Username/X-MSP360-Password ヘッダーで渡され、Conduit ゲートウェイによって挿入されます)です。 |
CONDUIT_S2S_SECRET | 設定されている場合、HTTP トランスポートではすべての /mcp リクエストに有効な X-Gateway-S2S ヘッダー(Conduit サイドカー認証)が必要です。 |
LOG_LEVEL | debug | info(デフォルト)| warn | error です。 |
リクエストの上限
- HTTP リクエストボディの上限は 256 KiB(262144 バイト)です。
X-Gateway-S2Sチェックに合格した後、Content-Lengthが上限を超えている場合は、JSON-RPC エラーとともに 413 を返します。Content-Lengthがないボディには MCP SDK トランスポートによる上限が適用されます。未認証のリクエストには、まず 401 が返されます。 tools/callの引数は 10,000 要素(任意の深さにあるすべての配列項目とオブジェクトキーの合計)までに制限されています。これを超える入力はisErrorツール結果を返し、ディスパッチされません。
これらの上限は、CVE-2026-111768/GHSA-46jr-4wx8-v453(検証中のメモリ枯渇)および GHSA-f897-62hf-6gxq(リクエストボディ/バッチ上限がない問題)への対処です。
ツール
企業
msp360_list_companies- このプロバイダーアカウント配下の企業(顧客組織)を一覧表示します。msp360_get_company- ID で指定した企業を取得します。
コンピューター
msp360_list_computers- 管理対象コンピューター(エンドポイント)のページ分割された一覧を取得します。msp360_get_computer- HID で指定したコンピューターを取得します。
バックアッププラン
msp360_list_plans- コンピューターのバックアップ/復元プランを一覧表示します。msp360_get_plan- ID で指定したプランを取得します。msp360_get_plan_info- プランのステータス/情報を取得します。msp360_get_plan_history- プランの実行履歴を取得します。日付で絞り込むこともできます。msp360_start_plan- プランのバックアップ実行を開始します。msp360_stop_plan- 実行中のプランのバックアップを停止します。
監視
msp360_get_monitoring- すべてのエンドポイントにおける最新のプラン実行のステータスデータを取得します。msp360_get_monitoring_for_user- ユーザーで絞り込んだ、最新のプラン実行のステータスデータを取得します。
ライセンス
msp360_list_licenses- 利用可能なライセンスを一覧表示します。未割り当てのライセンスに絞り込むこともできます。msp360_get_license- ID で指定したライセンスを取得します。
対象範囲
これは、MSP ワークフローの中核である「何がバックアップされていて、正常な状態か」を対象とする v1/MVP の機能範囲です。現時点で明示的に対象外となるのは、Administrators、Billing、Builds、Packages、Destinations/Accounts(ストレージのプロビジョニング設定)、Users/Authenticate、License Grant/Release/Revoke(ライセンス割り当ての変更)、およびコンピューターの認証/認証解除です。これらはプロバイダー/リセラーの管理コンソールレベルの操作であり、請求やアクセスに重大な影響を及ぼします。日常的な MSP 監視とは別のものなので、v1 にまとめるのではなく、後で慎重に個別検討する価値があります。
開発
npm install
npm run build
npm test
npm run lint # tsc --noEmit
Docker
docker build -t msp360-mcp .
docker run -p 8080:8080 -e MSP360_USERNAME=... -e MSP360_PASSWORD=... msp360-mcp
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。