MCP-сервер для Grafana

MCP-сервер для Grafana — это приложение, которое предоставляет AI-ассистентам доступ к Grafana через стандартный протокол Model Context Protocol (MCP). Сервер разворачивается на виртуальной машине в Yandex Cloud и подключается к существующему экземпляру Grafana.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP-сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• Интеграция с AI-ассистентами. Позволяет AI-моделям взаимодействовать с Grafana: искать и анализировать дашборды, просматривать источники данных, исследовать метрики и алерты.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Безопасное хранение секретов. Токен сервисного аккаунта Grafana хранится в Yandex Lockbox и извлекается при запуске.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями, обеспечивая совместимость с широким спектром клиентов.
• Streamable HTTP транспорт. MCP-сервер доступен на порту 8000 (Streamable HTTP) по внутреннему адресу ВМ. Внешний доступ можно включить при установке.
• Минимальные ресурсы. Приложение работает на виртуальной машине с минимальной конфигурацией (2 vCPU, 2 GB RAM), что снижает затраты на инфраструктуру.

1. Убедитесь, что у вас есть работающий экземпляр Grafana с доступом по API.
2. Создайте сервисный аккаунт в Grafana и выпустите для него токен доступа (Service Account Token) с необходимыми правами.
3. Создайте секрет в Yandex Lockbox для хранения токена сервисного аккаунта Grafana. Запишите токен в ключ api_key.
4. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
5. Создайте сервисный аккаунт для установки приложения и назначьте ему на каталог установки роли compute.editor, iam.serviceAccounts.admin, vpc.admin, resource-manager.admin.
6. Назначьте установочному сервисному аккаунту роль lockbox.admin отдельно на секрет с Bearer-токеном и на секрет с учётными данными внешнего сервиса. Роль нужна для чтения и изменения прав доступа к выбранным секретам; назначать её на каталог не требуется. Это правило действует и для секретов из другого каталога. При установке приложение создаст отдельный сервисный аккаунт ВМ и назначит ему lockbox.payloadViewer только на выбранные секреты.
7. Шаблон также назначает аккаунту ВМ certificate-manager.certificates.downloader на каталог установки. Для создания этой привязки IAM установочному аккаунту нужна роль resource-manager.admin, в том числе когда пользовательский сертификат не выбран. Если используете сертификат, выберите его из каталога установки; для сертификата из другого каталога отдельно предоставьте аккаунту ВМ доступ к нему.
8. В консоли управления выберите сервис Cloud Apps.
9. На панели слева выберите Магазин приложений.
10. Выберите MCP Grafana и нажмите кнопку Использовать.
11. Укажите:
    • Имя приложения.
    • (Опционально) Описание приложения.
    • Сервисный аккаунт, созданный ранее.
    • Облачную подсеть, в которой будет развёрнута виртуальная машина.
    • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
    • URL экземпляра Grafana.
    • Идентификатор секрета Lockbox с токеном сервисного аккаунта Grafana.
    • (Опционально) Включите внешний доступ к MCP-серверу на порту 8000. По умолчанию он выключен; для подключения по публичному IP его необходимо включить.
    • (Опционально) Сертификат из Yandex Certificate Manager для подключения к self-hosted Grafana по HTTPS.
    • (Опционально) Включите SSH-доступ и укажите имя пользователя и публичный SSH-ключ. Для подключения к ВМ используйте соответствующий приватный ключ.
12. Нажмите кнопку Установить и дождитесь, пока приложение установится.
13. После установки скопируйте полный адрес из раздела Данные приложения, поле URL MCP-сервера (внутренний): http://<private-ip>:8000/mcp. Клиенту нужен сетевой доступ к внутреннему IP-адресу ВМ из частной IPv4-сети.
14. Если при установке включён внешний доступ, для подключения из интернета используйте поле URL MCP-сервера (внешний). При выключенном внешнем доступе этот адрес недоступен, даже если у ВМ есть публичный IP.
15. Настройте ваш AI-клиент для подключения к MCP-серверу, указав заголовок Authorization: Bearer <ваш-токен>.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел Agent Core → MCP-серверы.
2. Нажмите Создать MCP-сервер и в разделе MCP-серверы из Yandex Cloud Marketplace выберите нужный MCP-сервер.
3. Укажите имя сервера и выберите уже развёрнутый экземпляр приложения или создайте новый, следуя инструкциям по развёртыванию. При развёртывании нового сервера кнопка Сохранить будет доступна только после полного развёртывания и запуска MCP-сервера.
4. После выбора приложения значения параметров Сеть и Сервисный аккаунт MCP-сервера заполнятся автоматически.
5. Нажмите Создать. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Сохранить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Поиск и анализ дашбордов Grafana с помощью AI-ассистента.
• Просмотр и исследование источников данных, настроенных в Grafana.
• Анализ алертов и правил оповещения через естественный язык.
• Исследование метрик и панелей дашбордов с помощью AI.
• Автоматизация рутинных задач мониторинга через AI-ассистента.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.