connectwise-asio-mcp

ConnectWise Asio MCP サーバー — ConnectWise Platform APIs（ConnectWise Asio の背後にある「Current API」。旧 SolarWinds MSP/N-central に隣接する RMM）を MCP ツールとして公開します。

命名に関する注記: app.mspbots.ai はこの統合を 「ConnectWise Asio」 と呼んでいます（sys_integration.subject_code = CWASIO）。これは ConnectWise Command (Continuum)、ConnectWise Manage (PSA)、ConnectWise Automate とは別製品であり、それぞれがこのフリート内に独自の MCP サーバーを持っています。基盤となる API は、その OpenAPI 仕様では正式に 「ConnectWise Platform APIs」 という名前です（developer.connectwise.com — Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks の下にある "REST API" ドキュメント）。

概要

このサーバーは Model Context Protocol（Streamable HTTP/SSE トランスポート）を実装し、ConnectWise Platform APIs をラップします。25 ツールは 5 カテゴリ（devices、companies_contacts、custom_fields、patching、automation）にわたり、MSPbots が実際に設定した 23 エンドポイントと最小限のコア CRUD に絞り込まれています（下記のツール一覧を参照。元々は 24 のタグカテゴリにわたる 107 オペレーションのフル API ビルドでした）。これは MSPbots の Vendor MCP Service SOP に従っています。すなわち、ステートレス、資格情報の保存なし、リクエストごとのヘッダー認証です。

基盤となる API は OAuth2 Client Credentials で認証します。このサーバーはトークン交換自体を行わず、リクエストごとに既に取得済みのベアラーアクセストークンを受け取ります（これは、この MSPbots MCP フリートで他の OAuth フロー統合（例: Microsoft Graph）が処理される方法と同じです。ゲートウェイが client_id/client_secret/scope からトークンを発行・更新し、このサーバーに届くのは結果のトークンのみです）。

Related MCP server: mcp-connectwise-psa

クイックスタート

Docker（推奨）

docker compose up --build

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

ローカル (uv)

uv sync
python -m connectwise_asio_mcp

ヘルスチェック

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

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

認証パラメータの説明 (Authentication)

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

X-ConnectWise-Asio-Token がない場合、401 Unauthorized を返します。

環境変数

MCP エンドポイント

POST http://localhost:8080/mcp

MCP クライアントを次のように接続してください:

• トランスポート: http（Streamable HTTP / SSE）

• ヘッダー: X-ConnectWise-Asio-Token: <access_token>（必須）、X-ConnectWise-Asio-Base-Url: <base_url>（任意）

ツール一覧

25 ツール。これは、元となる 104 ツールのフル API ビルド（2026-08-04）から削減されたものです。MSPbots が保存しているこのベンダー向け統合設定は、6 つの基盤リソースカテゴリ（devices/endpoints、companies、sites、custom fields、patching、automation）にわたる 23 エンドポイントを呼び出します。この 23 の設定済みエンドポイントはすべて（ここでは同じツールに統合される個別の v1/v2 パスバリアントも含む）、対応するエンドポイント名が付けられた下記の維持ツールのいずれかにマッピングされます。元の 104 ツールビルドのその他すべて（Tickets — 24 ツールを擁する最大のカテゴリ、Policy/Policy Group/Package、Mapping、Alerting & Incidents、Backup Dashboard、Misc — の 6 カテゴリ、約 79 ツール）は、MSPbots が使用しないため削除されました。削除されたカテゴリが後で必要になった場合でも、ベンダーの OpenAPI 仕様（下記リンク）には正確なオペレーションが引き続き記載されており、維持ツールが生成されたのと同じ方法で再追加できます。

元のビルドから引き継がれた既知のギャップ: MSPbots は 2 つのエンドポイントを設定しています — 「ConnectWise Asio Suspension」（GET /v2/alerting/suspensions）と「ConnectWise Asio Suspension Details」（GET /v2/alerting/suspensions/{ruleid}）— ですが、このサーバーには 対応するツールがまったくありません（元の 104 ツールビルドの alerting カテゴリは create/update/delete/post-incident オペレーションのみを実装しており、GET による suspension 読み取りは実装されていませんでした）。これは削減前から存在しており、削減によって生じたものではありません。ツール数が少なくなったことでより目立つため、ここで取り上げます。下記の Known Gaps を参照してください。

会社と連絡先 (6)

カスタムフィールド (6)

デバイスとエンドポイント (9)

パッチ (3)

自動化 (1)

テスト例 (Test Example)

会社の一覧を取得し、次にそのサイトを取得します：

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

実行中のサーバーに対する同等の curl（ストリーミング可能なHTTP MCPエンドポイント）：

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-ConnectWise-Asio-Token: <access_token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "connectwise_asio_get_companies", "arguments": {} }
  }'

パラメーター化された呼び出し：

{
  "method": "tools/call",
  "params": {
    "name": "connectwise_asio_get_endpoint_cpu_usage",
    "arguments": { "endpoint_id": "abc-123" }
  }
}

APIリファレンス

• 公式ドキュメント（ConnectWise Developer Network — ログインが必要）：Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks > REST API

• ベースURL: NA https://openapi.service.itsupport247.net, EU https://openapi.service.euplatform.connectwise.com, AU https://openapi.service.auplatform.connectwise.com

既知のギャップ / 未検証

• 2026-08-04に104ツールから25ツールに削減されました。 元のビルドは、以前のスコープ決定に従って、ConnectWise Platform APIs仕様の全体をカバーしていました。その後のスコープ決定により、MSPbotsが実際に使用するカテゴリにまで削減されました。正確なエンドポイント→ツールの対応と、削除された6つのカテゴリの完全なリスト（約79ツール。元のビルドで最大の単一カテゴリである24ツールのticketsカテゴリを含む）については、上記のツール一覧セクションを参照してください。削除されたカテゴリが後で必要になった場合、ベンダーのOpenAPI仕様（下記リンク）にその正確な操作がまだ記載されており、維持されているツールと同じ方法で再追加できます。

• MSPbotsが設定した「Suspension」/「Suspension Details」エンドポイントには対応するツールがありません — このギャップは削減前から存在しており（元の104ツールのビルドのalertingカテゴリはGET-suspension読み取り操作を実装せず、create/update/delete/post-incidentのみを実装していました）、削減によって生じたものではありません。サスペンションデータが実際に必要な場合は、ベンダーのOpenAPI仕様から追加する必要があります。

• 実際のConnectWise Asioアカウントに対してはまだテストされていません。これまでに実行されたのは、プロトコルレベルの検証（ヘルスチェック、トークン欠落時の401、tools/listが全25ツールを返すこと）のみです。

• connectwise_asio_update_company_custom_fields と connectwise_asio_create_company は、完全にフラット化された名前付き引数ではなく、汎用の body: dict パラメーターを受け取ります。docstringには必須のトップレベルのフィールドが列挙されていますが、ネストされたオブジェクトの構造は、最初の使用時に実際のAPIと照合する必要があります。