Netmon MCP

AIアシスタントをNetmonアプライアンスに接続します。

Netmonはアプライアンス自体にMCPサーバーを内蔵しています。このリポジトリはクライアント側のブリッジを保持します。これは、ユーザーのマシン上で動作し、Claude Desktopとstdioで通信し、すべてのJSON-RPCメッセージをHTTPS経由でNetmonの/mcpエンドポイントに転送する小さなNodeプロセスです。

接続が確立されると、アシスタントはNetmonのツールを直接呼び出すことで、デバイス、インターフェース、ログ、フローレコード、アラート、Windowsエージェントデータを読み取ることができます。その際のサインインと権限は通常のオペレーターと同じであり、タグの制限も同様に適用されます。

• 製品概要: https://netmon.com/netmon-ai-assistants/

• セットアップガイド: https://netmon.com/netmon-7-user-guide/api-and-integrations/

• APIリファレンス: https://netmon.com/api-reference/authentication/

ローカルブリッジが必要な理由

Claudeは、ユーザーのマシンではなく、AnthropicのクラウドインフラストラクチャからリモートMCPサーバーに接続します。プライベートネットワーク上のNetmonアプライアンスは、そこからは到達できません。

ブリッジはローカルプロセスとして動作するため、LAN上のアプライアンスに到達できます。これこそがこのリポジトリが存在する理由であり、サポートされるクライアントはClaude DesktopとClaude Codeであり、ブラウザ上のclaude.aiではないことを意味します。

アプライアンスがインターネットに面しており、公開信頼済みの証明書を使用している場合は、ブリッジをスキップして、任意のMCPクライアントをエンドポイントに直接接続できます。以下のインストール — 任意のMCPクライアントを参照してください。

Related MCP server: domotz-mcp

要件

• MCPサーバーが有効化されたNetmonアプライアンス（Netmon 7.0.20以降）。

• API権限を持つユーザーアカウントと、アシスタントに付与したいmcp:*スコープを持つ個人アクセストークン。

• .mcpbインストール用のClaude Desktop。Claude Desktopは独自のNodeランタイムを提供するため、他に必要なものはありません。Claude Desktopの外部でブリッジを実行するには、Node 18以降が必要です。

インストール — Claude Desktop

1. Releasesからnetmon-mcpd-<version>.mcpbをダウンロードします。同じバンドルはアプライアンスにも同梱されています — Settings → System → Downloadables → Claude Desktop Extension。

2. Claude Desktopで、Settings → Extensions → Advanced settings → Extension Developer → Install Extension… を開き、ファイルを選択します。

3. 拡張機能が要求する2つの設定項目を入力します。

   設定項目	値
   Netmon URL	https://<your-netmon>/mcp — /mcpを含む完全なエンドポイント
   API Token	個人アクセストークン（下記参照）。省略した場合、Bearer プレフィックスは自動的に追加されます。

4. 拡張機能を再起動します。動作確認として、Claudeに「ダウンしているデバイスをリストして」などと質問してください。

トークンの発行

Netmonで、Settings → Usersに移動し、自分のユーザーのキーアイコンをクリックして、個人アクセストークンを作成します。アシスタントに必要なスコープのみを選択してください。トークンは後で拡張することはできず、同じ画面からいつでも失効させることができます。

アカウントはAPI権限を持っている必要があります。これがない場合、トークンの発行とOAuth同意の両方が拒否されます。

インストール — 任意のMCPクライアント

アプライアンスはhttps://<your-netmon>/mcpでStreamable HTTPを提供します（JSON-RPCにはPOST、サーバーからクライアントへのSSEストリームにはGET、セッション終了にはDELETE）。

OAuth 2.1をサポートするクライアントは、認可サーバーを自動的に検出します。エンドポイントは、認証されていないリクエストに対して401と、RFC 9728の保護リソースメタデータを指すWWW-Authenticate: Bearer resource_metadata="…"チャレンジを返し、さらにRFC 8414の認可サーバーメタデータと/auth/registerでの動的クライアント登録も返します。ユーザーは自分のNetmon上でブラウザを通じてサインインし、同意画面でスコープを承認します。

OAuthをサポートしていないクライアントは、トークンを直接渡します。

