뉴렐릭 MCP 설정

이 가이드는 선호하는 지원되는 MCP 클라이언트를 사용하여 뉴렐릭의 Model Context Protocol(MCP) 서버를 설정하는 과정을 안내합니다. 플랫폼별 지침을 보려면 아래에서 환경을 선택하십시오.

중요

이 페이지에 나열된 도구를 포함하되 이에 국한되지 않는 모든 AI 도구를 뉴렐릭 AI MCP 서버와 함께 사용하는 것은 AI가 사용자를 대신하여 뉴렐릭 계정에서 작업을 수행함을 의미합니다. 여기에 설명된 방법 중 하나를 사용할 때는 사용 사례, 요구 사항 및 내부 정책에 적합한 최소 권한과 원하는 역할 기반 액세스 제어(RBAC)를 갖춘 적절한 뉴렐릭 계정을 생성하여 사용하십시오.

뉴렐릭 MCP 설정을 시작하기 전에 인증 설정을 포함한 필수 구성 요소를 완료했는지 확인하세요. 그런 다음, 귀하의 특정 개발 환경에 맞는 지침을 따르세요.

include-tags를 사용한 도구 필터링

뉴렐릭 MCP 도구는 내부 태그(alerting, discovery 및 data-access 등)를 사용하여 구성 및 분류됩니다. 자세한 내용은 필터 도구를 참조하십시오.

다음과 같이 requests 과 함께 include-tags HTTP 헤더를 보내면 AI가 액세스하는 도구를 동적으로 필터링할 수 있습니다.

중요

리전 알림: 이 주제의 설정 예에서는 미국 리전(기본값) MCP 연결 URL인 https://mcp.newrelic.com/mcp/를 사용합니다. 뉴렐릭 계정이 다른 리전에 있는 경우, 모든 설정 파일 및 명령줄 인수에서 이 URL을 적절한 리전 엔드포인트로 교체하십시오:

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

사용 가능한 태그와 각 태그와 관련된 도구의 전체 목록은 뉴렐릭 MCP 도구 참조 문서를 참조하세요.

중요

이 문서에 명시적으로 달리 표시되지 않는 한, 지원되는 MCP 클라이언트는 OAuth 방식으로만 설정해야 합니다. 달리 표시되지 않는 한, API 키를 사용한 설정은 이 문서에 설명된 대로 또는 의도한 대로 작동하지 않습니다.

클로드 코드 설정

Claude Code는 OAuth 인증 방식을 지원합니다. OAuth를 사용하려면 Claude Code 버전 2.1.186 이상이 필요합니다. 이전 버전을 사용 중이라면 'claude MCP login' 대신 Claude 내의 /mcp를 통해 인증해야 합니다.

Claude Code가 설치되고 구성되어 있는지 확인하세요.
명령줄을 사용하여 MCP 서버를 추가합니다.
bash
```
$claude mcp add --transport http 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 setup

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

Ensure you have Codex installed and configured.
명령줄을 사용하여 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"
      }
    }
  }
}
```
Antigravity CLI 시작:
bash
```
$agy
```
/mcp을(를) 실행하여 뉴렐릭 서버가 연결되었는지 확인하십시오.

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

인증 및 연결:
- 터미널을 열고 kiro-cli 실행하세요.
- 명령어 /mcp 입력하고 엔터를 누르세요.
- URL과 함께 뉴렐릭 서버가 목록에 표시되는 것을 볼 수 있습니다. 해당 URL을 브라우저에서 여세요.
- 뉴렐릭의 표준 로그인 절차를 완료하세요.
- 인증이 완료되면 브라우저에서 성공을 확인하는 메시지가 표시됩니다.

클로드 데스크탑 설정

Claude Desktop은 OAuth 인증을 위해 mcp-remote 프록시가 필요합니다. npx가 작동하려면 컴퓨터에 Node.js 설치되어 있는지 확인하십시오.

(필요한 경우) 구성 디렉토리를 만듭니다.

bash

$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 코드 설정

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 서버가 시작됩니다.

연결되면 자연어를 사용하여 뉴렐릭 AI와 상호작용할 수 있습니다. MCP 서버는 귀하의 뉴렐릭 계정에서 인증 및 데이터 검색을 관리합니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.

중요

include-tags를 사용한 도구 필터링 .css-21sua1{background:none;border:none;width:0;padding:0;}

중요

중요