Claude Desktop

Claude Desktop

이 문서에서는 Claude Desktop용으로 mcp-grafana 서버를 설정하는 방법을 알아봐요. 설치 방법과 구성 파일 편집 방법을 단계별로 안내해요.

출처: 문서

본문

사전 요구 사항 (Prerequisites)

• mcp-grafana

설치 (Installation)

옵션 1: 데스크톱 확장 (.mcpb)

GitHub Releases에서 mcp-grafana_<version>.mcpb를 다운로드해 Claude Desktop으로 열어요. 이 번들에는 지원되는 모든 플랫폼용 서버 바이너리가 포함되어 있으며, Claude Desktop이 Grafana URL과 자격 증명을 입력하도록 안내하므로 구성 파일을 편집할 필요가 없어요. 이 방식으로 설치하면 이 페이지의 나머지는 건너뛰어도 돼요.

번들은 코드 서명되지 않았으며, Claude Desktop의 확장 디렉터리에 나열된 복사본이 최신 릴리스보다 뒤처질 수 있어요.

옵션 2: Go 설치

GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest

옵션 3: 바이너리 다운로드

GitHub Releases에서 최신 릴리스를 받아 PATH에 추가해요.

옵션 4: Docker

설치가 필요 없어요. 아래 구성에서 Docker를 사용하면 돼요.

구성 (Configuration)

Claude Desktop 구성 파일을 편집해요:

바이너리 구성 (Binary configuration)

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

ENOENT 오류가 나면 전체 경로를 사용해요:

{
  "mcpServers": {
    "grafana": {
      "command": "/Users/yourname/go/bin/mcp-grafana",
      "args": [],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

Docker 구성 (Docker configuration)

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

디버그 모드 (Debug mode)

자세한 로깅을 위해 args에 -debug를 추가해요:

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

구성 확인 (Verify configuration)

동작한다면 대시보드 이름이 보여요. 그렇지 않으면 macOS에서 ~/Library/Logs/Claude/mcp*.log 로그를 확인해요.

읽기 전용 모드 (Read-only mode)

실수로 인한 수정을 방지하려면:

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

TLS 클라이언트 인증서 (TLS client certificates)

mTLS를 요구하는 Grafana 인스턴스의 경우:

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": [
        "--tls-cert-file",
        "/path/to/client.crt",
        "--tls-key-file",
        "/path/to/client.key",
        "--tls-ca-file",
        "/path/to/ca.crt"
      ],
      "env": {
        "GRAFANA_URL": "https://secure-grafana.example.com",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

다음 단계 (Next steps)

• 설정
• 인증 구성

더 알아보기 (Learn more)

• 원문 문서