Grafana MCP 서버 소개

이 문서는 오픈소스 Grafana MCP 서버를 설치하고 실행하는 방법, MCP 호환 클라이언트를 연결하는 방법, 그리고 인증·전송(transport)·도구(tool)를 설정하는 방법을 알려드려요. Grafana MCP 서버는 Model Context Protocol(MCP) 서버로, AI 어시스턴트와 LLM 클라이언트가 Grafana 인스턴스에 접근할 수 있게 해 줍니다.

이를 통해 메트릭과 로그를 조회하고, 대시보드를 검색·관리하며, 알림 규칙을 관리하고, Grafana Incident 및 Sift와도 연동할 수 있어요. Grafana 리소스로 연결되는 딥링크(deeplink)까지 만들 수 있습니다.

출처: 문서

본문

올바른 Grafana MCP 옵션 선택하기

Grafana에는 두 가지 MCP 서버 옵션이 있어요.

옵션	가장 적합한 경우	인증
오픈소스 Grafana MCP 서버	Grafana Cloud 또는 자체 관리형(self-managed) Grafana를 위해 MCP 서버를 직접 실행·관리하고 싶을 때	서비스 계정 토큰(Service account token)
Grafana Cloud MCP 서버	로컬 서버를 설치하지 않고 외부 AI 에이전트를 Grafana Cloud에 연결할 때	로그인한 Grafana 사용자 범위의 OAuth 2.1 브라우저 인증

이 문서는 오픈소스 서버용 문서예요. Grafana Cloud 호스팅 MCP 서버는 Grafana Cloud MCP server 문서를 참고하세요.

개요 (Overview)

Grafana MCP 서버를 사용하면 선호하는 MCP 호환 클라이언트(예: Claude Desktop, Cursor, VS Code with Copilot)가 Grafana와 대화할 수 있어요. 이 서버는 대시보드, 데이터소스(Prometheus, Loki 등), 알림(alerting), 인시던트(incident), OnCall 등을 위한 도구를 제공합니다. 어떤 도구를 활성화할지, 그리고 서버가 Grafana에 어떻게 연결할지(인증과 전송)를 설정할 수 있어요.

빠른 시작 (Quick start)

이 빠른 시작은 uv가 필요해요. 아래 내용을 MCP 클라이언트 설정(예: Claude Desktop이나 Cursor)에 추가하세요.

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": ["mcp-grafana"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      }
    }
  }
}

이 오픈소스 서버를 Grafana Cloud와 함께 사용한다면 GRAFANA_URL을 인스턴스 URL(예: https://myinstance.grafana.net)로 설정하세요. 다음 단계는 Clients와 Set up 문서를 참고하세요.

전체 기능을 사용하려면 Grafana 9.0 이상이 필요해요. 일부 기능, 특히 데이터소스 관련 작업은 API 엔드포인트가 없어 이전 버전에서는 제대로 동작하지 않을 수 있습니다.

문서 살펴보기 (Explore the docs)

Clients – Cursor, Claude Desktop, VS Code 등
Set up – uvx, Docker, binary, Helm 및 클라이언트 설정 예시
Configure – 인증, 커맨드라인 플래그, 전송, TLS, 도구
Introduction – MCP 개념 및 RBAC 개요
Reference – MCP 도구 레퍼런스 (도구, 권한, 범위, RBAC 가이드)
Guides – 메트릭과 로그 조회, 대시보드, 알림, 딥링크, 인시던트
Troubleshooting – Grafana 버전 호환성 등 일반적인 문제
Developer – Go SDK, 관측성, 빌드와 테스트

라이선스 (License)

이 프로젝트는 Apache License, Version 2.0으로 라이선스됩니다.

더 알아보기 (Learn more)

원문 문서