Netdata

Netdata MCP

Model Context Protocol (MCP) は、Netdata と双方向に連携します。

• MCP サーバーとしての Netdata — AI アシスタントやクライアント（Claude、Cursor、VS Code、CLI など）が Netdata に接続し、インフラストラクチャをクエリします。サーバーのセットアップについてはこのページを、クライアントごとの手順についてはサポート対象の AI クライアントをご覧ください。
• MCP クライアントとしての Netdata — Netdata Cloud がユーザー自身の MCP サーバー（GitHub、PagerDuty、Atlassian、または任意のカスタム HTTPS MCP サーバー）に接続し、Netdata AI がチームの組織内コンテキストをトラブルシューティングに取り込めるようにします。MCP 接続をご覧ください。

このページの残りの部分では、MCP サーバーとしての Netdataについて説明します。

Netdata は、AI アシスタントがインフラストラクチャの監視データを利用できる MCP サーバーを提供します。次の方法で接続できます。

• Netdata Cloud — https://app.netdata.cloud/api/v1/mcp にある、クラウドでホストされた単一のエンドポイントを通じて、すべてのノードを完全に可視化できます。ブリッジもファイアウォールの変更も不要です。
• ローカル Agent または Parent — ネットワーク上の任意の Netdata Agent または Parent （v2.6.0 以降）に、次の場所から直接接続します。 http://YOUR_IP:19999/mcp。

どちらの方法でも、MCP を通じて 利用可能なすべてのオブザーバビリティデータに包括的にアクセスできます。

• ノードの検出 - ハードウェア仕様、オペレーティングシステムの詳細、バージョン情報、ストリーミングトポロジー、関連するメタデータ
• メトリクスの検出 - コンテキスト、インスタンス、ディメンション、ラベルを横断した全文検索機能
• 機能の検出 - processes、network-connections、streaming、systemd-journal、windows-events などのシステム機能へのアクセス
• アラートの検出 - アクティブなアラートや発生したアラートをリアルタイムで可視化
• メトリクスのクエリ - ML を活用した異常検知を備えた、複雑な集計とグループ化
• メトリクスのスコアリング - 異常検知とメトリクスの相関関係を活用した根本原因分析
• アラート履歴 - アラートの遷移ログと状態変更の完全な記録
• 機能の実行 - 接続された任意のノードで Netdata の機能を実行（Netdata Parent が必要）
• ログの調査 - 接続された任意のノードのログにアクセス（Netdata Parent が必要）

AI アシスタントから見える範囲は、接続先によって異なります。

接続先	可視範囲
Netdata Cloud	インフラストラクチャ全体のすべてのノード
Netdata Parent	その Parent に接続されたすべての子ノード
Netdata Child/Standalone	その特定のノードのみ

機能	Cloud MCP	Agent/Parent MCP
範囲	すべてのノード	単一の agent/parent
エンドポイント	app.netdata.cloud/api/v1/mcp	YOUR_IP:19999/mcp
トランスポート	Streamable HTTP	HTTP、SSE、WebSocket
認証	Cloud API トークン（scope:mcp）	ローカル MCP API キー（ベアラー保護が有効な場合は必須）
ネットワークアクセス	インターネットのみ	Netdata IP への直接アクセスが必要
ローカルセットアップ	不要	クライアントによってはブリッジが必要な場合があります

Netdata Cloud MCP

単一の MCP エンドポイントを通じて AI アシスタントを Netdata Cloud の インフラストラクチャ全体に接続できます。 ローカルセットアップ、ブリッジ、ファイアウォールの変更は不要です。

前提条件

1. 有料プランのNetdata Cloud アカウント
2. scope:mcp を持つAPI トークン — API Tokens 設定で作成してください
3. Netdata Cloud に登録済みのノード — Cloud MCP サーバーは、Netdata Cloud のスペースに接続されたノードにのみ アクセスできます。

エンドポイント

https://app.netdata.cloud/api/v1/mcp

トランスポート： Streamable HTTP（ステートレスで、ロードバランサーや CDN の背後でも動作します）

認証

Cloud MCP エンドポイントへのすべてのリクエストには、 Authorization ヘッダーに Bearer トークンが必要です。

Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN

API トークンの作成

