Grafana·grafana
Grafana MCP — подключение и инструкция
Grafana MCP даёт ИИ-агенту доступ к дашбордам, источникам данных, метрикам и логам Grafana через инструменты MCP.
Что умеет этот сервер
Grafana MCP даёт ИИ-агенту доступ к дашбордам, источникам данных, метрикам и логам Grafana через инструменты MCP.
Официальный сервер поддерживает сценарии поиска и чтения дашбордов, Prometheus и Loki.
Найди дашборд по названию, запроси summary и нужную панель вместо выгрузки всего JSON.
Задача для знакомства
Через Grafana MCP найди мой тестовый дашборд, покажи summary и запрос выбранной панели за последний час. Ничего не меняй.
Уточнить результат
Проверь dashboard UID, datasource UID, timezone и интервал времени. Если инструмент отсутствует, проверь enabled-tools; если ответ пустой — права service account и существование данных за период.
Как подключить
Выберите подходящий способПодключить Grafana MCP
Добавь uvx mcp-grafana в клиент. Укажи GRAFANA_URL и GRAFANA_SERVICE_ACCOUNT_TOKEN в env. Старое имя GRAFANA_API_KEY объявлено устаревшим. Выбери только нужные группы инструментов по Usage и перезапусти клиент.
Что понадобится
- Grafana 9.0+ для полной функциональности, uv/uvx, URL экземпляра и service account token с нужными правами. Для Cloud используй URL своего стека.
- 01
Подготовь окружение
Grafana 9.0+ для полной функциональности, uv/uvx, URL экземпляра и service account token с нужными правами. Для Cloud используй URL своего стека.
- 02
Установи и настрой
Добавь uvx mcp-grafana в клиент. Укажи GRAFANA_URL и GRAFANA_SERVICE_ACCOUNT_TOKEN в env. Старое имя GRAFANA_API_KEY объявлено устаревшим. Выбери только нужные группы инструментов по Usage и перезапусти клиент.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Пример MCP-конфигурации на основе README
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": [
"mcp-grafana"
],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}
}
}
}Первый запрос — пример для чата агента
Через Grafana MCP найди мой тестовый дашборд, покажи summary и запрос выбранной панели за последний час. Ничего не меняй.Как проверить
Проверь dashboard UID, datasource UID, timezone и интервал времени. Если инструмент отсутствует, проверь enabled-tools; если ответ пустой — права service account и существование данных за период.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Grafana
Grafana MCP даёт ИИ-агенту доступ к дашбордам, источникам данных, метрикам и логам Grafana через инструменты MCP.
Официальный сервер поддерживает сценарии поиска и чтения дашбордов, Prometheus и Loki. Отдельные группы инструментов включаются явно; например, runpanelquery и SQL не следует считать доступными в любой конфигурации.
Что подготовить перед подключением
Grafana 9.0+ для полной функциональности, uv/uvx, URL экземпляра и service account token с нужными правами. Для Cloud используй URL своего стека.
Как установить и подключить
Добавь uvx mcp-grafana в клиент. Укажи GRAFANA_URL и GRAFANA_SERVICE_ACCOUNT_TOKEN в env. Старое имя GRAFANA_API_KEY объявлено устаревшим. Выбери только нужные группы инструментов по Usage и перезапусти клиент.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Найди дашборд по названию, запроси summary и нужную панель вместо выгрузки всего JSON. Задай временной диапазон, переменные и источник. Затем сверь метрику или log-запрос с интерфейсом Grafana.
Как проверить результат и решить проблемы
Проверь dashboard UID, datasource UID, timezone и интервал времени. Если инструмент отсутствует, проверь enabled-tools; если ответ пустой — права service account и существование данных за период.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Большой JSON дашборда занимает контекст. Права на запись задаются отдельно; доступ к Grafana не гарантирует, что все источники и специальные инструменты доступны выбранной учётной записи.
Исходники и документация
Репозиторий: grafana/mcp-grafana. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.