mcp-grafana — MCP-сервер для Claude Code: дашборды и метрики
Даёт агенту доступ к вашему Grafana: искать дашборды, читать панели, гонять PromQL и LogQL. Пригодится, когда разбираете инцидент или правите графики прямо из чата.
claude mcp add --transport http mcp-grafana https://mcp.grafana.com/mcpЧто делает mcp-grafana
Сервер подключается к вашему инстансу Grafana и отдаёт агенту инструменты для работы с дашбордами: поиск по названию, папке, тегу или звёздочке, получение панелей и их запросов, список сохранённых версий. Есть get_dashboard_summary и get_dashboard_property с JSONPath — они вытаскивают только нужный кусок, потому что полный JSON большого дашборда съедает контекст. Правки тоже возможны: обновление, создание и точечный патч без загрузки всего файла.
Дальше идут запросы к данным. Prometheus отвечает на PromQL, включая instant и range, метаданные метрик и перцентили гистограмм через histogram_quantile. Loki — на LogQL, плюс метаданные и найденные паттерны логов. Список источников данных покрывает Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake и Athena. Часть инструментов выключена по умолчанию: runpanelquery, examples, influxdb и sql включаются флагом --enabled-tools. SQL-инструменты работают через плагины датасорсов, поэтому учётные данные базы MCP-сервер не видит.
Нужна Grafana 9.0 или новее — на более старых версиях операции с датасорсами ломаются из-за отсутствующих эндпоинтов API. Для локального запуска через uvx понадобится uv, а для Docker-варианта — сам Docker. В конфигурации задаются GRAFANA_URL и GRAFANA_SERVICE_ACCOUNT_TOKEN; для Grafana Cloud в GRAFANA_URL подставляется адрес инстанса.
Какие задачи решает
- найти дашборд по тегу или папке, не открывая браузер
- вытащить список панелей и их запросы из дашборда
- прогнать PromQL-запрос и посмотреть значения метрики
- разобрать паттерны в логах Loki за нужный интервал
- поправить один параметр дашборда без загрузки всего JSON
Примеры запросов агенту
- Найди дашборды с тегом
paymentsи покажи сводку по каждому - Выполни range-запрос PromQL по метрике
http_requests_totalза последний час - Покажи паттерны логов Loki для сервиса
checkout
Как установить mcp-grafana
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp-grafana https://mcp.grafana.com/mcp2Командой платформы
claude mcp add --env GRAFANA_URL=<GRAFANA_URL> --env GRAFANA_SERVICE_ACCOUNT_TOKEN=<GRAFANA_SERVICE_ACCOUNT_TOKEN> --env GRAFANA_USERNAME=<GRAFANA_USERNAME> --env GRAFANA_PASSWORD=<GRAFANA_PASSWORD> --env GRAFANA_ORG_ID=<GRAFANA_ORG_ID> --transport stdio mcp-grafana -- docker run -i --rm -e GRAFANA_URL -e GRAFANA_SERVICE_ACCOUNT_TOKEN -e GRAFANA_USERNAME -e GRAFANA_PASSWORD -e GRAFANA_ORG_ID docker.io/grafana/mcp-grafana:2.1.1Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add mcp-grafana --url https://mcp.grafana.com/mcp2Командой платформы
codex mcp add mcp-grafana --env GRAFANA_URL=<GRAFANA_URL> --env GRAFANA_SERVICE_ACCOUNT_TOKEN=<GRAFANA_SERVICE_ACCOUNT_TOKEN> --env GRAFANA_USERNAME=<GRAFANA_USERNAME> --env GRAFANA_PASSWORD=<GRAFANA_PASSWORD> --env GRAFANA_ORG_ID=<GRAFANA_ORG_ID> -- docker run -i --rm -e GRAFANA_URL -e GRAFANA_SERVICE_ACCOUNT_TOKEN -e GRAFANA_USERNAME -e GRAFANA_PASSWORD -e GRAFANA_ORG_ID docker.io/grafana/mcp-grafana:2.1.1Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp-grafana": {
"url": "https://mcp.grafana.com/mcp"
}
}
}{
"mcpServers": {
"mcp-grafana": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GRAFANA_URL",
"-e",
"GRAFANA_SERVICE_ACCOUNT_TOKEN",
"-e",
"GRAFANA_USERNAME",
"-e",
"GRAFANA_PASSWORD",
"-e",
"GRAFANA_ORG_ID",
"docker.io/grafana/mcp-grafana:2.1.1"
],
"env": {
"GRAFANA_URL": "<GRAFANA_URL>",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<GRAFANA_SERVICE_ACCOUNT_TOKEN>",
"GRAFANA_USERNAME": "<GRAFANA_USERNAME>",
"GRAFANA_PASSWORD": "<GRAFANA_PASSWORD>",
"GRAFANA_ORG_ID": "<GRAFANA_ORG_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"mcp-grafana": {
"type": "http",
"url": "https://mcp.grafana.com/mcp"
}
}
}{
"servers": {
"mcp-grafana": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GRAFANA_URL",
"-e",
"GRAFANA_SERVICE_ACCOUNT_TOKEN",
"-e",
"GRAFANA_USERNAME",
"-e",
"GRAFANA_PASSWORD",
"-e",
"GRAFANA_ORG_ID",
"docker.io/grafana/mcp-grafana:2.1.1"
],
"env": {
"GRAFANA_URL": "<GRAFANA_URL>",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<GRAFANA_SERVICE_ACCOUNT_TOKEN>",
"GRAFANA_USERNAME": "<GRAFANA_USERNAME>",
"GRAFANA_PASSWORD": "<GRAFANA_PASSWORD>",
"GRAFANA_ORG_ID": "<GRAFANA_ORG_ID>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp-grafana https://mcp.grafana.com/mcp2Командой платформы
gemini mcp add -e GRAFANA_URL=<GRAFANA_URL> -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<GRAFANA_SERVICE_ACCOUNT_TOKEN> -e GRAFANA_USERNAME=<GRAFANA_USERNAME> -e GRAFANA_PASSWORD=<GRAFANA_PASSWORD> -e GRAFANA_ORG_ID=<GRAFANA_ORG_ID> mcp-grafana docker run -i --rm -e GRAFANA_URL -e GRAFANA_SERVICE_ACCOUNT_TOKEN -e GRAFANA_USERNAME -e GRAFANA_PASSWORD -e GRAFANA_ORG_ID docker.io/grafana/mcp-grafana:2.1.1Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «DevOps и инфраструктура»
Всё по теме «DevOps и инфраструктура» →Вопросы о mcp-grafana
Как установить mcp-grafana в Claude Code?
Удалённый вариант одной командой: claude mcp add --transport http mcp-grafana https://mcp.grafana.com/mcp. Либо локально через Docker: `claude mcp add --env GRAFANA_URL=<GRAFANA_URL> --env GRAFANA_SERVICE_ACCOUNT_TOKEN=<GRAFANA_SERVICE_ACCOUNT_TOKEN> --env GRAFANA_USERNAME=<GRAFANA_USERNAME> --env GRAFANA_PASSWORD=<GRAFANA_PASSWORD> --env GRAFANA_ORG_ID=<GRAFANA_ORG_ID> --transport stdio mcp-grafana -- docker run -i --rm -e GRAFANA_URL -e GRAFANA_SERVICE_ACCOUNT_TOKEN -e GRAFANA_USERNAME -e GRAFANA_PASSWORD -e GRAFANA_ORG_ID docker.io/grafana/mcp-grafana:2.1.1`.
Что делает mcp-grafana?
Открывает агенту доступ к инстансу Grafana: поиск и чтение дашбордов, запросы к Prometheus и Loki, работа с датасорсами и SQL-источниками. Часть инструментов включается отдельно флагом --enabled-tools.
Какая версия Grafana нужна?
Grafana 9.0 или новее. На более старых версиях операции с датасорсами могут не работать из-за отсутствующих эндпоинтов API.
