Grafana·grafana

Grafana MCP — подключение и инструкция

Grafana MCP даёт ИИ-агенту доступ к дашбордам, источникам данных, метрикам и логам Grafana через инструменты MCP.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

Grafana MCP даёт ИИ-агенту доступ к дашбордам, источникам данных, метрикам и логам Grafana через инструменты MCP.

02

Официальный сервер поддерживает сценарии поиска и чтения дашбордов, Prometheus и Loki.

03

Найди дашборд по названию, запроси 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 своего стека.
  1. 01

    Подготовь окружение

    Grafana 9.0+ для полной функциональности, uv/uvx, URL экземпляра и service account token с нужными правами. Для Cloud используй URL своего стека.

  2. 02

    Установи и настрой

    Добавь uvx mcp-grafana в клиент. Укажи GRAFANA_URL и GRAFANA_SERVICE_ACCOUNT_TOKEN в env. Старое имя GRAFANA_API_KEY объявлено устаревшим. Выбери только нужные группы инструментов по Usage и перезапусти клиент.

  3. 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-серверов Нейролюба.

Вопросы о Grafana

Grafana MCP даёт ИИ-агенту доступ к дашбордам, источникам данных, метрикам и логам Grafana через инструменты MCP.
Вернуться в библиотеку