MCP

Grafana MCP: primero lista orígenes de datos; no descargues de entrada un dashboard enorme

Para quien ya tiene Grafana 9.0+ y un token de cuenta de servicio y quiere ver orígenes o dashboards; la primera vez, solo lectura de orígenes — no actives runpanelquery.

Official source · grafana/mcp-grafana

Install

uvx mcp-grafana

Para quién

Para quien ya tiene una instancia Grafana 9.0 o más nueva y quiere que un modelo vea la instancia y el ecosistema alrededor (dashboards, orígenes). La evidencia indica: este MCP da acceso a una instancia Grafana y a su ecosistema.

Debes poder aportar GRAFANA_URL y un token de cuenta de servicio GRAFANA_SERVICE_ACCOUNT_TOKEN. Por debajo de 9.0, algunas funciones (sobre todo de orígenes) pueden faltar por APIs ausentes.

La evidencia no lista clientes ni escribe la mayoría de nombres de función de herramientas. La primera vez, solo lectura: no actives panel query (apagado por defecto) y no uses el ejemplo localhost:3000 tal cual en producción.

Primera prueba en 3 minutos

Sigue la ruta principal uvx. En el cliente configura:

"command": "uvx",
"args": ["mcp-grafana"],
"env": {
  "GRAFANA_URL": "http://localhost:3000",
  "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}

Sustituye la URL por tu instancia y el token por un token de cuenta de servicio. No los escribas en la conversación.

Requisitos: Grafana ≥ 9.0 alcanzable; la cuenta de servicio puede listar orígenes o leer dashboards. Esta llamada irá a tu Grafana con el token; no es un sandbox sin red.

Dónde configurar: command / args / env del MCP del cliente.

Primera llamada de bajo riesgo: primero «listar y obtener información de orígenes» (capacidad de la evidencia). No descargues primero un dashboard grande entero por UID. Las herramientas Run panel query están apagadas por defecto; no añadas runpanelquery a --enabled-tools solo para el primer intento.

Señal de éxito: al conectar, ves la lista de orígenes configurados. Si hay 401 o no conecta, comprueba primero URL y token, y si la instancia es ≥ 9.0.

Casos de uso

Caso 1: ver qué orígenes tiene la instancia. Usa «List and fetch datasource information». La evidencia indica tipos compatibles entre los que están Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena. No da nombres de función ni filtros. Lo confirmable: orígenes configurados y sus detalles.

Caso 2: tomar el detalle completo de un dashboard por UID. La evidencia avisa: un dashboard grande consume mucha ventana de contexto. Elige uno cuyo UID conozcas y que no sea enorme; si la respuesta es demasiado larga, párate en «la evidencia ya avisó del consumo de contexto» — no descargues el volumen completo una y otra vez. La evidencia no da el locator de una herramienta de recorte JSONPath; no inventes un nombre sustituto.

Límites de uso

Hace falta Grafana 9.0+, GRAFANA_URL y un token de cuenta de servicio. runpanelquery está desactivado por defecto y solo ejecuta panel query al activarlo. Traer un dashboard entero por UID puede reventar el contexto. Tipos de origen: solo los anteriores. No hay undo, ni tabla completa de nombres, ni privilegio mínimo del token. Acceder a Grafana y a los orígenes no es riesgo cero: lo que ve la cuenta de servicio lo ve el modelo. «Listar orígenes en solo lectura» no significa «sin red» ni «sin nombres de métricas sensibles».