このガイドでは、サポートされている任意のMCPクライアントを使用してNew RelicのModel Context Protocol(MCP)サーバーをセットアップする手順を説明します。以下から利用環境を選択すると、プラットフォームごとの手順を確認できます。
重要
このページに記載されているものに限らず、AIツールをNew Relic AI MCPサーバーと組み合わせて使用すると、AIがユーザーに代わってNew Relicアカウント内で操作を実行することになります。このページで説明されているいずれかの方法を使用する場合は、適切なNew Relicアカウントを作成し、ユースケース、要件、社内ポリシーに応じたロールベースのアクセス制御(RBAC)と必要最小限の権限を設定したうえで使用してください。
New Relic MCPのセットアップを開始する前に、認証のセットアップなどの必要な手順を完了していることを確認してください。次に、使用している開発環境向けの手順に従ってください。
include-tagsによるツールの絞り込み
New Relic MCPツールは、内部タグ(alerting、discovery、data-accessなど)を使用して整理・分類されます。詳細については、フィルターツールを参照してください。
以下に示すように、requestsにinclude-tags HTTPヘッダーを送信することで、AIエージェントがアクセスするツールを動的にフィルタリングできます。
重要
リージョンに関する注意事項:このトピックの設定例では、USリージョン(デフォルト)のMCP接続URL(https://mcp.newrelic.com/mcp/)を使用しています。別のリージョンのNew Relicアカウントをご利用の場合は、すべての設定ファイルとコマンドライン引数で、このURLをそのリージョンのエンドポイントに置き換えてください。
"servers": { "new-relic-mcp-server": { "url": "https://mcp.newrelic.com/mcp/", "type": "http", "headers": { "include-tags": "discovery,alerting" } }}利用可能なタグとそれぞれに関連付けられたツールの完全なリストについては、New Relic MCPツールリファレンスのドキュメントを参照してください。
重要
このドキュメントで特に明記されていない限り、サポートされているMCPクライアントはOAuth方式でのみセットアップしてください。特に明記されていない限り、APIキーを使用してセットアップした場合、このドキュメントの記載どおりにも、意図したとおりにも動作しません。
Claude Codeセットアップ
Claude Codeは、OAuth認証方法をサポートしています。OAuthを利用するには、Claude Codeバージョン2.1.186以降が必要です。旧バージョンを使用している場合は、claude MCP loginではなく、Claude内で/mcpを使用して認証してください。
Claude Codeのインストールと設定が完了していることを確認してください。
コマンドラインを使用してMCPサーバーを追加します。
bash$claude mcp add --transport http --scope user newrelic https://mcp.newrelic.com/mcp/$claude mcp login newrelicまたは、次のように
~/.claude.jsonを編集します。{"mcpServers": {"newrelic": {"type": "http","url": "https://mcp.newrelic.com/mcp/"}}}ブラウザでのOAuth認証手順に従って、認証を完了してください。
セットアップ後に接続エラーが発生した場合は、Claude Codeでの予期しない接続エラーやClaude Desktopでの古いOAuth認証情報を参照してください。
Codexのセットアップ
Codexは、OAuth認証方法をサポートしています。OAuthを利用するには、Codexバージョン0.154.0以降が必要です。
Codexのインストールと設定が完了していることを確認してください。
コマンドラインを使用してMCPサーバーを追加します。
bash$codex mcp add newrelic --url https://mcp.newrelic.com/mcp/または、次のように
~/.codex/config.tomlを編集します。bash$[mcp_servers.newrelic]$url = "https://mcp.newrelic.com/mcp/"ブラウザでのOAuth認証手順に従って、認証を完了してください。
Antigravity CLIのセットアップ
重要
現在、Antigravity CLIはAPIキー方式のみに対応しています。OAuthには未対応です。
Antigravity CLIがマシンにインストールされていることを確認します。
設定ファイルを開き(または作成し)、以下のようにMCPサーバーを設定します。
- macOS/Linux:
~/.gemini/config/mcp_config.json - Windows:
%USERPROFILE%\.gemini\config\mcp_config.json
以下の設定を追加します。
{"mcpServers": {"newrelic": {"serverUrl": "https://mcp.newrelic.com/mcp/","headers": {"api-key": "NRAK-YOUR-KEY-HERE"}}}}- macOS/Linux:
Antigravity CLIを起動します。
bash$agy/mcpを実行して、New Relicのサーバーが接続されていることを確認します。
Kiro CLIのセットアップ
- マシンにKiro CLIツールがインストールされていることを確認します。
~/.kiro/settings/mcp.jsonにある設定ファイルを開き(または作成し)、以下の設定を追加して、MCPサーバーを設定します。
{ "mcpServers": { "newrelic-mcp-server": { "url": "https://mcp.newrelic.com/mcp/", "oauth": { "authorizationUrl": "https://oauth2.service.newrelic.com/oauth2/auth", "tokenUrl": "https://oauth2.service.newrelic.com/oauth2/token", "oauthScopes": ["observability:read", "offline", "offline_access"], "usePKCE": true }, "disabled": false } }}認証して接続します。
- ターミナルを開き、
kiro-cliを実行します。 - コマンド
/mcpを入力してEnterキーを押します。 - New RelicサーバーがURLとともにリストに表示されます。ブラウザでそのURLを開きます。
- 標準のNew Relicログインプロセスを完了します。
- 認証が完了すると、ブラウザで正常に完了したことが表示されます。
- ターミナルを開き、
Claude Desktopのセットアップ
Claude Desktopでは、OAuth認証にmcp-remoteプロキシが必要です。npxを使用するには、コンピューターにNode.jsがインストールされていることを確認します。
- 設定ディレクトリを作成します(必要な場合)。
$mkdir -p "~/Library/Application Support/Claude"設定ファイルを編集します:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または%APPDATA%\Claude\claude_desktop_config.json(Windows)。{"mcpServers": {"new-relic-mcp": {"command": "npx","args": ["-y", "mcp-remote", "https://mcp.newrelic.com/mcp/"]}}}Claude Desktopを再起動します。
VS Codeのセットアップ
VS Code(バージョン1.91以降)が必要です。
- 次のように、
.vscode/mcp.jsonを編集してMCPサーバーを追加します。
{ "servers": { "new-relic-mcp": { "url": "https://mcp.newrelic.com/mcp/", "type": "http" } }}VS Codeのワークスペースで
mcp.jsonを作成または開きます。.vscodeディレクトリがない場合は、プロジェクトのルートに作成してください。.vscode内に、mcp.jsonという名前のファイルを作成します。- 認証設定を追加します。
サーバーを起動します。
- エディターで
mcp.jsonファイルが開かれていることを確認してください。 - サーバー設定の上にあるクリック可能なリンク(CodeLens)を探します。そのリンクをクリックしてMCPサーバーを起動します。
- エディターで
接続が完了すると、自然言語プロンプトを使ってNew Relic AIとやり取りできます。MCPサーバーは、New Relicアカウントの認証およびデータ取得を管理します。