Configurar o New Relic MCP

Este guia orienta você na configuração do servidor Model Context Protocol (MCP) da New Relic com suas ferramentas de desenvolvimento de IA preferidas. Selecione 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.

Ferramentas de filtragem com tag include

As ferramentas New Relic MCP são organizadas e categorizadas usando tags internas (como alerting, discovery e data-access).

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": {
            "api-key": "NRAK-****",
            "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 aos métodos de autenticação OAuth (recomendado) e chave de API. O OAuth requer a versão 2.1.186 do Claude Code ou posterior. Caso utilize versões mais antigas, a autenticação deve ser feita via /mcp no Claude em vez de claude mcp login.

Método OAuth (recomendado)

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.

método de chave de API

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

   bash

   Copiar

   $
   claude mcp add --transport http newrelic https://mcp.newrelic.com/mcp/ --header "api-key: NRAK-YOUR-KEY-HERE"

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

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

   Copiar

2. Verifique se o servidor MCP está listado:

   bash

   Copiar

   $
   claude mcp list

3. Comece Claude:

   bash

   Copiar

   $
   claude

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 da CLI Antigravity

método de chave de API

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

Método OAuth (recomendado)

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.

método de chave de API

1. Certifique-se de ter a ferramenta Kiro CLI instalada em sua máquina.

2. Configure o servidor MCP abrindo (ou criando) ~/.kiro/settings/mcp.json e adicione a seguinte configuração:

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

   Copiar

3. Abra seu terminal e execute kiro-cli. O servidor MCP da New Relic se conectará automaticamente.

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.

Método OAuth (recomendado)

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.

método de chave de API

1. Adicione o servidor MCP editando ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows), conforme mostrado aqui:

   • Para macOS:

     {
       "mcpServers": {
         "newrelic": {
           "command": "npx",
           "args": [
             "-y",
             "mcp-remote",
             "https://mcp.newrelic.com/mcp/",
             "--transport",
             "http",
             "--header",
             "api-key: NRAK-xxxx"
           ]
         }
       }
     }

     Copiar

   • Para Windows:

     {
       "mcpServers": {
         "newrelic": {
           "command": "C:\\PROGRA~1\\nodejs\\npx.cmd",
           "args": [
             "-y",
             "mcp-remote",
             "https://mcp.newrelic.com/mcp/",
             "--transport",
             "http",
             "--header",
             "api-key: NRAK-xxxx"
           ]
         }
       }
     }

     Copiar

2. Reinicie o Claude Desktop. No Windows, as alterações podem não ter efeito até que o aplicativo Claude seja fechado via Gerenciador de Tarefas.

Configuração de windsurf

Método OAuth

1. Edite o arquivo de configuração, ~/.codeium/windsurf/mcp_config.json, conforme mostrado aqui:

   {
     "mcpServers": {
       "new-relic": {
         "serverUrl": "https://mcp.newrelic.com/mcp/"
       }
     }
   }

   Copiar

2. Reiniciar Windsurf.

3. Verifique os servidores MCP usando o ícone de martelo no painel Cascade.

método de chave de API

1. Adicione o servidor MCP editando ~/.codeium/windsurf/mcp_config.json conforme mostrado aqui:

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

   Copiar

2. Reiniciar Windsurf.

Configuração do VS Code

O VS Code continua sendo totalmente compatível com ambos os métodos de autenticação. É necessário o VS Code (versão 1.91 ou posterior).

Método OAuth

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

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

método de chave de API

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

{
  "servers": {
    "new-relic-mcp": {
      "type": "http",
      "url": "https://mcp.newrelic.com/mcp/",
      "headers": {
        "api-key": "NRAK-YOUR-KEY-HERE"
      }
    }
  }
}

Etapas de configuração

1. 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 usando um dos métodos acima.

2. 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.