grafana-cloud-mcp-tools

Grafana Cloud MCP Tools 用于连接 Grafana Cloud 托管的 MCP 服务器：该服务器通过 Streamable HTTP 传输提供 60 多个 Grafana Cloud 工具，并使用 OAuth 2.1 授权。使用前提为拥有 Grafana Cloud 账户（自托管用户应改用本地 OSS MCP 服务器）、具备 Assistant Cloud MCP User 角色或 grafana-assistant-app.cloud-mcp:access 权限（Editor 及以上默认拥有），且管理员已接受 Grafana Assistant 条款。使用方式：服务器地址为 https://mcp.grafana.com/mcp，无需本地安装或环境变量；插件加载时自动连接，按提示输入 Grafana Cloud URL 并在浏览器中授权，OAuth 令牌有效期 1 小时、30 天内自动刷新。授权时可选只读或写入权限：只读可查看仪表盘、告警、事件并查询数据源；写入可创建和修改仪表盘、告警和事件，可由组织管理员默认授予，若同意页禁用写入则用户需要 Assistant Admin 角色。工具覆盖搜索与导航、仪表盘与文件夹、数据源、Prometheus、Loki、Tempo、Pyroscope、ClickHouse、CloudWatch、Elasticsearch、告警、注释、事件、OnCall、Sift 及其他辅助工具（如 ask_assistant、get_panel_image、describe_infrastructure 等）。自然语言问题建议使用 ask_assistant，它需要写入范围（grafana:write）；未获写入权限时应改用只读工具并告知用户。为节省上下文，优先用 get_dashboard_summary 而非 get_dashboard_by_uid，并可用 get_dashboard_property 配合 JSONPath 提取部分内容。查询 Prometheus 应限定合理时间范围，查询 Loki 应使用带标签匹配器的 LogQL。未经明确要求避免写入操作。访问权限按用户 RBAC 控制，写入工具需要 grafana:write OAuth 范围。