Microsoft Power BI über MCP mit Claude verbinden

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

Microsoft Power BI + Claude

Power BI REST API, angemeldet mit deinem Microsoft-Geschäftskonto: Workspaces, semantische Modelle, Berichte, Dashboards, Dataflows, Gateways und Apps, DAX-Abfragen gegen ein Modell, Datenquellen, Parameter, Aktualisierungsverlauf und Zeitpläne sowie Aktualisierungen starten oder abbrechen. Das Ändern von Modellparametern ist bei der Installation aus.

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:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert einmalig etwa 10 Minuten. Du brauchst ein Microsoft-Geschäfts- oder Schulkonto mit Power-BI-Lizenz (Free, Pro oder Premium Per User) und eine kostenlose App-Registrierung in Microsoft Entra. In manchen Organisationen darf nur ein Admin die Zustimmung erteilen.

1. Öffne https://entra.microsoft.com, dann Applications, App registrations, New registration. Die App-Registrierung eines anderen Microsoft-Connectors kann wiederverwendet werden.
2. Unterstützte Kontotypen: Accounts in this organizational directory only ist die übliche Wahl. Power BI funktioniert nur mit Geschäfts- oder Schulkonten, nicht mit persönlichen Microsoft-Konten.
3. Umleitungs-URI: Plattform Web, https://cloud.anythingmcp.com/api/mcp-oauth/callback auf AnythingMCP Cloud oder <your AnythingMCP URL>/api/mcp-oauth/callback, wenn du AnythingMCP selbst betreibst. Sie muss Zeichen für Zeichen übereinstimmen, sonst antwortet Microsoft mit AADSTS50011.
4. API permissions, Add a permission, Power BI Service, Delegated permissions: Hak Workspace.Read.All, Dataset.ReadWrite.All, Report.Read.All, Dashboard.Read.All, Dataflow.ReadWrite.All, Gateway.Read.All und App.Read.All an. Für einen Connector, der nur lesen darf, nimm stattdessen Dataset.Read.All und Dataflow.Read.All. Klick danach auf Grant admin consent, wenn Benutzer in deiner Organisation nicht selbst zustimmen dürfen.
5. Certificates & secrets, New client secret: Kopiere den Value des Secrets (wird nur einmal angezeigt), nicht die Secret ID.
6. Füge die Application (client) ID in MICROSOFT_CLIENT_ID und den Secret-Wert in MICROSOFT_CLIENT_SECRET ein. Setz MICROSOFT_TENANT_ID auf die Directory (tenant) ID, auf deine Domain wie contoso.onmicrosoft.com oder auf organizations für eine mandantenübergreifende App; common und consumers kommen nicht in Frage. Installiere den Connector.
7. Klick auf der Connector-Seite auf Authorize with Provider und melde dich mit einem Benutzer an, der eine Power-BI-Lizenz hat. Das Refresh-Token wird verschlüsselt gespeichert, Access-Tokens werden automatisch erneuert. Ruf zur Kontrolle power_bi_list_workspaces auf.

Scope: Der Connector fordert https://analysis.windows.net/powerbi/api/.default offline_access an. .default gewährt die in Schritt 4 angehakten Power-BI-Berechtigungen (dort hinzufügen oder entfernen, dann erneut autorisieren), offline_access liefert das Refresh-Token. Füg diesem Connector keine Microsoft-Graph-Scopes hinzu: Ein Token dient einer API.

Wessen Zugriff: Die KI sieht genau das, was der angemeldete Benutzer im Power-BI-Dienst sehen darf. Modelle mit Sicherheit auf Zeilenebene liefern nur die Zeilen, die dieser Benutzer sehen darf.

Was er liest: Workspaces und wer mit welcher Rolle Zugriff hat; pro Workspace die semantischen Modelle (Datasets), die Berichte und ihre Seiten, die Dashboards und ihre Kacheln, die Dataflows und die Importe von .pbix-, .rdl-, .xlsx- oder .json-Dateien; den Inhalt von „Mein Arbeitsbereich“ (My workspace), der keine Workspace-ID hat, über power_bi_list_my_datasets, power_bi_list_my_reports und power_bi_list_my_dashboards; installierte Apps mit ihren Berichten und Dashboards; Datenquellen und Power-Query-Parameter eines Modells; den Aktualisierungsverlauf (eine fehlgeschlagene Aktualisierung trägt ihren Fehler in serviceExceptionJson), die Details einer erweiterten Aktualisierung und den Aktualisierungszeitplan; Aktualisierungsvorgänge und Datenquellen von Dataflows; die lokalen Gateways, die der Benutzer verwaltet, ihre Datenquellen und ob ein Gateway eine davon erreicht.

DAX-Abfragen: power_bi_execute_dax_query beantwortet Fragen mit Zahlen aus einem semantischen Modell. Dafür muss die Mandanteneinstellung Dataset Execute Queries REST API (in neueren Admin-Portalen Semantic model Execute Queries REST API; Admin portal, Tenant settings, Integration settings) aktiv sein, und der Benutzer braucht Lese- und Build-Berechtigung auf dem Modell. Modelle in Azure Analysis Services werden nicht unterstützt. Eine Abfrage pro Aufruf, beginnend mit EVALUATE (optional nach DEFINE), nur DAX. Um ein Modell kennenzulernen, listet EVALUATE COLUMNSTATISTICS() seine Tabellen und Spalten, und EVALUATE TOPN(5, 'Table') zeigt Beispielzeilen. Die API listet keine Measures (INFO-Funktionen und DMV-Abfragen werden abgelehnt); die KI fragt dich deshalb nach den Measure-Namen oder nimmt die, die der Bericht zeigt, und zieht die Measures des Modells dem Summieren roher Spalten vor. impersonated_user_name prüft die Sicht eines anderen Benutzers unter Sicherheit auf Zeilenebene und braucht Schreibrechte auf dem Modell.

Was er schreibt: power_bi_refresh_dataset, power_bi_cancel_refresh und power_bi_refresh_dataflow sind bei der Installation aktiv. Eine Aktualisierung lädt die Quellen und zählt zum täglichen Aktualisierungslimit, deshalb fragt die KI vor dem Start bei dir nach. Eine Dataset-Aktualisierung antwortet mit 202 ohne Inhalt; der neue Lauf erscheint oben in power_bi_get_refresh_history mit Status Unknown, solange er läuft. Geteilte Kapazität (Pro) erlaubt 8 Aktualisierungen pro Tag und Modell, geplante eingeschlossen, und nur notify_option. Optionen wie type, objects oder commit_mode machen daraus eine erweiterte Aktualisierung, die Premium-, PPU- oder Fabric-Kapazität braucht und kein notify_option senden darf. Nur erweiterte Aktualisierungen lassen sich mit power_bi_get_refresh_details verfolgen und mit power_bi_cancel_refresh abbrechen.

Bei der Installation deaktiviert: power_bi_update_dataset_parameters, das Power-Query-Parameter eines Modells ändert (etwa welchen Server oder welchen Zeitraum es lädt) und bei der nächsten Aktualisierung wirkt. Schalte es nur pro Tool ein, wenn die KI das tun soll.

Datenformate: Listen kommen als {"value": [...]}. IDs sind GUIDs. Zeiten sind ISO 8601 in UTC. webUrl öffnet das Element im Power-BI-Dienst. DAX-Ergebnisse kommen in results[0].tables[0].rows, Spaltenschlüssel als Table[Column], berechnete Spalten als [Name].

Paginierung und Filter: Listen-Tools liefern alles auf einmal, außer power_bi_list_workspaces und power_bi_list_workspace_users, die mit top und skip blättern. Workspaces lassen sich mit OData filtern, etwa contains(name,'Sales').

Limits: Eine DAX-Abfrage liefert eine Tabelle mit höchstens 100.000 Zeilen oder 1.000.000 Werten, je nachdem, was zuerst erreicht ist, und 15 MB; pro Benutzer sind 120 Abfragen pro Minute möglich. Die Power BI REST API drosselt pro Benutzer und pro Mandant, eine 429-Antwort enthält Retry-After. Premium-Kapazitäten verlangsamen Aktualisierungen bei Überlast, und eine Aktualisierung, die länger als eine Stunde gedrosselt wird, schlägt fehl.

Häufige Fehler: 401 heißt, die Autorisierung ist abgelaufen oder wurde widerrufen, oder das Client Secret ist abgelaufen: Füg bei Bedarf ein neues Secret ein und klick erneut auf Authorize with Provider. 403 PowerBINotAuthorizedException oder Unauthorized heißt, der Benutzer hat keinen Zugriff auf diesen Workspace oder dieses Element, eine Berechtigung aus Schritt 4 fehlt, oder bei DAX fehlt die Build-Berechtigung oder die Mandanteneinstellung. 404 ItemNotFound oder PowerBIEntityNotFound heißt falsche ID oder ein Element in einem anderen Workspace. 400 DatasetExecuteQueriesError heißt, die DAX-Abfrage ist ungültig; die Meldung der Engine sagt, warum. 400 bei einer Aktualisierung heißt, notify_option wurde mit erweiterten Optionen gesendet, erweiterte Optionen wurden auf geteilter Kapazität verwendet, oder es läuft schon eine Aktualisierung.

Der Connector erstellt, bearbeitet oder löscht keine Berichte, Dashboards oder Modelle, lädt keine .pbix-Dateien hoch und nutzt kein Microsoft Graph. Mit persönlichen Microsoft-Konten funktioniert er nicht.

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 Claude 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.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. Microsoft Power BI, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Welche semantischen Modelle im Workspace Vertrieb sind bei der letzten Aktualisierung fehlgeschlagen, und warum?“
• „Wie hoch war laut dem Modell hinter dem Bericht Umsatzübersicht der Umsatz pro Region im Q3 2026?“
• „Zeig mir die Tabellen und Spalten des Modells Finanzen und fünf Beispielzeilen der Tabelle Aufträge.“
• „Liste die Seiten des Berichts Management Summary und die Kacheln des KPI-Dashboards auf.“
• „Zeig den heutigen Aktualisierungsverlauf des Modells Lagerbestand und starte danach eine Aktualisierung, sobald ich zustimme.“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden