grafana-cloud-mcp — плагин для Claude Code
Подключает агента к облачному MCP-серверу Grafana Cloud: запросы PromQL, LogQL, TraceQL, алерты и инциденты прямо из чата. Локально ставить нечего.
/plugin install grafana-cloud-mcp@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialЧто делает grafana-cloud-mcp
Плагин даёт Claude доступ к хостинговому MCP-серверу Grafana Cloud. Внутри — скилл grafana-cloud-mcp-tools и подключение к тому же серверу, что и коннектор Grafana Cloud. Инструментов больше шестидесяти: дашборды, источники данных, Prometheus, Loki, Tempo, Pyroscope, ClickHouse, CloudWatch, Elasticsearch, алертинг, инциденты, OnCall, Sift, аннотации, генерация диплинков и экспорт панелей в PNG.
Установка локальная не нужна, переменные окружения тоже. При первом подключении агент попросит адрес вашего Grafana Cloud и откроет браузер для авторизации по OAuth 2.1. Токен живёт 1 час и обновляется автоматически 30 дней.
Что нужно заранее: аккаунт Grafana Cloud, согласие администратора с условиями Grafana Assistant и роль Assistant Cloud MCP User либо разрешение grafana-assistant-app.cloud-mcp:access. У роли Editor и выше оно есть по умолчанию. Для self-hosted Grafana этот плагин не подойдёт — там нужен grafana-mcp. Если работаете в claude.ai, Claude Desktop или мобильном клиенте, добавляйте коннектор Grafana Cloud с адресом https://mcp.grafana.com/mcp в разделе Customize → Connectors.
Какие задачи решает
- посмотреть метрики Prometheus по запросу PromQL, не открывая браузер
- найти ошибки в логах Loki через LogQL
- разобрать медленный трейс в Tempo
- создать или поправить правило алертинга
- выгрузить панель дашборда картинкой
Примеры запросов агенту
- Покажи, какие дашборды есть в Grafana Cloud, и найди тот, что про latency API
- Спроси Prometheus: сколько 5xx было за последний час
- Найди в Loki ошибки сервиса checkout и сгруппируй их по сообщению
Как установить grafana-cloud-mcp
Через маркетплейс плагинов
/plugin install grafana-cloud-mcp@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о grafana-cloud-mcp
Как установить grafana-cloud-mcp в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add anthropics/claude-plugins-official. Затем поставьте плагин: /plugin install grafana-cloud-mcp@claude-plugins-official.
Что делает grafana-cloud-mcp?
Связывает агента с хостинговым MCP-сервером Grafana Cloud. Через него можно запрашивать метрики, логи, трейсы и профили, работать с алертами и инцидентами, строить диплинки и рендерить панели.
Нужен ли аккаунт Grafana Cloud?
Да, плагин рассчитан на Grafana Cloud. Администратор должен принять условия Grafana Assistant, а у вас должна быть роль Assistant Cloud MCP User или разрешение grafana-assistant-app.cloud-mcp:access.
Исходный текст
grafana-cloud-mcp · Apache-2.0
# Grafana Cloud MCP Plugin that connects AI agents to the hosted [Grafana Cloud MCP server](https://grafana.com/docs/grafana-cloud/machine-learning/assistant/configure/cloud-mcp/) for AI-assisted observability workflows. The Cloud MCP server is fully hosted and uses OAuth 2.1 authorization — no local installation or service account tokens required. **Using claude.ai, Claude Desktop, mobile, or Cowork?** Add the Grafana Cloud connector (`https://mcp.grafana.com/mcp`) under [**Customize → Connectors**](https://claude.ai/customize/connectors) (on Team or Enterprise, an Owner adds it under [**Organization settings → Connectors**](https://claude.ai/admin-settings/connectors)). This plugin uses the same server and sign-in, and adds the `grafana-cloud-mcp-tools` skill — install it as well as the connector where plugins are supported, and you'll see one set of tools, not two. ## Prerequisites 1. A **Grafana Cloud** account. Self-hosted users should use the [grafana-mcp](../grafana-mcp/) plugin instead. 2. An administrator must accept the Grafana Assistant terms and conditions. 3. You need the **Assistant Cloud MCP User** role or the `grafana-assistant-app.cloud-mcp:access` permission. Users with **Editor** role or higher have this by default. ## Setup No local installation or environment variables required. When your AI agent first connects, you'll be prompted to enter your Grafana Cloud URL and authorize the connection in your browser. Your OAuth token is valid for 1 hour and refreshes automatically for 30 days. ## Available tools The Cloud MCP server provides 60+ tools across these categories: | Category | Examples | | ------------- | -------------------------------------------------------------- | | Dashboards | search, get summary, get property, update | | Datasources | list, get by UID or name | | Prometheus | PromQL queries, metric metadata, label names/values | | Loki | LogQL log/metric queries, label metadata, patterns | | Tempo | TraceQL queries, attribute discovery (proxied from datasource) | | Pyroscope | profile queries, label names/values, profile types | | ClickHouse | list tables, describe table, SQL queries | | CloudWatch | namespaces, metrics, dimensions, queries | | Elasticsearch | Lucene and Query DSL searches | | Alerting | list/create/update alert rules, routing, contact points | | Incidents | search, create, add activity | | OnCall | schedules, shifts, on-call users, alert groups | | Sift | investigations, analyses, error patterns, slow requests | | Annotations | get, create, update, list tags | | Navigation | generate deeplinks to dashboards, panels, Explore | | Rendering | export dashboard panels as PNG images | | Other | ask_assistant, describe_infrastructure, get_assertions | See the [Grafana Cloud MCP documentation](https://grafana.com/docs/grafana-cloud/machine-learning/assistant/configure/cloud-mcp/) for the full tool reference.
© Grafana · Apache-2.0 · grafana/ai-marketplace
