mcpField
M
MSP360

MSP360

ローカル
github.comファイル・ストレージ06 日前に更新

MSP360 について

MSP360 Managed Backup Service の管理・監視に使う MCP サーバーです。企業、コンピューター、バックアッププラン、状態、ライセンスを扱い、バックアップの開始・停止も行えます。

主な機能

  1. 01企業の一覧・取得
  2. 02管理対象コンピューターの確認
  3. 03プランと実行履歴の確認
  4. 04バックアップの開始・停止
  5. 05監視状態とライセンスの確認

活用シーン

  1. 01エンドポイント全体のバックアップ状態確認
  2. 02プランの実行履歴の確認
  3. 03バックアップの開始または停止

MCP 対応

MSP360 Managed Backup Service API の操作を、AI アシスタントや WYRE Conduit ゲートウェイ向けの MCP ツールとして公開します。stdio と HTTP のトランスポートに対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"wyre-ai-msp360": {
"command": "docker",
"args": [
"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.1"
],
"env": {
"MSP360_USERNAME": "<MSP360_USERNAME>",
"MSP360_PASSWORD": "<MSP360_PASSWORD>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"AUTH_MODE": "<AUTH_MODE>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}
起動コマンド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.1
設定が必要な環境変数
MSP360_USERNAMEMSP360 Managed Backup Service provider-portal username
MSP360_PASSWORDシークレットMSP360 Managed Backup Service provider-portal password
MCP_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocighcr.io/wyre-ai/msp360-mcp:v1.0.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

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_USERNAMEMSP360 プロバイターポータルのユーザー名です。
MSP360_PASSWORDMSP360 プロバイダーポータルのパスワードです。
MCP_TRANSPORTstdio(デフォルト)または http です。
AUTH_MODEenv(デフォルト。上記の変数を読み込みます)または gateway(認証情報はリクエストごとに X-MSP360-Username/X-MSP360-Password ヘッダーで渡され、Conduit ゲートウェイによって挿入されます)です。
CONDUIT_S2S_SECRET設定されている場合、HTTP トランスポートではすべての /mcp リクエストに有効な X-Gateway-S2S ヘッダー(Conduit サイドカー認証)が必要です。
LOG_LEVELdebug | 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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。