Cursor

Cursor

이 가이드는 Cursor에서 mcp-grafana 서버를 설정하는 방법을 알려드려요.

출처: 문서

본문

사전 준비 (Prerequisites)

• Cursor IDE 설치
• 서비스 계정 토큰이 있는 Grafana 9.0 이상
• $PATH에 있는 mcp-grafana 바이너리

설정 (Configuration)

설정 위치에는 두 가지 옵션이 있어요.

UI로 추가하기

1. Cursor Settings → Tools & Integrations을 여세요.
2. New MCP Server를 클릭하세요.
3. 그러면 ~/.cursor/mcp.json이 편집을 위해 열립니다.

수동 설정

~/.cursor/mcp.json을 만들거나 편집하세요:

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

Docker 설정

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

디버그 모드

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

설정 확인하기

1. Cursor Settings → Tools & Integrations로 이동하세요.
2. MCP 서버 목록에서 grafana를 찾으세요.
3. 필요하다면 새로고침(refresh) 버튼을 클릭하세요.
4. 초록색 표시 = 서버가 실행 중이라는 뜻입니다.
5. Composer를 열고 "List my Grafana dashboards"라고 물어보세요.

문제 해결 (Troubleshooting)

• 서버가 나타나지 않을 때: JSON 문법을 확인하세요(끝의 쉼표가 오류를 일으킵니다). Cursor를 재시작하세요.
• 바이너리 경로 확인: which mcp-grafana로 확인하세요.
• 도구가 작동하지 않을 때: MCP 설정에서 새로고침 버튼을 클릭하세요. Grafana 토큰 권한을 확인하세요. -debug 플래그를 켜고 출력을 확인하세요.

읽기 전용 모드

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

다음 단계

• uvx, Helm 등 다른 설치 옵션
• Grafana 자격 증명을 위한 인증 설정하기

더 알아보기 (Learn more)

• 원문 문서