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 suporta os métodos de autenticação OAuth (recomendado) e por chave de API.

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:

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

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

{
  "mcpServers": {
    "newrelic": {
      "httpUrl": "https://mcp.newrelic.com/mcp/",
      "oauth": {
        "enabled": true,
        "clientId": "pUWGgnjsQ0bydqCbavTPpw==",
        "authorizationUrl": "https://login.newrelic.com/login",
        "tokenUrl": "https://mcp.newrelic.com/oauth2/token",
        "scopes": ["openid"]
      }
    }
  }
}

3. Verifique se o servidor MCP está listado:

$
claude mcp list

4. Comece Claude:

$
claude

5. Autenticar:

$
/mcp auth newrelic

Siga o fluxo do navegador OAuth.

método de chave de API

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

$
claude mcp add newrelic --transport http --env NEW_RELIC_API_KEY=NRAK-YOUR-KEY https://mcp.newrelic.com/mcp/

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

{
  "mcpServers": {
    "newrelic": {
      "url": "https://mcp.newrelic.com/mcp/",
      "transport": "http",
      "env": {
        "NEW_RELIC_API_KEY": "NRAK-YOUR-KEY-HERE"
      }
    }
  }
}

2. Verifique se o servidor MCP está listado:

$
claude mcp list

3. Comece Claude:

$
claude

Configuração do computador Claude

Claude Desktop requer o proxy mcp-remote para autenticação OAuth.

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": ["mcp-remote", "https://mcp.newrelic.com/mcp/"]
    }
  }
}

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:

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

2. Reinicie o Claude Desktop.

Configuração de windsurf

Método OAuth (via proxy remoto mcp)

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

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

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

2. Reiniciar Windsurf.

Configuração da CLI do Gemini

Método OAuth

1. Edite o arquivo de configurações: ~/.gemini/settings.json (Linux/macOS) ou %APPDATA%\Gemini\settings.json (Windows).

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "newrelic": {
      "httpUrl": "https://mcp.newrelic.com/mcp/",
      "oauth": {
        "enabled": true,
        "clientId": "pUWGgnjsQ0bydqCbavTPpw==",
        "authorizationUrl": "https://login.newrelic.com/login",
        "tokenUrl": "https://mcp.newrelic.com/oauth2/token",
        "scopes": ["openid"]
      }
    }
  }
}

2. Inicie a CLI do Gemini:

$
gemini

3. Autenticar:

$
/mcp auth newrelic

método de chave de API

1. Adicione o servidor MCP editando ~/.gemini/settings.json (Linux/macOS) ou %APPDATA%\Gemini\settings.json (Windows), conforme mostrado aqui:

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "newrelic": {
      "url": "https://mcp.newrelic.com/mcp/",
      "headers": {
        "api-key": "NRAK-YOUR-KEY-HERE"
      }
    }
  }
}

2. Inicie a CLI do Gemini:

$
gemini

3. Autenticar:

$
/mcp auth newrelic

Configuração do VS Code

O VS Code continua totalmente compatível com ambos os métodos de autenticação. Você precisa do VS Code (versão 1.60 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": {
      "url": "https://mcp.newrelic.com/mcp/",
      "headers": {
        "api-key": "NRAK-YOUR-API-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.