Grafana MCP einrichten: Dashboards und Leserechte

Ein guter erster Test beantwortet eine kleine Frage: Kann die Verbindung genau das vorbereitete Dashboard lesen? Notieren Sie dessen UID, den Ordner und die erwartete Datenquelle. Ein allgemeiner Auftrag wie „Prüfen Sie die gesamte Umgebung“ erschwert die Fehlersuche, weil Kontozugriff, Abfrage und Ergebnis zugleich unklar bleiben. Diese Anleitung beschreibt eine Einrichtung und einen eigenen Prüfplan.

Instanz und Service Account vorbereiten

Grafana dokumentiert den lokalen Start über uvx mcp-grafana. Die Instanzadresse steht in GRAFANA_URL, der Token in GRAFANA_SERVICE_ACCOUNT_TOKEN. Nutzen Sie einen eigens vorgesehenen Service Account mit passenden Rechten. Sein Token übernimmt dessen Berechtigungen. Prüfen Sie Ablaufdatum und Organisation, bevor Sie die Verbindung in einem gemeinsam genutzten Projekt hinterlegen.

VS-Code-Beispiel mit begrenztem Werkzeugumfang

Tragen Sie die tatsächliche Instanzadresse ein und ergänzen Sie diese Konfiguration in .vscode/mcp.json. Der Token wird bei Bedarf abgefragt. Installieren Sie uv vor dem Start und prüfen Sie, dass VS Code uvx findet. Der Schalter --disable-write entfernt Schreibwerkzeuge. Er ersetzt keine begrenzten Kontorechte. Welche Werkzeuge angeboten werden, hängt auch von der verwendeten Version ab.

{
  "servers": {
    "grafana": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-grafana",
        "--disable-write"
      ],
      "env": {
        "GRAFANA_URL": "https://YOUR_STACK.grafana.net",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "${input:grafana-token}"
      }
    }
  },
  "inputs": [
    {
      "id": "grafana-token",
      "type": "promptString",
      "description": "Grafana service account token",
      "password": true
    }
  ]
}

Die VS-Code-Anleitung erklärt Dateiauswahl und Start. Prüfen Sie bei einer bestehenden Datei deren Struktur, statt ein zweites Wurzelobjekt anzuhängen. Halten Sie nach einem erfolgreichen Versuch die verwendete Paketversion fest. So können Sie bei einem späteren Update zwischen einer Änderung der Konfiguration und einer Änderung des Servers unterscheiden.

Vom Dashboard zur passenden Datenquelle

1. Öffnen Sie das vorbereitete Dashboard selbst in Grafana. Notieren Sie UID, Datenquelle und einen festen Zeitraum mit einem erwarteten Messwert.

2. Starten Sie den MCP-Server und kontrollieren Sie die Werkzeugliste. Rufen Sie zunächst die Angaben zum bekannten Dashboard ab.

3. Vergleichen Sie UID und Datenquelle mit Ihrer Notiz. Lesen Sie anschließend nur den vorbereiteten Zeitraum, sofern Ihre Rechte die Abfrage erlauben.

4. Halten Sie Zeitbereich, Zeitzone und Ergebnis fest. Wiederholen Sie genau diesen Abruf nach Änderungen am Token oder an der Serverversion.

Fehler an der richtigen Stelle eingrenzen

Ein Dashboardtitel ist kein eindeutiger Nachweis für die richtige Umgebung. Verwenden Sie die UID und vergleichen Sie mindestens einen bekannten Wert. Bei leeren Zeitreihen prüfen Sie den Zeitraum, bevor Sie zusätzliche Rechte vergeben. Der Berechtigungsplaner hilft bei der Eingrenzung; der Fehler-Navigator trennt Start- und Verbindungsprobleme. Weitere Einträge stehen in der Grafana-Suche.

Macht --disable-write meinen Token lesend?

Nein. Der Schalter begrenzt die angebotenen Werkzeuge. Die Berechtigungen des Tokens müssen Sie am Service Account prüfen.

Welche Adresse gehört in GRAFANA_URL?

Die Adresse Ihrer Grafana-Instanz, beispielsweise Ihres eigenen Cloud-Stacks. Ersetzen Sie den Platzhalter im Beispiel.

Warum zeigt das Dashboard keine Daten?

Prüfen Sie Datenquelle, Rechte, Zeitraum und Zeitzone getrennt. Ein lesbares Dashboard bestätigt noch keine erfolgreiche Datenabfrage.

Wurde damit mein Konto geprüft?

Nein. Die Anleitung basiert auf Herstellerdokumentation. Der beschriebene erste Abruf ist von Ihnen in Ihrer Umgebung durchzuführen.

Herstellerquellen geprüft am 2. Oktober 2026. Kein angemeldeter Kontotest.

1. Grafana: MCP server
   Abrufbefehl anzeigen

   curl -s https://github.com/grafana/mcp-grafana
2. Grafana: Service accounts
   Abrufbefehl anzeigen

   curl -s https://grafana.com/docs/grafana/latest/administration/service-accounts/

Alle Beiträge