Grafana MCP 서버 소개
Grafana MCP 서버 소개 (Introduction to the Grafana MCP server)
이 문서에서는 오픈 소스 Grafana MCP 서버가 무엇인지, 무엇을 할 수 있는지, 그리고 인증과 권한이 어떻게 동작하는지 소개해요. Grafana Cloud의 호스팅 MCP 서버에 대해서는 Grafana Cloud MCP 서버 문서를 참고하세요.
출처: 문서
본문
달성할 목표 (What you'll achieve)
이 서버가 Model Context Protocol 생태계에 어떻게 들어맞는지, 어떤 종류의 도구(메트릭, 로그, 트레이스, 대시보드, 알림 등)를 노출하는지, 그리고 Grafana RBAC가 어떻게 적용되는지 이해하게 돼요.
시작하기 전에 (Before you begin)
Grafana 인스턴스(Grafana 9.0 이상)와 MCP 호환 클라이언트(예: Claude Desktop, Cursor, 또는 Copilot이 포함된 VS Code)가 필요해요.
Model Context Protocol (MCP)
Model Context Protocol(MCP)은 AI 어시스턴트와 LLM 클라이언트가 외부 시스템에 연결하기 위한 표준 방식이에요. Grafana MCP 서버는 MCP를 구현해서, 커스텀 통합을 직접 작성하지 않아도 클라이언트가 Grafana와 통신할 수 있게 해줘요. 이 서버는 메트릭과 로그 쿼리, 대시보드 검색, 알림 규칙 관리, 인시던트와 OnCall 작업, 딥링크 생성 같은 Grafana의 액션에 매핑되는 도구들을 노출해요. Grafana와 관련된 질문이나 지시를 하면 AI 어시스턴트가 여러분을 대신해 이런 도구들을 호출해요.
도구와 기능 (Tools and capabilities)
이 서버는 영역별로 그룹화된 많은 도구를 노출해요: 대시보드(검색, 요약 가져오기, 패널 쿼리 가져오기, 업데이트, 패치), 폴더(검색, 생성), 데이터소스(Prometheus, Loki, InfluxDB, ClickHouse, Snowflake, CloudWatch, Google Cloud Logging, Elasticsearch, Pyroscope 목록 및 쿼리), Tempo(트레이스 검색, 메트릭, 트레이스 diff, 속성 탐색), 알림(규칙과 라우팅), 인시던트(Grafana Incident), Sift(조사, 오류 패턴, 느린 요청), OnCall(일정, 알림 그룹), 내비게이션(딥링크), 주석, 스냅샷(목록, 가져오기, 생성, 삭제), 렌더링(패널 또는 대시보드 이미지), 그리고 사용자 정보(현재 신원과 접근 가능한 조직). 일부 도구 범주는 컨텍스트 창을 아끼기 위해 기본적으로 비활성화되어 있어요. 도구 활성화 및 비활성화 문서에서 활성화할 수 있어요. 대시보드의 경우 전체 JSON이 필요하지 않을 때는 컨텍스트 창 사용을 관리하기 위해 get_dashboard_by_uid보다 get_dashboard_summary와 get_dashboard_property를 선호해요.
인증과 RBAC (Authentication and RBAC)
서버는 Grafana API를 호출하기 위해 Grafana 서비스 계정 토큰(또는 사용자 이름과 비밀번호)을 사용해요. 각 도구는 올바른 Grafana RBAC 권한과 스코프를 요구해요. 예를 들어 대시보드를 읽으려면 dashboards:read와 dashboards:* 또는 dashboards:uid:xyz 같은 스코프가 필요해요. 대시보드를 만들거나 업데이트하려면 dashboards:create와 dashboards:write, 그리고 적절한 폴더 스코프가 필요해요. 서비스 계정에 기본 제공 Editor 역할을 할당해 광범위한 접근 권한을 줄 수도 있고, 최소 권한(least-privilege)을 위해 세분화된 권한을 사용할 수도 있어요. Grafana Incident와 Sift는 기본 역할(Viewer는 읽기, Editor는 쓰기)을 사용해요. RBAC에 대한 자세한 내용은 Grafana RBAC 문서를 참고하세요.
다음 단계 (Next steps)
- 클라이언트 설정 Configure
- MCP 도구 참조
- 클라이언트 구성 예시
- 가이드