Паветта
Grafana MCP
Подключает агента к Grafana: искать и править дашборды, выполнять запросы PromQL и LogQL, смотреть алерты, инциденты и дежурства OnCall. Работает с Grafana на своём сервере и с Grafana Cloud.
Как подключить
Что сделать до подключения
Менеджер пакетов uv; вместо него можно запустить образ Docker grafana/mcp-grafana с флагом -t stdio
Grafana 9.0 или новее
GRAFANA_URLадрес вашей Grafana, для Grafana Cloud — адрес экземпляра вида https://myinstance.grafana.net
GRAFANA_SERVICE_ACCOUNT_TOKENсоздайте в Grafana сервисный аккаунт с нужными правами и выпустите для него токен
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env GRAFANA_URL=http://localhost:3000 --env 'GRAFANA_SERVICE_ACCOUNT_TOKEN=<токен сервисного аккаунта>' --transport stdio grafana \
-- uvx mcp-grafanaПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.grafana]
command = "uvx"
args = ["mcp-grafana"]
[mcp_servers.grafana.env]
GRAFANA_URL = "http://localhost:3000"
GRAFANA_SERVICE_ACCOUNT_TOKEN = "<токен сервисного аккаунта>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"grafana": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"grafana": {
"type": "local",
"command": ["uvx", "mcp-grafana"],
"environment": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<токен сервисного аккаунта>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
search_dashboardsищет дашбордыget_dashboard_summaryкратко описывает дашбордget_dashboard_propertyдостаёт часть дашборда по JSONPathupdate_dashboardсоздаёт или меняет дашбордget_dashboard_panel_queriesпоказывает запросы панелейlist_datasourcesпоказывает источники данныхquery_prometheusвыполняет запрос PromQLlist_prometheus_metric_namesпоказывает имена метрикquery_loki_logsищет логи через LogQLquery_loki_statsпоказывает статистику потоков логовquery_sqlвыполняет SQL к источникуalerting_rules_readпоказывает правила алертовalerting_rules_writeсоздаёт и меняет правила алертовcreate_incidentзаводит инцидентlist_oncall_schedulesпоказывает графики дежурствget_current_oncall_usersпоказывает, кто сейчас дежуритlist_alert_groupsпоказывает группы алертов OnCallcreate_annotationставит аннотациюget_panel_imageрендерит панель в PNGgenerate_deeplinkсобирает ссылку на ресурс GrafanaПоказано 20 из 123.
Что попросить агента
Для каких задач
Ограничения
Часть категорий выключена по умолчанию: admin, CloudWatch, Elasticsearch, Graphite, ClickHouse, запуск запросов панелей и другие; их включают флагом --enabled-tools
Большие дашборды через get_dashboard_by_uid и update_dashboard занимают много контекста; для точечных правок есть get_dashboard_summary и get_dashboard_property
Агент получает права сервисного аккаунта; простая роль Editor даёт широкий доступ на чтение и запись
С Grafana старше 9.0 часть функций, особенно связанных с источниками данных, может не работать