{
  "mcpServers": {
    "netmon": {
      "url": "https://netmon.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Claude Codeと自己署名証明書

ほとんどのアプライアンスは自己署名証明書を提供します。これに対して直接type: httpエントリを使用すると失敗します。OAuthブートストラップが証明書を拒否し、NODE_EXTRA_CA_CERTSを参照しないためです。代わりに、証明書を自身で処理するブリッジを使用してください。

{
  "mcpServers": {
    "netmon": {
      "command": "node",
      "args": ["/path/to/netmon-mcpd/server/index.js"],
      "env": {
        "NETMON_URL": "https://netmon.example.com/mcp",
        "NETMON_TOKEN": "<your-token>"
      }
    }
  }
}

ツール

36個の読み取り専用ツールがあり、それぞれがNetmon APIエンドポイントをラップし、呼び出し前にチェックされるOAuthスコープによって制御されます。

スコープは全部で8つ存在します。上記の6つに加えて、mcp:reportsとmcp:systemがあり、それぞれ対応する権限にマッピングされますが、まだツールはありません。

セキュリティモデル

すべてはお使いのアプライアンス上に留まります。 ブリッジは設定した1つのURLにのみ接続し、それ以外には接続しません。テレメトリ、ベンダーエンドポイント、サードパーティサービスはパス上に存在しません。Netmon Servicesは何も受信しません。

読み取り専用。 すべてのツールは読み取りです。Netmonのエージェント書き込みパス（プロセスの強制終了、Windowsサービスの開始/停止、ファイルの削除、PowerShellの実行）は、基盤となるトークンの権限が何を許可していても、MCPレイヤーで恒久的に除外されています。アシスタントは、監視設定の変更、アラートの確認、管理ホストへの操作を行うことはできません。

スコープ付き。 各ツールは必要なOAuthスコープを宣言し、ツール本体の実行前にスコープがチェックされます。mcp:logsのみが付与されたトークンではdevice_listを呼び出すことはできません。

お客様のものであり、それ以上ではありません。 トークンは発行したユーザーとして動作します。タグ制限も適用されます。branch-officesタグに制限されたオペレーターは、同じデバイスに制限されたアシスタントを使用することになります。権限モデルは、Webインターフェースや他のすべてのAPIクライアントを既に統制しているものと同じです。

失効可能。 Settings → Usersからトークンを失効させると、アシスタントは即座にアクセスを失います。トークンは、後で失効するのではなく、発行時に狭くスコープを設定することもできます。

トランスポートセキュリティ

最初の接続時に、ブリッジはアプライアンスのTLS証明書を取得し、~/.netmon-mcpd/<urlのハッシュ>.pemに保存します。その後、後続のすべての接続を、このピン留めされた証明書に対して検証します。これはTrust-On-First-Use（初回使用時の信頼）です。最初の接続後は傍受から保護しますが、接続中は保護しません。最初の接続は信頼できるネットワークから行ってください。

アプライアンスの証明書を交換した場合は、古いピンを削除してください（rm ~/.netmon-mcpd/*.pem）。削除しないと、ブリッジは新しい証明書を古い証明書に対して検証し、接続を拒否します。

ブリッジはhttps://を必須とします。プレーンなHTTPは起動時に拒否されます。

トラブルシューティング

ブリッジは診断ログを~/.netmon-mcpd/wrapper.logに書き込みます。

ビルド

npm install
./build.sh            # or: ./build.sh 1.0.0 to stamp a version

出力はbuild/netmon-mcpd-<version>.mcpbに配置されます。

プライバシーポリシー

完全なポリシー: https://netmon.com/privacy-policy/

収集されるもの。 このブリッジはデータを収集しません。アカウント、分析、Netmon Servicesへのコールバックは保持しません。ローカルに書き込まれるファイルは2つで、どちらも~/.netmon-mcpd/の下にあります。設定したアプライアンスのピン留めされた証明書と、接続イベントの診断ログです。NetmonのURLとトークンはお客様が提供し、拡張機能の設定内にのみ保持されます。

データの使用と保存方法。 クエリと結果は、MCPクライアントとアプライアンス間を通過します。ブリッジはメッセージを転送するだけで、保持しません。すべての監視データは、お客様の管理下で、お客様の建物内にあるアプライアンスのデータベースに留まります。

第三者への開示。 一切ありません。ブリッジが接続するのは、設定したアプライアンスのURLの1つのホストのみです。Netmon Servicesやその他の第三者に何かを送信することはありません。

なお、MCPクライアントは独自のポリシーを持つ別の製品です。アシスタントに質問をすると、アシスタントが受け取ったツールの結果は、そのクライアントのベンダーが自社の条件に基づいて処理します。Netmonはその部分を制御しません。そのため、トークンのスコープを狭く設定することが重要です。

保持期間。 ローカルファイルは、お客様が削除するまで保持されます。拡張機能を削除するか、rm -rf ~/.netmon-mcpdを実行してください。Settings → Usersでトークンを失効させると、アクセスは即座に終了します。監視データ自体の保持期間は、お客様がアプライアンス上で設定します。

連絡先。 support@netmon.com

サポート

• ドキュメント: https://netmon.com/documentation/

• ブリッジに関する問題: GitHub Issues

• その他: support@netmon.com

ライセンス