Skip to main content
Glama
MSPbotsAIFramework

nable-rmm-mcp

nable-rmm-mcp

N-able RMM MCP サーバー — N-able RMM Data Extraction API を MCP ツールとして公開します。

名称に関する注記: この統合は app.mspbots.ai では "N-able RMM" と呼ばれています (sys_integration.subject_code = SOLARWIND — 元々は SolarWinds RMM でした)。N-able 自身の公開開発者向けドキュメントでは、同じ製品を "N-sight" と呼んでいます (https://developer.n-able.com/n-sight/docs/...)。これは N-able N-Central とは別の製品です。N-Central は app.mspbots.ai では独自の API を持つ別の統合です。このサーバーは N-sight/N-able RMM のみをラップします。

概要

このサーバーは Model Context Protocol (Streamable HTTP/SSE トランスポート) を実装し、N-sight API ("N-able RMM" 統合の背後にある API) をラップします。これは MSPbots の Vendor MCP Service SOP に従います: ステートレス、認証情報の保存なし、リクエストごとのヘッダー認証。

基盤となる API 自体は apikey クエリパラメータで認証し、XML を返します。このサーバーはそのキーを決して保存しません — 呼び出し元がリクエストごとにヘッダーで渡し、すべてのツール応答は読みやすさのために XML を JSON に変換したものです。

Related MCP server: Datto RMM MCP Server

クイックスタート

Docker (推奨)

docker compose up --build

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

ローカル (uv)

uv sync
python -m nable_rmm_mcp

ヘルスチェック

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

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

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

/mcp へのすべてのリクエストには、以下の HTTP ヘッダーを含める必要があります。ヘッダー名は、app.mspbots.ai の既存の "N-able RMM" 統合フォームのフィールド (API Token / URL) に対応しています。

ヘッダー

型

必須

デフォルト値

列挙値

フィールドの説明

例

X-Nable-Api-Token

string

必須

なし

なし(自由テキスト)

N-able RMM API キー。Settings > General Settings > API > Generate で生成します。キーが特定のクライアントグループに制限されている場合、呼び出しはそのグループ内の顧客データのみを返します。

X-Nable-Api-Token: <your_api_key>

X-Nable-Server

string

任意

NABLE_BASE_URL 環境変数(デフォルト https://www.am.remote.management)

下記の11の地域サーバーリストを参照

N-able RMM はアカウントの所属地域に応じて11の独立したサーバーに分かれています。このヘッダーがない場合は環境変数のデフォルト値を使用します。ゲートウェイが複数地域のテナントを同時にサービスする場合、リクエストごとに上書きされます。

X-Nable-Server: https://www.systemmonitor.co.uk

X-Nable-Server の11の列挙値(地域 → Base URL):

地域

Base URL

Americas (デフォルト)

https://www.am.remote.management

Asia

https://wwwasia.system-monitor.com

Australia

https://www.system-monitor.com

Europe

https://wwweurope1.systemmonitor.eu.com

France

https://wwwfrance.systemmonitor.eu.com

France1

https://wwwfrance1.systemmonitor.eu.com

Germany

https://wwwgermany1.systemmonitor.eu.com

Ireland

https://wwwireland.systemmonitor.eu.com

Poland

https://wwwpoland1.systemmonitor.eu.com

United Kingdom

https://www.systemmonitor.co.uk

United States

https://www.systemmonitor.us

X-Nable-Api-Token がない場合は 401 Unauthorized を返します。N-able RMM は自動化された呼び出しを キーあたり毎分60リクエスト に制限しています — このサーバーはスロットリングを行わないため、バルク呼び出しはそれに合わせてペースを調整してください。

環境変数

変数

デフォルト

説明

MCP_HTTP_PORT

8080

待受ポート

MCP_HTTP_HOST

0.0.0.0

待受ホスト

NABLE_BASE_URL

https://www.am.remote.management

デフォルトの地域サーバー。X-Nable-Server でリクエストごとに上書き可能

MCP エンドポイント

POST http://localhost:8080/mcp

MCP クライアントを以下の設定で接続します:

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

  • ヘッダー: X-Nable-Api-Token: <api_key> (必須)、X-Nable-Server: <base_url> (任意)

ツール一覧

16のツールを提供し、公開されている N-sight API リファレンス全体に加え、app.mspbots.ai の "N-able RMM" 統合ですでに本番利用されている4つのエンドポイント (Device Monitoring Details、Drive Space History、Patch、Performance History) をカバーしています。

クライアントとサイト

ツール

機能

パラメータ

nable_rmm_get_clients

この API キーで参照可能なすべてのクライアントを一覧表示

devicetype?("server"/"workstation"/"mobile_device")

nable_rmm_get_sites

特定のクライアント配下のすべてのサイトを一覧表示

clientid (必須, int)

nable_rmm_create_client

クライアントを新規作成(書き込み操作)

name (必須), timezone?, officehoursemail?, officehourssms?, outofofficehoursemail?, outofofficehourssms?

nable_rmm_create_site

クライアント配下にサイトを新規作成(書き込み操作)

clientid (必須), sitename (必須), router1?, router2?, workstationtemplate?, servertemplate?

デバイス

ツール

機能

パラメータ

nable_rmm_get_devices_at_client

デバイスタイプ別に、クライアント配下のすべてのサイトのデバイスを一覧表示

clientid (必須), devicetype (必須, "server"/"workstation"/"mobile_device")

nable_rmm_get_servers

サイト配下のサーバーデバイスとオンライン/チェック状態を一覧表示

siteid (必須, int)

nable_rmm_get_workstations

サイト配下のワークステーションデバイスとオンライン/チェック状態を一覧表示

siteid (必須, int)

nable_rmm_get_agentless_assets

サイト配下のエージェントレス(スキャンで検出された)アセットを一覧表示(N-able はこの機能を非推奨としています)

siteid (必須, int)

nable_rmm_get_device_monitoring_details

単一デバイスの詳細な監視情報を取得

deviceid (必須, int)

チェック、パッチ、パフォーマンス

ツール

機能

パラメータ

nable_rmm_get_failing_checks

現在失敗しているチェック項目を一覧表示

clientid?, check_type?("checks"/"tasks"/"random")

nable_rmm_get_checks

特定のデバイスに設定されているすべてのチェック項目を一覧表示

deviceid (必須, int)

nable_rmm_get_check_config

単一のチェック項目の詳細な設定を取得(構造はチェックタイプ/OSによって異なります)

checkid (必須, int)

nable_rmm_get_outages

デバイスの障害(outage)記録を一覧表示(オープン中、または直近61日以内にクローズされたもの)

deviceid (必須, int)

nable_rmm_get_drive_space_history

ディスク容量チェックの履歴(list_checks を check_type 1003/1004 でフィルタリングしたもの。N-sight には独立したサービスはありません)

deviceid (必須, int)

nable_rmm_get_patch_list

デバイス上のすべてのパッチとそのステータス/重大度を一覧表示

deviceid (必須, int)

nable_rmm_get_performance_history

デバイスの過去のパフォーマンス指標(帯域幅/ディスク/CPU/メモリ/ネットワークアダプター)

deviceid (必須, int), interval (必須, int, 15 または 60 のみ), since?

テスト例 (Test Example)

サイト内のすべてのサーバーを一覧表示します:

{
  "method": "tools/call",
  "params": {
    "name": "nable_rmm_get_servers",
    "arguments": { "siteid": 12345 }
  }
}

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

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

成功時の結果の期待される形式 (基盤の XML レスポンスを JSON に変換したもの。フィールドは省略されています):

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"created\": \"2026-03-15T10:00:00+00:00\",\n  \"host\": \"...\",\n  \"status\": \"OK\",\n  \"items\": {\n    \"server\": [ { \"serverid\": \"9001\", \"name\": \"DC01\", \"online\": \"1\", \"status_247\": \"5\", \"os\": \"Windows Server 2022\" } ]\n  }\n}"
    }
  ]
}

API リファレンス

実アカウントでの検証

14の読み取りツールすべてを、実際の N-able RMM アカウント(米国リージョン)に対してエンドツーエンドで実行し、実際のデータを取得しました。N-able の公開ドキュメントでは曖昧だったエッジケースも含みます:

  • nable_rmm_get_performance_history の interval パラメータは 必須 であり(ドキュメントの例が示唆していたように任意ではありません)、15 または 60 のみを受け付けます — API 自身の検証エラー (Invalid "interval": must be 15 or 60 (minutes)) で確認済みです。

  • nable_rmm_get_agentless_assets はこのアカウントでは空の items を返します。これは、この機能が非推奨であるという N-able の注記と一致しています。

2つの書き込みツール (nable_rmm_create_client、nable_rmm_create_site) は、本番環境の顧客の N-able RMM テナントに実際のデータを作成しないよう、実アカウントでは実行 していません — これらに依存する前に、使い捨てのテストアカウントで検証してください。

既知のギャップ / 未実装

  • get_site_installation_package — 構造化データではなくバイナリのインストーラーのダウンロードを返すため、MCP ツールとしては実用的ではありません。

Related MCP Connectors

Related MCP Servers