grafana-mcp — плагин для Claude Code: Grafana и установка
Плагин подключает Claude Code к Grafana через MCP: агент сможет искать дашборды, выполнять запросы и работать с алертами и инцидентами. Нужен для взаимодействия с работающим экземпляром Grafana.
/plugin install grafana-mcp@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialЧто делает grafana-mcp
Плагин подключает официальный MCP-сервер Grafana. Через него Claude Code может искать и просматривать дашборды, получать сведения об источниках данных, выполнять запросы PromQL и LogQL, а также управлять правилами алертинга и инцидентами. Доступны и инструменты для аннотаций, OnCall и ссылок на панели.
Для запуска нужны установленный и работающий Docker и токен сервисного аккаунта Grafana с ролью Viewer как минимум; для операций записи нужна роль Editor. При включении Claude Code запросит URL Grafana и токен, который хранится в системном хранилище ключей. Это плагин для самостоятельно размещённой Grafana или настройки с токеном; для Grafana Cloud в README рекомендуют отдельный плагин или коннектор. MCP добавляет в контекст более 40 инструментов, поэтому включайте его, когда нужно обращаться к работающей Grafana.
Какие задачи решает
- найти дашборд и получить его сводку
- выполнить запрос PromQL или LogQL
- просмотреть источники данных Grafana
- создать или изменить правило алертинга
- найти инцидент и добавить к нему запись
Примеры запросов агенту
- Найди дашборд для сервиса оплаты и покажи его сводку.
- Выполни запрос PromQL для метрики ошибок и объясни результат.
- Найди открытый инцидент и добавь к нему запись о проверке.
Как установить grafana-mcp
Через маркетплейс плагинов
/plugin install grafana-mcp@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о grafana-mcp
Как установить grafana-mcp в Claude Code?
Выполните команды по порядку: /plugin marketplace add anthropics/claude-plugins-official, затем /plugin install grafana-mcp@claude-plugins-official.
Что делает grafana-mcp?
Подключает Claude Code к Grafana через MCP. Агент может работать с дашбордами, запросами PromQL и LogQL, алертами и инцидентами.
Что нужно для работы grafana-mcp?
Нужны работающий Docker и токен сервисного аккаунта Grafana с ролью Viewer или выше. Для операций записи требуется роль Editor.
Исходный текст
grafana-mcp · Apache-2.0
# Grafana MCP Cursor plugin that exposes the official [Grafana MCP server](https://github.com/grafana/mcp-grafana) for AI-assisted observability workflows. **Using Grafana Cloud?** Use the [grafana-cloud-mcp](../grafana-cloud-mcp/) plugin or the Grafana Cloud connector instead — no Docker or service-account token needed. This plugin is for self-hosted Grafana or token-based setups. **Note:** This plugin adds 40+ MCP tools to your context window. Only enable it when you need to interact with a live Grafana instance. For skills and rules around Grafana Assistant development, install the **grafana-assistant** plugin instead. ## Prerequisites 1. [Docker](https://docs.docker.com/get-docker/) must be installed and running. 2. Create a [service account](https://grafana.com/docs/grafana/latest/administration/service-accounts/) in Grafana with at least **Viewer** role (or **Editor** for write operations). Generate a token. ## Setup ### Claude Code When you enable the plugin, Claude Code prompts you for: - **Grafana instance URL** — e.g. `http://localhost:3000` for local, or `https://<stack>.grafana.net` for Grafana Cloud - **Service account token** — stored in your system keychain No shell environment variables required. ### Cursor Export the environment variables before launching Cursor: ```bash export GRAFANA_URL="http://localhost:3000" export GRAFANA_SERVICE_ACCOUNT_TOKEN="<your token>" ``` For Grafana Cloud, use your instance URL instead (e.g. `https://myinstance.grafana.net`). ## Available tools The MCP server provides 40+ tools across these categories: | Category | Examples | |---|---| | Dashboards | search, get summary, get property, patch | | Datasources | list, get by UID or name | | Prometheus | PromQL queries, metric metadata, label names/values | | Loki | LogQL log/metric queries, label metadata, patterns | | Alerting | list/create/update/delete alert rules, contact points | | Incidents | search, create, add activity | | OnCall | schedules, shifts, on-call users, alert groups | | Navigation | generate deeplinks to dashboards, panels, Explore | | Annotations | get, create, update, patch, list tags | See the [mcp-grafana README](https://github.com/grafana/mcp-grafana) for the full tool reference and RBAC requirements.
© Grafana · Apache-2.0 · grafana/ai-marketplace
