Grafana MCP: 먼저 데이터소스를 나열하고, 처음부터 큰 대시보드 전체를 가져오지 말 것

누구에게 맞나

이미 Grafana 9.0 이상 인스턴스가 있고, 모델이 인스턴스와 주변 생태계(대시보드, 데이터소스)를 보게 하려는 사람에게 맞다. 근거는 이렇게 적혀 있다: 이 MCP는 Grafana 인스턴스와 주변 생태계에 대한 접근을 제공한다.

GRAFANA_URL과 서비스 계정 토큰 GRAFANA_SERVICE_ACCOUNT_TOKEN을 제공할 수 있어야 한다. 9.0 미만에서는 일부 기능(특히 데이터소스 관련)이 API 부재로 동작하지 않을 수 있다.

근거는 클라이언트 목록을 적지 않았고 대부분의 도구 함수 이름도 쓰지 않았다. 처음에는 읽기 전용 조회만 하고, 기본이 꺼진 panel query를 켜지 말며, localhost:3000 예제를 프로덕션에 그대로 쓰지 마라.

3분 만에 첫 시도

uvx 주 경로를 쓴다. 클라이언트에서 설정:

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

URL을 자신의 인스턴스로, 토큰을 서비스 계정 token으로 바꾼다. 대화에 쓰지 마라.

전제: Grafana ≥ 9.0에 도달할 수 있다. 서비스 계정에 데이터소스 나열 또는 대시보드 읽기 권한이 있다. 이번 호출은 토큰을 가지고 자신의 Grafana에 가며 오프라인 샌드박스가 아니다.

설정 위치: 클라이언트 MCP의 command / args / env.

낮은 위험의 첫 호출: 먼저 「데이터소스 정보를 나열하고 가져오기」(근거 능력). UID로 큰 대시보드 전체를 먼저 가져오지 마라. Run panel query 도구는 기본 꺼짐이다. 첫 시도를 위해 runpanelquery를 --enabled-tools에 넣지 마라.

성공 신호: 클라이언트가 연결된 뒤 구성된 데이터소스 목록을 볼 수 있다. 401이거나 연결되지 않으면 먼저 URL과 토큰, 인스턴스가 ≥ 9.0인지 확인하라.

사용 사례

사례 1: 인스턴스에 어떤 데이터소스가 있는지 본다. 「List and fetch datasource information」을 쓴다. 근거는 지원 유형에 Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena가 포함된다고 적는다. 도구 함수 이름이나 필터 파라미터는 없다. 따라서 확인할 수 있는 것은 구성된 데이터소스와 그 상세까지다.

사례 2: UID로 대시보드 하나의 전체 상세를 가져온다. 근거는 경고한다: 큰 대시보드는 컨텍스트 창을 많이 쓴다. UID를 알고 크지 않은 판을 고른다. 반환이 너무 길면 「근거가 이미 컨텍스트 사용을 경고했다」에서 멈추고 전체를 반복해서 가져오지 마라. 근거는 JSONPath로 줄이는 도구의 locator 원문을 쓰지 않았다. 대체 도구 이름을 지어내지 마라.

사용 경계

Grafana 9.0+, GRAFANA_URL, 서비스 계정 토큰이 필요하다. runpanelquery는 기본 비활성이며 켠 뒤에만 panel query를 실행한다. UID로 판 전체를 가져오면 컨텍스트가 터질 수 있다. 데이터소스 유형은 위에 나열된 것만이다. 근거에 undo, 전체 도구 이름표, 토큰 최소 권한은 없다. Grafana와 데이터소스 접근은 제로 리스크가 아니다. 서비스 계정이 보는 대시보드와 데이터소스를 모델도 본다. 「읽기 전용으로 데이터소스 나열」을 네트워크 없음이나 민감한 지표 이름 없음으로 읽지 마라.