Configurar o New Relic MCP

Este guia orienta você na configuração do servidor do Model Context Protocol (MCP) da New Relic com os clientes MCP suportados de sua preferência. Escolha seu ambiente abaixo para obter instruções específicas da plataforma.

Antes de iniciar a configuração do New Relic MCP, certifique-se de ter concluído os pré-requisitos, incluindo a configuração de autenticação. Em seguida, siga as instruções específicas para o seu ambiente de desenvolvimento.

Filtrando ferramentas com include-tags

As ferramentas MCP do New Relic são organizadas e categorizadas usando tags internas (como alerting, discovery e data-access). Para obter detalhes, consulte as ferramentas de filtro

Você pode filtrar dinamicamente as ferramentas que seu agente de IA acessa enviando o cabeçalho include-tags HTTP com suas requests, conforme mostrado aqui:

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

Para obter a lista completa de tags disponíveis e as ferramentas associadas a cada uma, consulte a documentação de referência da ferramentaNew Relic MCP.

Configuração do código Claude

O Claude Code oferece suporte ao método de autenticação OAuth. O OAuth requer a versão 2.1.186 do Claude Code ou posterior. Se estiver em versões mais antigas, a autenticação deverá ser feita via /mcp no Claude em vez do login MCP do claude.

1. Certifique-se de que o Claude Code esteja instalado e configurado.

2. Adicione o servidor MCP usando a linha de comando:

   bash

   Copiar

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

   Ou edite ~/.claude.json como mostrado aqui:

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

   Copiar

3. Siga o fluxo OAuth do navegador para concluir a autenticação.

Em caso de erros de conexão após a configuração, consulte Erro de conexão inesperado no Claude Code e Credenciais OAuth obsoletas no Claude Desktop.

Configuração do Codex

O Codex suporta o método de autenticação OAuth. O OAuth requer o Codex versão 0.154.0 ou superior.

1. Certifique-se de ter o Codex instalado e configurado.

2. Adicione o servidor MCP usando a linha de comando:

   bash

   Copiar

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

   Ou edite ~/.codex/config.toml como mostrado aqui:

   bash

   Copiar

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

3. Siga o fluxo OAuth do navegador para concluir a autenticação.

Configuração da CLI Antigravity

1. Certifique-se de ter o Antigravity CLI instalado em sua máquina.

2. Configure o servidor MCP abrindo (ou criando) o arquivo de configuração:

   • macOS/Linux: ~/.gemini/config/mcp_config.json
   • Windows: %USERPROFILE%\.gemini\config\mcp_config.json

   Adicione a seguinte configuração:

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

   Copiar

3. Inicie a CLI Antigravity:

   bash

   Copiar

   $
   agy

4. Execute /mcp para verificar se o servidor da New Relic está conectado.

Configuração da CLI do Kiro

1. Certifique-se de ter a ferramenta Kiro CLI instalada em sua máquina.
2. Configure o servidor MCP abrindo (ou criando) o arquivo de configuração localizado em ~/.kiro/settings/mcp.json e adicione a seguinte configuração:

{
  "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
    }
  }
}

3. Autenticar e conectar:

   • Abra seu terminal e execute kiro-cli.
   • Digite o comando /mcp e pressione Enter.
   • Você verá o servidor New Relic listado com um URL. Abra esse endereço URL no seu navegador.
   • Conclua o processo padrão de login do New Relic.
   • Após a autenticação, o navegador confirmará o sucesso.

Configuração do computador Claude

O Claude Desktop requer o proxy mcp-remote para autenticação OAuth. Certifique-se de ter Node.js instalado em seu computador para que o npx funcione.

1. Crie o diretório de configuração (se necessário):

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

2. Edite o arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows).

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

   Copiar

3. Reinicie o Claude Desktop.

Configuração do VS Code

Você precisa do VS Code (versão 1.91 ou posterior).

1. Adicione o servidor MCP editando .vscode/mcp.json conforme mostrado aqui:

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

2. Crie ou abra mcp.json em seu espaço de trabalho do VS Code:

   • Se você não tiver um diretório .vscode, crie um na raiz do seu projeto.

     • Dentro de .vscode, crie um arquivo chamado mcp.json.
     • Adicione sua configuração de autenticação.

3. Iniciar servidor:

   • Certifique-se de que seu arquivo mcp.json esteja aberto no editor.
   • Procure um link clicável (CodeLens) acima da configuração do seu servidor. Clique para iniciar o servidor MCP.

Uma vez conectado, você pode interagir com New Relic AI usando comandos em linguagem natural. O servidor MCP irá gerenciar a autenticação e a recuperação de dados da sua conta New Relic.