Grafana über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Grafana klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Grafana + Cursor

Lass deine KI dein Grafana lesen: Dashboards durchsuchen und ihre Panels und Abfragen ansehen, Prometheus-, Loki- und SQL-Datenquellen abfragen, sehen, welche Alerts gerade feuern und wie die Regeln definiert sind, Annotationen lesen und hinzufügen sowie Contact Points, Nutzer und Teams auflisten. Funktioniert mit Grafana Cloud und selbst gehostetem Grafana.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN

Schritt 1 — Zugangsdaten holen

1. Setze GRAFANA_URL auf die Adresse, unter der du Grafana öffnest, ohne abschließenden Schrägstrich: https://your-stack.grafana.net bei Grafana Cloud oder deine eigene Adresse wie https://grafana.example.com (oder https://example.com/grafana, wenn Grafana unter einem Pfad läuft). Bei AnythingMCP Cloud muss die Instanz aus dem Internet erreichbar sein.
2. Öffne in Grafana Administration → Users and access → Service accounts, klicke auf Add service account und gib ihm einen Namen (zum Beispiel AnythingMCP) und die Rolle Viewer.
3. Öffne den Service Account, klicke auf Add service account token, wähle ein Ablaufdatum und kopiere den Token. Er beginnt mit glsa_, und Grafana zeigt ihn nur einmal an.
4. Füge ihn ohne das Wort Bearer in GRAFANA_SERVICE_ACCOUNT_TOKEN ein und installiere den Connector. Der Token erreicht nur die Organisation, zu der der Service Account gehört.
5. Prüfe die Einrichtung mit grafana_get_current_org: Es zeigt die Organisation hinter dem Token. grafana_get_health antwortet auch ohne Token; es zeigt also die Grafana-Version, beweist aber nicht, dass der Token funktioniert.

Welche Rolle: Viewer deckt Dashboards, Ordner, Datenquellen, Abfragen, Alert-Regeln, feuernde Alerts, Annotationen und Contact Points ab. Zum Auflisten von Nutzern und Teams braucht es Admin, zum Hinzufügen von Annotationen Editor. Bei Grafana Cloud und Grafana Enterprise braucht der Service Account außerdem Abfrageberechtigung für jede Datenquelle, die er lesen soll.

Was er kann: Dashboards und Ordner durchsuchen und die Panels eines Dashboards mit ihren PromQL-, LogQL- oder SQL-Abfragen lesen; über Grafana Abfragen gegen Prometheus (oder Mimir), Loki und SQL-Datenquellen ausführen; sehen, welche Alerts gerade feuern, wie ihre Regeln definiert sind und welche Contact Points die Benachrichtigungen bekommen; die Annotationen lesen, die Deployments und Incidents in deinen Graphen markieren; die Nutzer und Teams der Organisation auflisten.

Eine einzige Änderung, und die KI fragt vorher: Das Einzige, was der Connector ändern kann, ist das Hinzufügen einer Annotation mit grafana_create_annotation, die alle auf den Dashboards sehen. Davor zeigt dir die KI Text, Zeitpunkt und Tags und wartet auf dein Ja. Nichts hier ändert Dashboards, Datenquellen oder Alert-Regeln, und nichts wird gelöscht.

Secrets bleiben in Grafana: Passwörter und Schlüssel von Datenquellen werden nie zurückgegeben, und Contact Points kommen ohne ihre Einstellungen, in denen Webhook-URLs und Schlüssel stehen.

Limits: Antworten auf Abfragen werden bei etwa 60 KB abgeschnitten, deshalb aggregiert die KI in der Abfrage (sum, topk, rate) und hält die Zeiträume kurz. Dashboards, die im neueren v2-Schema gespeichert sind (Grafana-12-Dashboards mit Tabs oder Auto-Grid-Layouts), sind über diese API möglicherweise nicht lesbar; Grafana antwortet dann mit einem Fehler, der die neue API nennt.

Häufige Fehler: 401 Invalid API key: Der Token ist falsch, abgelaufen oder gelöscht, oder GRAFANA_URL zeigt auf einen anderen Stack. 403: Die Rolle des Service Accounts reicht nicht aus (Admin für Nutzer und Teams, Editor für Annotationen), oder ihm fehlt die Abfrageberechtigung für diese Datenquelle. 404: kein Dashboard, keine Datenquelle und keine Regel mit dieser uid in dieser Organisation, oder ein falscher Pfad in GRAFANA_URL. 400 bei einer Abfrage: Der Ausdruck ist für diese Datenquelle nicht gültig, und die Meldung sagt, warum.

Der Connector legt keine Dashboards, Datenquellen, Alert-Regeln, Contact Points, Silences oder Nutzer an und ändert sie nicht, löscht nichts und deckt Grafana OnCall, Grafana Incident und die Grafana Cloud Stack API nicht ab.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Grafana-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Alerts feuern gerade in Grafana? Zeig mir zu jedem die Regel dahinter und den Contact Point, der die Benachrichtigung bekommt.“
• „Finde unser Dashboard zur API-Latenz und erkläre mir, was jedes Panel zeigt und welche Abfrage es ausführt.“
• „Frag in Prometheus die Rate der 5xx-Antworten pro Service in der letzten Stunde ab und sag mir, welcher Service am schlechtesten dasteht.“
• „Zeig mir die Fehlerzeilen, die Loki in den letzten 30 Minuten für die Checkout-App geloggt hat, gruppiert nach Meldung.“
• „Füge heute um 14:05 Uhr eine Annotation ‚Deployed v2.4.1‘ mit dem Tag deploy hinzu. Zeig mir Text, Zeitpunkt und Tags, bevor du sie hinzufügst.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden