connectwise-command-mcp

ConnectWise Command MCPサーバー — ConnectWise Command (Continuum) ITSupport247 Reporting API を MCP ツールとして公開します。

名称に関する注記: app.mspbots.ai はこの統合を "ConnectWise Command (continuum)" と呼びます (sys_integration.subject_code = CONTINUUM)。ConnectWise は Continuum を買収し、その RMM 製品を "ConnectWise Command" としてブランド変更しました。基盤となる API は依然としてレガシーな ITSupport247 ドメイン (itsupport247.net) でホストされ、"Reporting API" として文書化されています。このサーバーはその Reporting API のみをラップします — ConnectWise Manage (PSA) や ConnectWise Automate とは無関係です。

概要

このサーバーは Model Context Protocol (Streamable HTTP/SSE トランスポート) を実装し、ConnectWise Command / Continuum の公式 "Reporting API REST Resources" リファレンスのすべてのリソースをラップします。MSPbots Vendor MCP Service SOP に従います: ステートレス、資格情報の保存なし、リクエストごとのヘッダー認証。

基盤となる API は HTTP Basic Auth (ユーザー名は空、API キーをパスワードとして使用) で認証し、JSON を返します。このサーバーはキーを決して保存しません — 呼び出し元はリクエストごとにヘッダーで渡します。以下のすべてのリクエスト/レスポンスのフィールド名は、公式リファレンスドキュメントから逐語的に転記されたものであり、推測ではありません。

Related MCP server: nable-rmm-mcp

クイックスタート

Docker (推奨)

docker compose up --build

サーバーは http://localhost:8080 で起動します。

ローカル (uv)

uv sync
python -m connectwise_command_mcp

ヘルスチェック

curl http://localhost:8080/health
# {"status": "ok"}

ヘルスチェックエンドポイントにはトークンは不要です。

認証パラメータ (Authentication)

/mcp へのすべてのリクエストには、次の HTTP ヘッダーを含める必要があります:

内部的に、このサーバーはキーを次のようにエンコードします:

Authorization: Basic base64(":" + api_key)

他の一部の RMM ベンダー (例: N-able) とは異なり、ConnectWise Command の Reporting API ホストは 固定の公開エンドポイントであり、テナントごとではありません — 設定する "URL" フィールド/ヘッダーはなく、app.mspbots.ai 統合フォームの単一の "API Key" フィールドに対応します。X-ConnectWise-Command-Api-Key がない場合は 401 Unauthorized を返します。

環境変数

MCP エンドポイント

POST http://localhost:8080/mcp

MCP クライアントを接続するには:

• トランスポート: http (Streamable HTTP / SSE)

• ヘッダー: X-ConnectWise-Command-Api-Key: <api_key>

ツール一覧

21 ツール。元の 41 ツールのフル API ビルド (2026-08-04) から削減されました。MSPbots 自身が保存しているこのベンダーの統合設定は 19 エンドポイント を呼び出します (統合 ID 1424565871921713153 に対する web/int/sys/integration/api/list で確認済み)。内訳は、Antivirus (7/7 保持 — すべてのアンチウイルスツールが実際に使用されています)、Patches (4/4 保持 — 同様)、Warranty (3/3 保持 — 同様)、Sites/Devices (3 のうち 2 が実際に使用、カテゴリが小さいため 3 つすべて保持)、Agent/System/Software (3/3 保持 — 同様)、さらに単一の Misc ツール (get_score_summary、実際に使用されている唯一の Misc エンドポイント) です。元の 41 ツールビルドの他のすべて — Performance (7)、Availability (3)、Recover for Continuity/Backup (4)、および他の 6 つの Misc ツール (非準拠モバイルデバイス、OS サマリー、月次/週次のサービスリクエスト、SNMP デバイス、ワークサマリー) — は MSPbots によって未使用として削除されました。削除されたツールが後で必要になった場合、公式の "Reporting API REST Resources" ドキュメント (下記リンク) にまだ記載されており、保持されたツールと同じ方法で再追加できます。

保持されているほとんどのツールは site_code (最初に connectwise_command_get_sites から取得) と month/year (int) を受け取ります。いくつかは resource_type ("desktop" または "server"、ドキュメントが1つの値に固定している場合はリソースごとの制限が注記されています) も受け取ります。

サイト、デバイス、サマリー

エージェント / システム / ソフトウェア

アンチウイルス

パッチ

保証

その他

テスト例 (Test Example)

すべてのサイトを一覧表示し、次に1つのサイトのデバイスを取得します:

{
  "method": "tools/call",
  "params": { "name": "connectwise_command_get_sites", "arguments": {} }
}

実行中のサーバーに対する同等の curl (ストリーミング HTTP MCP エンドポイント):

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-ConnectWise-Command-Api-Key: <api_key>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "connectwise_command_get_sites", "arguments": {} }
  }'

月/年ベースのリソース:

{
  "method": "tools/call",
  "params": {
    "name": "connectwise_command_get_cpu_utilization",
    "arguments": { "site_code": "AGTSolutions", "month": 4, "year": 2015 }
  }
}

API リファレンス

• 公式ドキュメント (ITSupport247 ポータル、Admin > Integration > Reporting API):

  • "Getting Started with the Reporting API"

  • "Reporting API REST Resources" (リソースごとの完全なリクエスト/レスポンススキーマ — このサーバーのすべてのフィールド名の出典)

実装メモ

• 2026-08-04 に 41 ツールから 21 ツールに削減。 元のビルドは公式 Reporting API ドキュメントのすべてのリソースをカバーしていました。後のスコープ決定により、MSPbots が実際に設定した 19 エンドポイントと、常に保持される小さな Sites/Devices/Agent/System カテゴリに削減されました — 正確な根拠と削除されたツールの完全なリスト (Performance、Availability、Recover for Continuity/Backup、および 7 つの Misc ツールのうち 6 つ — 合計 17 ツール) については、上記のツール一覧セクションを参照してください。削除されたツールが後で必要になった場合、公式 Reporting API ドキュメント (下記リンク) にまだ記載されており、保持されたツールと同じ方法で再追加できます。

• エラー形状はリソースによって異なります — 一部のレスポンスは "Error" (大文字、例: Agent Details) を使用し、ほとんどは "error" (小文字、例: Antivirus Summary) を使用します。また、レスポンス内の位置も異なります (先頭、末尾、またはアイテムごとにネスト)。ContinuumClient._parse は両方の大文字小文字をチェックします。

• GET リソース (Sites、Devices) は裸の JSON 配列を返します。error キーを持つオブジェクトではありません。

• リクエストフィールド名 MachineID (Antivirus Version Summary、Installed Software、System Information のリクエストボディで使用) は、レスポンスフィールド MachineId と大文字小文字が異なります — 両方とも公式ドキュメントから逐語的に確認済みです。

• get_site_installation_package に相当する機能はこの API には存在しません。ここでは該当しません (N-able RMM とは異なります)。