1. Netdata Cloud にログインします
2. 左下にあるプロフィール画像をクリックします
3. ユーザー設定を選択します
4. API トークンセクションに移動します
5. scope:mcp を指定して新しいトークンを作成します
6. トークンをコピーして安全に保管します。トークンを再度確認することはできません

詳しくは、API トークンをご覧ください。

接続設定

Claude Code（1 行でセットアップ）

Claude Code を使用している場合は、JSON を編集せずに、どのセッションからでも 1 つのコマンドで Netdata Cloud MCP サーバーを登録できます。

claude mcp add --transport http --scope user netdata-cloud \
  https://app.netdata.cloud/api/v1/mcp \
  --header "Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN"

YOUR_NETDATA_CLOUD_API_TOKEN を scope:mcp を持つトークンに置き換えます。上記のAPI トークンの作成を参照するか、Netdata Cloud の ユーザー設定 → API トークンに直接移動してください。

スコープフラグ：

• --scope user — このマシン上のすべてのプロジェクトで利用できます（個人利用におすすめ）
• --scope local — このプロジェクトのみで利用でき、自分だけが使えます（--scope を省略した場合のデフォルト）
• --scope project — このプロジェクトで利用でき、.mcp.json にチェックインしてチームと共有されます（生のトークンでは使用しないでください。代わりに環境変数を参照してください）

便利な関連コマンド：

claude mcp list                          # show all configured servers and their connection status
claude mcp get netdata-cloud             # show the configuration for this server
claude mcp remove netdata-cloud -s user  # remove the server (match the scope you added with)

サーバーを追加した後、Claude Code セッションを再起動すると、新しいツールが読み込まれます。

Netdata Agent または Parent への接続など、Claude Code のその他のオプションについては、Claude Code ガイドをご覧ください。

汎用 MCP クライアント（HTTP トランスポート）

Streamable HTTP トランスポートに対応するすべての MCP クライアントで使用できます。

{
  "mcpServers": {
    "netdata-cloud": {
      "type": "http",
      "url": "https://app.netdata.cloud/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NETDATA_CLOUD_API_TOKEN"
      }
    }
  }
}

stdio ブリッジが必要なクライアント

stdio トランスポートのみをサポートする MCP クライアントでは、ブリッジとして npx mcp-remote を使用します。

{
  "mcpServers": {
    "netdata-cloud": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://app.netdata.cloud/api/v1/mcp",
        "--header",
        "Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN"
      ]
    }
  }
}

YOUR_NETDATA_CLOUD_API_TOKEN を、scope:mcp が必要な API トークン に置き換えます。

Cloud MCP のトラブルシューティング

認証エラー

• API トークンに scope:mcp が設定されていることを確認します
• トークンがクエリパラメーターではなく、Authorization: Bearer <token> として渡されていることを確認します
• Netdata Cloud のサブスクリプションに、有料プランのスペースが含まれていることを確認します

ノードが表示されない

• ノードが Netdata Cloud に登録され、ウェブダッシュボードに表示されていることを確認します
• Agent がオンラインで、Cloud にデータをストリーミングしていることを確認します

接続の問題

• エンドポイントは HTTPS を使用するため、--allow-http フラグは不要です
• 接続をテストします：curl -H "Authorization: Bearer YOUR_TOKEN" https://app.netdata.cloud/api/v1/mcp

ローカル Agent または Parent の MCP

ネットワーク上の任意の Netdata Agent または Parent に直接接続します。すべての Netdata Agent と Parent（v2.6.0 以降）には、http://YOUR_IP:19999/mcp に組み込みの MCP サーバーが含まれています。

Netdata は起動時にローカル MCP API キーを自動生成します。認証の動作は [web].bearer token protection によって異なります。

• Bearer 保護が無効（no）：機密性の低い操作（メトリクス、アラート、ノード情報）では匿名の MCP アクセスが可能です。API キーを使うと機密性の高い操作が可能になります。
• Bearer 保護が有効（yes）：すべての MCP トランスポート（HTTP、SSE、WebSocket）で匿名の MCP アクセスが拒否されます。すべての MCP リクエストに API キーが必要です。
• 登録が必要：Agent が API キーを受け入れるのは、Netdata Cloud に登録されている間だけです。未登録の Agent ではすべてのキーが拒否されるため、Bearer 保護が有効な場合、MCP は利用できません。
• MCP のみ：API キーでは Agent の REST API（/api/...）を認証できません。Bearer 保護が有効な場合、これらのエンドポイントには引き続き Cloud が発行した Bearer トークンが必要です。

トランスポートオプション

Netdata は、複数のトランスポートオプションで MCP プロトコルを実装しています。

トランスポート	エンドポイント	用途	バージョン要件
WebSocket	ws://YOUR_IP:19999/mcp	従来のトランスポート。stdio クライアントには nd-mcp ブリッジが必要です	v2.6.0+
HTTP Streamable	http://YOUR_IP:19999/mcp	HTTP に対応する AI クライアントからの直接接続	v2.7.2+
SSE	http://YOUR_IP:19999/sse	リアルタイムストリーミングのための Server-Sent Events	v2.7.2+

• 直接接続（v2.7.2+）：HTTP または SSE トランスポートに対応する AI クライアントは、Netdata に直接接続できます
• ブリッジが必要：stdio のみ対応する AI クライアントには、nd-mcp（stdio から WebSocket）または mcp-remote（stdio から HTTP、または stdio から SSE）ブリッジが必要です
• 推奨される認証：MCP API キーを Authorization: Bearer <mcp_key> で渡してください。
• 後方互換性：WebSocket は ?api_key=<mcp_key> も受け付けます。URL のクエリ文字列はプロキシやツールによってログに記録される可能性が高いため、これはレガシークライアントに限って使用してください。
• リクエスト制限：HTTP または SSE のリクエストボディは約 1 MiB、WebSocket メッセージは最大 1 MiB です（これを超えるとコード 1009 で接続が閉じられます）。JSON-RPC バッチには最大 64 件のリクエストを含められます。レスポンスが 16 MiB に達すると、残りのリクエストは実行されません。id を持つ有効な各リクエストには -32001 エラーが返され、上限を超えるレスポンスも同じエラーに置き換えられます。

netdata.conf での MCP アクセス制御

専用の MCP ACL を使用して、ダッシュボードやストリーミングとは独立して、ネットワークレベルの MCP アクセスを制御します。

[web]
    allow connections from = 10.* 192.168.* localhost
    allow dashboard from = 10.* 192.168.* localhost
    allow mcp from = 10.* 192.168.* localhost
    allow streaming from = *
    allow mcp by dns = heuristic

• allow mcp from は、/mcp、/sse、および MCP WebSocket プロトコルへのアクセスを制御します。
• allow connections from は、引き続きすべての機能に対するグローバルな最初のゲートです。
• インターネットに公開する親サーバーでは、allow mcp from を信頼できるネットワークに制限してください。

公式 MCP リモートクライアント（mcp-remote）

AI クライアントが HTTP／SSE に直接対応しておらず、nd-mcp を使いたくない場合は、公式 MCP リモートクライアントを使用できます（Netdata v2.7.2+ が必要です）。

# Export your MCP key once per shell
export NETDATA_MCP_API_KEY="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"

# For HTTP transport
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer $NETDATA_MCP_API_KEY"

# For SSE transport
npx mcp-remote@latest --sse http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer $NETDATA_MCP_API_KEY"

注記： HTTPS 以外の接続では --allow-http フラグが必要です。トラフィックは暗号化されないため、信頼できるネットワークでのみ使用してください。

nd-mcp ブリッジの確認

注記：新しい HTTP および SSE トランスポートを使用すると、多くの AI クライアントは nd-mcp を介さずに Netdata に直接接続できます。AI クライアントのドキュメントを確認し、HTTP または SSE による直接接続に対応しているか確認してください。

nd-mcp ブリッジが必要なのは、以下の AI クライアントに限られます。

• stdio 通信のみに対応する（デスクトップアプリケーションの一部など）
• HTTP または SSE トランスポートを直接使用できない
• npx mcp-remote@latest を使用できない

nd-mcp ブリッジは、AI クライアントを実行するデスクトップまたはノート PC で利用できる必要があります。多くのユーザーは Netdata をローカルマシンではなくリモートサーバーで実行するため、次の 2 つの方法があります。

1. Netdata をローカルにインストールしている場合 - 既存の nd-mcp を使用します
2. Netdata がリモートサーバーにのみインストールされている場合 - デスクトップ／ノート PC で nd-mcp をビルドします

方法 1：既存の nd-mcp を使用する

Netdata をデスクトップ／ノート PC にインストールしている場合は、既存のブリッジを探します。

Linux

# Try these locations in order:
which nd-mcp
ls -la /usr/sbin/nd-mcp
ls -la /usr/bin/nd-mcp
ls -la /opt/netdata/usr/bin/nd-mcp
ls -la /usr/local/bin/nd-mcp
ls -la /usr/local/netdata/usr/bin/nd-mcp

# Or search for it:
find / -name "nd-mcp" 2>/dev/null

一般的な場所：

• ネイティブパッケージ（apt、yum など）：/usr/sbin/nd-mcp または /usr/bin/nd-mcp
• 静的インストール：/opt/netdata/usr/bin/nd-mcp
• ソースからビルドした場合：/usr/local/netdata/usr/bin/nd-mcp

macOS

# Try these locations:
which nd-mcp
ls -la /usr/local/bin/nd-mcp
ls -la /usr/local/netdata/usr/bin/nd-mcp
ls -la /opt/homebrew/bin/nd-mcp

# Or search for it:
find / -name "nd-mcp" 2>/dev/null

Windows

# Check common locations:
dir "C:\Program Files\Netdata\usr\bin\nd-mcp.exe"
dir "C:\Netdata\usr\bin\nd-mcp.exe"
# Or search for it:
where nd-mcp.exe

オプション 2：デスクトップ用の nd-mcp のビルド

Netdata をローカルにインストールしていない場合は、nd-mcp ブリッジのみをビルドできます。Netdata では 3 種類の実装を用意しています。環境に最適なものを選択してください。

1. Go ブリッジ（推奨） - Go ブリッジのソースコード

   • 依存関係のない単一のバイナリを生成します
   • nd-mcp（Windows では nd-mcp.exe）という名前の実行ファイルを作成します
   • build.sh と build.bat（Windows 用）の両方が含まれています

2. Node.js ブリッジ - Node.js ブリッジのソースコード

   • Node.js がすでにインストールされている場合に適しています
   • nd-mcp.js という名前のスクリプトを作成します
   • build.sh が含まれています

3. Python ブリッジ - Python ブリッジのソースコード

   • Python がすでにインストールされている場合に適しています
   • nd-mcp.py という名前のスクリプトを作成します
   • build.sh が含まれています

ビルドするには：

# Clone the Netdata repository
git clone https://github.com/netdata/netdata.git
cd netdata

# Choose your preferred implementation
cd src/web/mcp/bridges/stdio-golang/  # or stdio-nodejs/ or stdio-python/

# Build the bridge
./build.sh  # On Windows with the Go version, use build.bat

# The executable will be created with different names:
# - Go: nd-mcp
# - Node.js: nd-mcp.js
# - Python: nd-mcp.py

# Test the bridge with your Netdata instance (replace localhost with your Netdata IP)
./nd-mcp ws://localhost:19999/mcp      # Go bridge
./nd-mcp.js ws://localhost:19999/mcp   # Node.js bridge  
./nd-mcp.py ws://localhost:19999/mcp   # Python bridge

# You should see:
# nd-mcp: Connecting to ws://localhost:19999/mcp...
# nd-mcp: Connected
# Press Ctrl+C to stop the test

# Get the absolute path for your AI client configuration
pwd  # Shows current directory
# Example output: /home/user/netdata/src/web/mcp/bridges/stdio-golang
# Your nd-mcp path would be: /home/user/netdata/src/web/mcp/bridges/stdio-golang/nd-mcp

重要：AI クライアントを設定する際は、実行ファイルの絶対パスを指定してください。

• Go ブリッジ：/path/to/bridges/stdio-golang/nd-mcp
• Node.js ブリッジ：/path/to/bridges/stdio-nodejs/nd-mcp.js
• Python ブリッジ：/path/to/bridges/stdio-python/nd-mcp.py

ブリッジが動作することを確認する

既存のインストールから nd-mcp を取得した場合も、ビルドした場合も、次のようにテストします。

# Test connection to your Netdata instance (replace YOUR_NETDATA_IP with actual IP)
/path/to/nd-mcp ws://YOUR_NETDATA_IP:19999/mcp

# You should see:
# nd-mcp: Connecting to ws://YOUR_NETDATA_IP:19999/mcp...
# nd-mcp: Connected
# Press Ctrl+C to stop the test

MCP リモートクライアントの使用

公式の MCP リモートクライアント（mcp-remote）は、stdio のみをサポートする AI クライアントが Netdata の HTTP および SSE トランスポートに接続できるようにする代替ブリッジです（Netdata v2.7.2 以降が必要です）。WebSocket のみをサポートする nd-mcp と異なり、mcp-remote はより幅広いトランスポートとの互換性を提供します。

MCP リモートを使用する場面

次の場合は mcp-remote を使用してください。

• AI クライアントが stdio 通信のみをサポートしている
• WebSocket ではなく HTTP または SSE トランスポートを使用したい
• Netdata v2.7.2 以降を実行している
• nd-mcp をビルドまたはインストールしたくない

インストール

インストールは不要です。mcp-remote は npx 経由で実行されます。

# Test the connection
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer YOUR_API_KEY"

トランスポートオプション

mcp-remote は複数のトランスポート方式をサポートしています。

# HTTP transport (recommended)
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer YOUR_API_KEY"

# SSE transport
npx mcp-remote@latest --sse http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer YOUR_API_KEY"

# Auto-detect with fallback (tries SSE first, falls back to HTTP)
npx mcp-remote@latest --transport sse-first http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer YOUR_API_KEY"

# HTTPS (no --allow-http flag needed)
npx mcp-remote@latest --http https://YOUR_NETDATA_IP:19999/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

共通オプション

オプション	説明	例
--http	HTTP トランスポートを使用	--http http://host:19999/mcp
--sse	SSE トランスポートを使用	--sse http://host:19999/mcp
--allow-http	HTTPS 以外の接続を許可（HTTP URL で必要）	--allow-http
--header	カスタムヘッダーを追加（認証用）	--header "Authorization: Bearer KEY"
--transport	トランスポート方式	--transport sse-first（SSE を試し、失敗した場合は HTTP に切り替えます）
--debug	デバッグログを有効化	--debug
--host	OAuth コールバックのホスト（デフォルト：localhost）	--host 127.0.0.1
ポート番号	OAuth コールバックのポート（任意）	9696

認証

Netdata MCP の場合は、Authorization ヘッダーを介して API キーを渡してください。

# Using environment variable (recommended)
export NETDATA_MCP_API_KEY="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"

npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer $NETDATA_MCP_API_KEY"

セキュリティに関する注意：HTTPS 以外の接続には --allow-http フラグが必要です。通信は暗号化されないため、信頼できるネットワークでのみ使用してください。

トラブルシューティング

接続の問題：

# Enable debug logging
npx mcp-remote@latest --debug --http http://YOUR_NETDATA_IP:19999/mcp \
  --allow-http \
  --header "Authorization: Bearer YOUR_API_KEY"

# Check debug logs (stored in ~/.mcp-auth/)
cat ~/.mcp-auth/*_debug.log

認証状態のクリア：

# Remove cached credentials
rm -rf ~/.mcp-auth

引数内のスペース：

一部の AI クライアント（Cursor、Windows 上の Claude Desktop）では、引数内のスペースに問題が発生します。回避策として環境変数を使用してください。

{
  "mcpServers": {
    "netdata": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "--http",
        "http://YOUR_IP:19999/mcp",
        "--allow-http",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

バージョン管理

常に最新バージョンを使用してください。

# Force npx to check for latest version
npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp

または、AI クライアントの設定で指定します。

{
  "args": ["mcp-remote@latest", "--http", "..."]
}

詳しくは、mcp-remote の公式ドキュメントをご覧ください。

API キーの確認方法

ベアラー保護が有効な場合は、MCP API キーが必要です。ベアラー保護が無効な場合でも、ログやシステムのライブ情報などの機密機能にはキーが必要です。Netdata は起動時に API キーを自動生成します。このキーは、接続先の Netdata サーバー上のファイルに保存されています。

接続する Netdata（通常は Netdata Parent）の API キーが必要です。

注：この一時的な API キーの仕組みは、最終的に Netdata Cloud との連携に置き換えられる予定です。

API キーのファイルを確認する

# Try the default location first:
sudo cat /var/lib/netdata/mcp_dev_preview_api_key

# For static installations:
sudo cat /opt/netdata/var/lib/netdata/mcp_dev_preview_api_key

# If not found, search for it:
sudo find / -name "mcp_dev_preview_api_key" 2>/dev/null

API キーをコピーする

ファイルには、次のような UUID が記載されています。

a1b2c3d4-e5f6-7890-abcd-ef1234567890

この文字列全体をコピーしてください。AI クライアントの設定で必要になります。

API キーのファイルがない場合

ファイルが存在しない場合：

1. Netdata が最新バージョンであることを確認します
2. Netdata を再起動します：sudo systemctl restart netdata
3. 再起動後、もう一度ファイルを確認します

AI クライアントの設定

AI クライアントは、対応するトランスポートに応じて、さまざまな方法で Netdata MCP に接続できます。

直接接続（HTTP/SSE）

HTTP または SSE トランスポートに対応する AI クライアントの場合：

{
  "mcpServers": {
    "netdata": {
      "type": "http",
      "url": "http://IP_OF_YOUR_NETDATA:19999/mcp",
      "headers": [
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

または、SSE の場合：

{
  "mcpServers": {
    "netdata": {
      "type": "sse",
      "url": "http://IP_OF_YOUR_NETDATA:19999/mcp?transport=sse",
      "headers": [
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

nd-mcp ブリッジの使用（stdio）

stdio のみに対応する AI クライアントの場合：

{
  "mcpServers": {
    "netdata": {
      "command": "/usr/sbin/nd-mcp",
      "args": [
        "--bearer",
        "YOUR_API_KEY",
        "ws://IP_OF_YOUR_NETDATA:19999/mcp"
      ]
    }
  }
}

公式 MCP リモートクライアントの使用

{
  "mcpServers": {
    "netdata": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "--http",
        "http://IP_OF_YOUR_NETDATA:19999/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

次の項目を置き換えてください。

• IP_OF_YOUR_NETDATA：Netdata インスタンスの IP アドレス／ホスト名
• YOUR_API_KEY：上記のファイルに記載されている API キー
• /usr/sbin/nd-mcp：実際の nd-mcp のパス（ブリッジを使用する場合）

複数の MCP サーバー

複数の Netdata インスタンスを設定できます。

{
  "mcpServers": {
    "netdata-production": {
      "command": "/usr/sbin/nd-mcp",
      "args": ["--bearer", "PROD_KEY", "ws://prod-parent:19999/mcp"]
    },
    "netdata-testing": {
      "command": "/usr/sbin/nd-mcp",
      "args": ["--bearer", "TEST_KEY", "ws://test-parent:19999/mcp"]
    }
  }
}

レガシーのクエリ文字列への対応

古いツールとの互換性のため、Netdata は引き続き /mcp エンドポイントで ?api_key=YOUR_API_KEY クエリパラメーターを受け付けます。新しい連携では Authorization: Bearer YOUR_API_KEY ヘッダーを推奨しますが、段階的に移行する場合はクエリ文字列形式も引き続き利用できます。

AI クライアント別のドキュメント

各 AI クライアントの詳しい設定手順については、以下をご覧ください。

チャットクライアント：

• Claude Desktop - Anthropic のデスクトップ AI アシスタント
• Cursor - AI を活用したコードエディター
• Visual Studio Code - MCP に対応した VS Code
• JetBrains IDEs - IntelliJ、PyCharm、WebStorm など

DevOps コパイロット：

• Claude Code - Claude 用の Anthropic の CLI
• Gemini CLI - Google の Gemini CLI
• OpenAI Codex CLI - OpenAI の Codex CLI
• Crush - Charmbracelet の洗練されたターミナル AI
• OpenCode - SST のターミナルベースの AI アシスタント

各ガイドには、そのクライアントに合わせて最適化されたトランスポート対応状況の一覧と設定例が含まれています。