ClaudeとNew Relic MCPを連携する手順 — 接続と認証の選び方

ClaudeとNew Relicの連携で何ができるか

ClaudeでNew Relicを使うには、公式のNew Relic MCPサーバーを登録し、OAuthで認証します。Claude Codeならclaude mcp addとclaude mcp loginの2コマンドです。

New Relicはmcp.newrelic.comへのリモート接続で使えるMCPサーバーを公式提供しています。ローカルにサーバーをインストールする必要はありません。接続すると、NRQLクエリの実行、アラートポリシーの調査、デプロイの影響分析、エラーやログの傾向の把握を自然言語の依頼で扱えます。

対応クライアントは、Claude Code・Claude Desktop・VS Code・Antigravity CLI・Kiro CLIです。セットアップ手順にはCodexもあります。

この連携には落とし穴が2つあります。1つは、接続の前にNew Relicの管理者側で済ませる設定があること。もう1つは、認証にAPIキーを選ぶと使えなくなる主力ツールがあることです。以降はこの2点を軸に、Claude Codeでの接続から障害調査までを順に追います。

接続の前に、管理者側で必要になる設定

Claude側のコマンドを打つ前に、New Relicの管理者が済ませておくことが2つあります。

Node.jsのインストール(一部の認証方式で必要)も前提です。アカウントの種別によって使えるツールが変わります。全データ・CCU(Core Compute Unit)ユーザーはコアツール、aCCU(Advanced Compute Capacity Unit)ユーザーは高度なツールを含む全ツールを使えます。

接続先のリージョンとエンドポイント

New Relicはリージョンごとに異なるMCPエンドポイントを用意しています。

サーバー本体はHTTPトランスポートのリモート接続で、stdio型のようにローカルでプロセスを起動する方式ではありません。ただしClaude Desktopだけは、mcp-remoteをローカルプロキシとして起動します。手元でバイナリやDockerイメージを管理せずに済みます。一方でNew Relicのデータが外部サービス経由で流れるため、権限設計は接続前に決める必要があります。

セットアップ例はすべてUSリージョンのURLで書かれており、別リージョンのアカウントは設定ファイルとコマンド引数の両方でURLを置き換えます。

Claude Codeで接続する

Claude Codeのclaude mcp addとclaude mcp loginで、登録と認証が済みます。

claude mcp add --transport http --scope user newrelic https://mcp.newrelic.com/mcp/
claude mcp login newrelic

--scopeはlocal(既定)・user・projectから選べます(v2.1.285のclaude mcp add --helpで確認)。New Relicの手順はuserを指定しており、設定は~/.claude.jsonに入ります。同じ内容を直接書くと次の形です。

{
  "mcpServers": {
    "newrelic": {
      "type": "http",
      "url": "https://mcp.newrelic.com/mcp/"
    }
  }
}

OAuthを使うには、Claude Code v2.1.186以降が必要です。それ以前のバージョンでは、claude mcp loginではなくClaude内の/mcpで認証します。

claude mcp loginにはSSHやヘッドレス向けの--no-browserがあります。認可URLを表示し、リダイレクト先のURLを貼り戻す方式で、ブラウザを開けないリモート端末でも人が操作できるなら認証を完了できます(v2.1.285のclaude mcp login --helpで確認)。ただし人の操作を挟むので、CIの無人実行には向きません。

APIキーで登録すると、設定ファイルに平文で残る

APIキー方式は、ヘッダーでキーを渡します。作業ディレクトリでダミー値を使って--scope projectで登録したところ、.mcp.jsonは次のようになりました(v2.1.285で確認)。

{
  "mcpServers": {
    "newrelic": {
      "type": "http",
      "url": "https://mcp.newrelic.com/mcp/",
      "headers": {
        "api-key": "NRAK-DUMMY"
      }
    }
  }
}

コマンド出力ではキーが[REDACTED]と伏せられますが、ファイルにはそのまま書かれます。projectスコープの.mcp.jsonはリポジトリで共有する前提の設定なので、実際のキーで登録してコミットすると漏れます。キーを使うなら、既定のlocalかuserスコープを選び、.mcp.jsonにはキーを入れない運用が安全です。

同じディレクトリでclaude mcp get newrelicを実行すると、共有設定のサーバーは承認前として表示されます。

newrelic:
  Scope: Project config (shared via .mcp.json)
  Status: ⏸ Pending approval (run `claude` to approve)
  Type: http
  URL: https://mcp.newrelic.com/mcp/
  Headers:
    api-key: NRAK-DUMMY

なお、この確認ではNew Relicへの接続も認証もしていません。

Claude Desktop / VS Codeで接続する

Claude Desktopはmcp-remoteをローカルプロキシとして使い、OAuthのブラウザフローをリモートMCPサーバーへ橋渡しします。設定後はClaude Desktopの再起動が必要です。

{
  "mcpServers": {
    "new-relic-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.newrelic.com/mcp/"]
    }
  }
}

設定ファイルの場所はmacOSが~/Library/Application Support/Claude/claude_desktop_config.json、Windowsが%APPDATA%\Claude\claude_desktop_config.jsonです。

VS Code(1.91以降)は、ワークスペースの.vscode/mcp.jsonにHTTP接続を直接書きます。

