Grafana MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Grafana-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden