Set up New Relic MCP

This guide walks you through setting up New Relic's Model Context Protocol (MCP) server with your preferred supported MCP clients. Choose your environment below for platform-specific instructions.

Before you begin the New Relic MCP setup, ensure you have completed the prerequisites, including the authentication setup. Then, follow the instructions for your specific development environment.

Filtering tools with include-tags

The New Relic MCP tools are organized and categorized using internal tags (such as alerting, discovery, and data-access). For details, refer to filter tools

You can dynamically filter the tools your AI agent accesses by sending the include-tags HTTP header with your requests as shown here:

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

For the complete list of available tags and the tools associated with each, refer to the New Relic MCP tool reference documentation.

Claude Code setup

Claude Code supports OAuth authentication method. OAuth requires Claude Code version 2.1.186 or later. If you are on older versions, you should authenticate via /mcp inside Claude instead of claude MCP login.

1. Ensure you have Claude Code installed and configured.

2. Add the MCP server using the command line:

   bash

   Copy

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

   Or, edit ~/.claude.json as shown here:

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

   Copy

3. Follow the browser OAuth flow to complete authentication.

If you encounter connection errors after setup, refer to Unexpected connection error in Claude Code and Stale OAuth credentials in Claude Desktop.

Codex setup

Codex supports OAuth authentication method. OAuth requires Codex version 0.154.0 or later.

1. Ensure you have Codex installed and configured.

2. Add the MCP server using the command line:

   bash

   Copy

   $
   codex mcp add newrelic --url https://mcp.newrelic.com/mcp/

   Or, edit ~/.codex/config.toml as shown here:

   bash

   Copy

   $
   [mcp_servers.newrelic]
   $
   url = "https://mcp.newrelic.com/mcp/"

3. Follow the browser OAuth flow to complete authentication.

Antigravity CLI setup

1. Ensure you have Antigravity CLI installed on your machine.

2. Configure the MCP server by opening (or creating) the configuration file:

   • macOS/Linux: ~/.gemini/config/mcp_config.json

   • Windows: %USERPROFILE%\.gemini\config\mcp_config.json

     Add the following configuration:

     {
       "mcpServers": {
         "newrelic": {
           "serverUrl": "https://mcp.newrelic.com/mcp/",
           "headers": {
             "api-key": "NRAK-YOUR-KEY-HERE"
           }
         }
       }
     }

     Copy

3. Start Antigravity CLI:

   bash

   Copy

   $
   agy

4. Run /mcp to verify the New Relic server is connected.

Kiro CLI setup

1. Ensure you have the Kiro CLI tool installed on your machine.

2. Configure the MCP server by opening (or creating) the configuration file located at ~/.kiro/settings/mcp.json and add the following configuration:

   {
     "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",
           "scopes": ["observability:read", "offline", "offline_access"],
           "usePKCE": true
         },
         "disabled": false
       }
     }
   }

   Copy

3. Authenticate and connect:

   • Open your terminal and run kiro-cli.
   • Type the command /mcp and hit enter.
   • You will see the New Relic server listed with a URL. Open that URL in your browser.
   • Complete the standard New Relic login process.
   • After you're authenticated, the browser will confirm success.

Claude Desktop setup

Claude Desktop requires the mcp-remote proxy for OAuth authentication. Ensure you have Node.js installed on your computer for npx to work.

1. Create the config directory (if needed):

   bash

   Copy

   $
   mkdir -p "~/Library/Application Support/Claude"

2. Edit the config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

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

   Copy

3. Restart Claude Desktop.

VS Code setup

You need VS Code (version 1.91 or later).

1. Add the MCP server by editing .vscode/mcp.json as shown here:

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

   Copy

2. Create or open mcp.json in your VS Code workspace:

   • If you don't have a .vscode directory, create one in your project root.
     • Inside .vscode, create a file named mcp.json.
     • Add your authentication configuration.

3. Start server:

   • Ensure your mcp.json file is open in the editor.
   • Look for a clickable link (CodeLens) above your server configuration. Click it to start the MCP server.

Once connected, you can interact with New Relic AI using natural language prompts. The MCP server will manage authentication and data retrieval from your New Relic account.