{
  "servers": {
    "new-relic-mcp": {
      "url": "https://mcp.newrelic.com/mcp/",
      "type": "http"
    }
  }
}

mcp.jsonを開くと設定の上にCodeLensのリンクが出るので、それを押してサーバーを起動します。

OAuthかAPIキーか — 使えるツールが変わる

セットアップ手順は、Antigravity CLIを除いてOAuthだけを前提にしています。「APIキーでの設定は、このドキュメントの説明どおりには動かない」とも書かれています。APIキーのヘッダー設定を載せているのはAntigravity CLIの手順だけです。

そのうえで、APIキーとOAuthでは使えるツールが違います。

つまり「CIではAPIキー」と単純には決められません。CIで自動化したい処理が「デプロイ影響分析」なら、その中核のanalyze_deployment_impactがAPIキーでは呼べないからです。CIから使う場合は、execute_nrql_queryとlist_change_eventsなどの基本ツールで組み立てられる範囲に絞ることになります。

APIキーを使うときは、最小権限のユーザーで発行します。キーで動くツールは、そのユーザーが持つ権限の範囲でしかデータを返せません。

使えるツールとタグ

New Relic MCPのツールは、discovery・data-access・alerting・incident-response・performance-analytics・advanced-analysisの6タグに分類されています。主なものを並べます。

表に載せた以外にも、Synthetic監視のlist_synthetic_monitorsとget_synthetic_check_statistics、analyze_golden_metrics、get_error_statisticsとsearch_errorsがあります。

analyze_transactionsはP95・P99のレイテンシー(遅い側5%・1%の応答時間の境目)を含めて、遅いトランザクションとエラーの多いトランザクションを特定します。generate_alert_insights_reportとgenerate_user_impact_reportは、どちらも特定のIssueを指定して使うツールです。「先月どのポリシーが最も多く鳴ったか」のような期間集計は、これらのレポートの守備範囲ではありません。そうした振り返りは、search_incidentの結果やexecute_nrql_queryで自分で集計する形になります。

natural_language_to_nrql_queryは、自然言語の依頼文をNRQLに変換し、実行して結果まで返すツールです。

include-tagsでツールを絞る

ツールの数が多いと、モデルが選ぶ候補も増えます。include-tagsというHTTPヘッダーでツールを絞ると、ツール数が減り、精度と効率が上がるとされています。VS Codeの設定なら次のようになります。

{
  "servers": {
    "new-relic-mcp-server": {
      "url": "https://mcp.newrelic.com/mcp/",
      "type": "http",
      "headers": {
        "include-tags": "discovery,alerting"
      }
    }
  }
}

この設定では、discoveryとalertingのツールだけがモデルに見えます。調査専用のエージェントに、NRQL実行やレポート生成を持たせたくないときの制限としても使えます。

呼び出し回数と課金の枠

AI分析以外の多くのツールは、契約中のCore Computeの枠から消費するCCUとして計上されます。aCCUの対象になる4ツールは、OAuth専用の4ツールと同じ顔ぶれです。プレビューツールは読み取り専用で、価格は正式提供(GA)後に決まると書かれています。

障害調査で呼ばれうるツール

デプロイ後にアラートが鳴ったときの一次調査を例にします。どのツールを使うかは、AIエージェントが依頼文から自動で選びます。以下は依頼文と、その答えに使われうるツールの対応です。

NRQLを手で書かずに、会話で調査を進められます。根本原因の判断と対処の実行は、調査結果を材料にチーム側で決めます。

つまずいたときの切り分け

New Relicのトラブルシューティングにある症状と対処を、原因ごとに表にしました。

Claude Desktopでログアウトしても接続エラーが続くときは、複数の保存場所に古いOAuth情報が残っている可能性があります。New Relicのトラブルシューティングには、Claudeに保存場所を洗い出させるための依頼文が載っています。その依頼文は、変更の前に該当する保存場所を見せさせ、設定ファイルをバックアップしてから消すよう指示する作りです。

リージョンの取り違えも定番です。アカウントが別リージョンにある場合は、設定ファイルとコマンド引数のすべてでURLを該当リージョンのものに置き換えます。

権限設計は、読み取り専用から

New Relicは、AIがユーザーに代わってアカウント内で操作することを明記し、RBACと最小権限の原則で作ったアカウントを使うよう案内しています。ツールが返せるデータは、OAuthのユーザー(Antigravity CLIではAPIキー)に付いた権限の範囲に限られます。権限が足りない操作は、権限エラーで失敗します。

Organization Read Onlyのロールは、MCP接続に必要なデフォルトロール3種の1つです。調査だけの用途なら、書き込み権限を持たないロールから始める選択肢があります。設定変更まで任せるときにロールを広げても、遅くはありません。

まとめ

CIからの自動化を考えているなら、先にanalyze_deployment_impactなどのOAuth専用ツールが要るかを確かめます。要るなら人の操作を挟む対話利用が前提になり、要らないならexecute_nrql_query中心のAPIキー運用が現実的です。接続前には、管理者側のFeature controlとロールの設定も済ませておきます。

同じ監視・運用系の連携では、PrometheusのMCPサーバーがメトリクス基盤への自然言語クエリを担います。設定の一般的な流れはClaude Codeの完全ガイド、AWS側の操作はAWS CLI MCPサーバーで扱っています。