Как подключить Grafana к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Grafana, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Grafana + Gemini

Дайте ИИ читать вашу Grafana: искать дашборды и смотреть их панели и запросы, выполнять запросы к источникам данных Prometheus, Loki и SQL, видеть, какие алерты срабатывают и как определены правила, читать и добавлять аннотации, а также выводить точки контакта, пользователей и команды. Работает с Grafana Cloud и с Grafana на собственном сервере.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN

Шаг 1 — Получите учётные данные

1. Укажите в GRAFANA_URL адрес, по которому вы открываете Grafana, без косой черты в конце: https://your-stack.grafana.net в Grafana Cloud или ваш собственный адрес, например https://grafana.example.com (или https://example.com/grafana, если Grafana работает по подпути). В AnythingMCP Cloud экземпляр должен быть доступен из интернета.
2. В Grafana откройте Administration → Users and access → Service accounts, нажмите Add service account, задайте имя (например, AnythingMCP) и роль Viewer.
3. Откройте сервисный аккаунт, нажмите Add service account token, выберите срок действия и скопируйте токен. Он начинается с glsa_, и Grafana показывает его только один раз.
4. Вставьте его в GRAFANA_SERVICE_ACCOUNT_TOKEN без слова Bearer и установите коннектор. Токен даёт доступ только к той организации, к которой относится сервисный аккаунт.
5. Проверьте настройку с помощью grafana_get_current_org: он показывает организацию, стоящую за токеном. grafana_get_health отвечает даже без токена, поэтому он показывает версию Grafana, но не доказывает, что токен работает.

Какая роль нужна: роли Viewer достаточно для дашбордов, папок, источников данных, запросов, правил алертов, сработавших алертов, аннотаций и точек контакта. Для вывода пользователей и команд нужна роль Admin, для добавления аннотаций роль Editor. В Grafana Cloud и Grafana Enterprise сервисному аккаунту также нужно право на запросы к каждому источнику данных, который он должен читать.

Что он делает: ищет дашборды и папки и читает панели дашборда с их запросами PromQL, LogQL или SQL; выполняет через Grafana запросы к Prometheus (или Mimir), Loki и источникам данных SQL; показывает, какие алерты срабатывают прямо сейчас, как определены их правила и какие точки контакта получают уведомления; читает аннотации, которыми на графиках отмечены развёртывания и инциденты; выводит пользователей и команды организации.

Одно изменение, и ИИ сначала спрашивает: единственное, что коннектор может изменить, это добавить аннотацию через grafana_create_annotation, а её видят все на дашбордах. Перед этим ИИ показывает вам текст, время и теги и ждёт вашего «да». Ничто здесь не меняет дашборды, источники данных или правила алертов, и ничего не удаляется.

Секреты остаются в Grafana: пароли и ключи источников данных никогда не возвращаются, а точки контакта приходят без своих настроек, в которых хранятся URL вебхуков и ключи.

Ограничения: ответы на запросы обрезаются примерно на 60 КБ, поэтому ИИ агрегирует данные в самом запросе (sum, topk, rate) и выбирает короткие временные диапазоны. Дашборды, сохранённые в новой схеме v2 (дашборды Grafana 12 с вкладками или автоматической сеткой), могут не читаться через этот API; тогда Grafana отвечает ошибкой, в которой назван новый API.

Частые ошибки: 401 Invalid API key: токен неверный, истёк или удалён, либо GRAFANA_URL указывает на другой стек. 403: у сервисного аккаунта слишком низкая роль (Admin для пользователей и команд, Editor для аннотаций) или нет права на запросы к этому источнику данных. 404: в этой организации нет дашборда, источника данных или правила с таким uid, либо в GRAFANA_URL указан неверный путь. 400 при запросе: выражение недопустимо для этого источника данных, и в сообщении сказано почему.

Коннектор не создаёт и не изменяет дашборды, источники данных, правила алертов, точки контакта, заглушения (silences) и пользователей, ничего не удаляет и не охватывает Grafana OnCall, Grafana Incident и API стеков Grafana Cloud.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Grafana.

Доступные инструменты

Примеры запросов

• «Какие алерты сейчас срабатывают в Grafana? Для каждого покажи правило, которое за ним стоит, и точку контакта, которая получает уведомление.»
• «Найди наш дашборд задержек API и объясни, что показывает каждая панель и какой запрос она выполняет.»
• «Запроси в Prometheus частоту ответов 5xx по каждому сервису за последний час и скажи, у какого сервиса хуже всего.»
• «Покажи строки с ошибками, которые Loki записал для приложения checkout за последние 30 минут, и сгруппируй их по сообщению.»
• «Добавь аннотацию „Deployed v2.4.1“ с тегом deploy на сегодня, 14:05. Покажи мне текст, время и теги, прежде чем добавлять.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT