Claude Code

Claude Code

이 가이드는 Claude Code CLI용 mcp-grafana 서버를 설정하는 방법을 안내해요.

출처: 문서

본문

전제 조건

  • Claude Code CLI 설치(npm install -g @anthropic-ai/claude-code)
  • 서비스 계정 토큰이 있는 Grafana 9.0+
  • PATH에 있는 mcp-grafana 바이너리

원커맨드 설정

claude mcp add-json "grafana" '{"command":"mcp-grafana","args":[],"env":{"GRAFANA_URL":"http://localhost:3000","GRAFANA_SERVICE_ACCOUNT_TOKEN":"<your-token>"}}'

수동 구성

Claude Code는 MCP 구성을 다른 설정과 함께 저장해요. CLI로 서버를 관리해요.

# 구성된 서버 나열
claude mcp list

# 서버 추가
claude mcp add grafana -- mcp-grafana

# 서버 제거
claude mcp remove grafana

범위 옵션

Claude Code는 MCP 서버에 세 가지 범위를 지원해요:

범위 설명
local (기본값) 현재 프로젝트에서만 사용자에게 제공
project .mcp.json 파일로 팀과 공유
user 모든 프로젝트에서 사용자에게 제공 
# 모든 프로젝트에 추가
claude mcp add grafana --scope user -- mcp-grafana

# 현재 프로젝트에만 추가 (기본값)
claude mcp add grafana --scope local -- mcp-grafana

환경 변수가 포함된 전체 구성

claude mcp add-json "grafana" '{
  "command": "mcp-grafana",
  "args": [],
  "env": {
    "GRAFANA_URL": "http://localhost:3000",
    "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
  }
}'

Docker 설정

claude mcp add-json "grafana" '{
  "command": "docker",
  "args": ["run", "--rm", "-i", "-e", "GRAFANA_URL", "-e", "GRAFANA_SERVICE_ACCOUNT_TOKEN", "grafana/mcp-grafana", "-t", "stdio"],
  "env": {
    "GRAFANA_URL": "http://host.docker.internal:3000",
    "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
  }
}'

디버그 모드

claude mcp add-json "grafana" '{
  "command": "mcp-grafana",
  "args": ["-debug"],
  "env": {
    "GRAFANA_URL": "http://localhost:3000",
    "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
  }
}'

그런 다음 디버그 출력으로 Claude Code를 실행해요:

claude --debug

구성 검증

  1. 새 Claude Code 세션을 시작해요:
claude
  1. "내 Grafana 대시보드를 나열해 줘"라고 물어봐요.
  2. Claude가 Grafana MCP 도구를 자동으로 사용해야 해요.

현재 구성 보기

claude mcp list --json

문제 해결

서버를 찾을 수 없음:

  • 바이너리 경로 확인: which mcp-grafana
  • 필요하면 구성에 전체 경로를 사용해요.

권한 오류:

  • Grafana 서비스 계정 토큰을 확인해요.
  • 토큰에 필요한 RBAC 권한이 있는지 확인해요.

읽기 전용 모드

claude mcp add-json "grafana" '{
  "command": "mcp-grafana",
  "args": ["--disable-write"],
  "env": {
    "GRAFANA_URL": "http://localhost:3000",
    "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
  }
}'

다음 단계