Registrieren des Remote-Power BI MCP-Servers mit externen MCP-Clients (Vorschau)

Der Remote-Power-BI-MCP-Server funktioniert ohne weitere Einrichtung mit MCP-Clients, die mit einer vorab registrierten Microsoft-Entra-Anwendung geliefert werden, beispielsweise Visual Studio Code und die GitHub Copilot CLI. Andere MCP-Clients – z. B. Claude Desktop und ChatGPT – erfordern die Registrierung einer OAuth-Client-ID. Microsoft Entra ID unterstützt derzeit keine Clientregistrierung, sodass diese Clients keine Client-ID für den Power BI MCP-Server automatisch abrufen können.

Um dies zu umgehen, registrieren Sie eine Microsoft Entra-App selbst und stellen ihre Anwendungs-ID (Client-ID) als OAuth-Client-ID für den MCP-Client bereit.

Dieser Artikel zeigt Ihnen, wie das geht:

  • Erstellen und Konfigurieren einer Microsoft Entra App-Registrierung für einen externen MCP-Client
  • Registrieren des Remote-Power BI MCP-Servers im externen Client mithilfe der Entra-App-ID

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:

  • Administratorgenehmigung – Ihr Power BI-Administrator muss die Mandanteneinstellung aktivieren: Benutzer können den Power BI Model Context Protocol-Serverendpunkt (Vorschau) verwenden.
  • Permissions zum Registrieren einer App – Sie können Apps entweder in Ihrem Microsoft Entra Mandanten registrieren oder mit einem Mandantenadministrator zusammenarbeiten, der die App für Sie registrieren kann.

Schritt 1: Erstellen einer Microsoft Entra-App-Registrierung

Erstellen Sie eine neue App-Registrierung im selben Microsoft Entra Mandanten, der Ihre Power BI Umgebung hosten soll.

  1. Melden Sie sich beim Microsoft Entra Admin Center als Benutzer an, der Anwendungen registrieren kann.
  2. Wechseln Sie zu App-Registrierungen, und wählen Sie dann Neue Registrierung aus.
  3. Geben Sie einen aussagekräftigen Namen ein, z. B. Power BI MCP - Claude Desktop.
  4. Wählen Sie unter "Unterstützte Kontotypen" nur "Konten" in diesem Organisationsverzeichnis (nur einzelner Mandant) aus.
  5. Lassen Sie den Umleitungs-URI vorerst leer. Sie konfigurieren sie im nächsten Schritt.
  6. Wählen Sie Registrieren aus.
  7. Kopieren Sie auf der Seite "Übersicht " der App die Anwendungs-ID (Client-ID). Sie verwenden sie später, wenn Sie den MCP-Client konfigurieren.

Schritt 2: Konfigurieren des Umleitungs-URI

Externe MCP-Clients fungieren als öffentliche Clients, daher müssen Sie einen Umleitungs-URI vom Typ "Öffentlicher Client/nativer" (Mobile & Desktop) hinzufügen.

  1. Wählen Sie in Ihrer App-Registrierung Authentifizierung>Umleitungs-URI hinzufügen>Mobile- und Desktopanwendungen aus.

  2. Fügen Sie den Umleitungs-URI hinzu, der von Ihrem MCP-Client bereitgestellt wird. Beispiel:

    MCP-Client Umleitungs-URI
    Claude-Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Andere Clients Verwenden der vom Client dokumentierten OAuth-Rückruf-URL

  3. Wählen Sie "Konfigurieren" aus, um die Plattformkonfiguration zu speichern.

  4. Vergewissern Sie sich auf der Seite " Authentifizierung " unter "Erweiterte Einstellungen", dass " Öffentliche Clientflüsse zulassen " auf "Nein " festgelegt ist, es sei denn, ihre Clientdokumentation erfordert sie explizit.

  5. Wählen Sie Speichern aus.

Important

Verwenden Sie immer den genauen Umleitungs-URI, der von Ihrem MCP-Client dokumentiert ist. Ein Konflikt führt dazu, dass die OAuth-Anmeldung fehlschlägt.

Schritt 3: Hinzufügen delegierter Power BI-API Berechtigungen

Der REMOTE-Power BI MCP-Server ruft die Power BI-REST-APIs im Namen des angemeldeten Benutzers auf. Erteilen Sie den folgenden delegierten Berechtigungen für die Power BI Service-API.

  1. Wählen Sie in Ihrer App-Registrierung API-Berechtigungen>"Berechtigung hinzufügen" aus.

  2. Wählen Sie Power BI Dienst in Microsoft-APIs aus.

  3. Wählen Sie delegierte Berechtigungen aus, und fügen Sie dann die folgenden Berechtigungen hinzu:

    Ressourcen-URI: https://analysis.windows.net/powerbi/api

    Scope Description
    Dataset.Read.All Alle semantischen Modelle lesen, auf die der Benutzer zugreifen kann.
    MLModel.Execute.All Ermöglicht das Ausführen von ML-Modellen.
    Workspace.Read.All Lesen Sie die Arbeitsbereiche, auf die der Benutzer zugreifen kann.

  4. Wählen Sie "Berechtigungen hinzufügen" aus.

  5. (Optional) Wenn Ihr Mandant die Administratorzustimmung für diese Berechtigungen erfordert, wählen Sie " Administratorzustimmung erteilen" aus. Andernfalls werden Benutzer aufgefordert, beim ersten Anmelden vom MCP-Client zuzustimmen.

Schritt 4: Registrieren des Remote-Power BI MCP-Servers im MCP-Client

Verwenden Sie die Application (Client)-ID aus Schritt 1 als OAuth-Client-ID, wenn Sie den Remote-Power BI MCP-Server zu Ihrem Client hinzufügen. Die genauen Konfigurationsschritte hängen vom Client ab.

Wenn die Anmeldung fehlschlägt, überprüfen Sie Folgendes:

  • Der Umleitungs-URI in Ihrer Entra-App entspricht exakt dem vom Client erwarteten.
  • Die erforderlichen delegierten Power BI-Berechtigungen wurden erteilt (und, falls von Ihrem Mandanten erforderlich, durch einen Administrator genehmigt).
  • Die Mandanteneinstellung "Benutzer können den Power BI Modellkontextprotokoll-Serverendpunkt (Vorschau)" verwenden, ist aktiviert.

Claude-Desktop

  1. Öffnen Sie Claude Desktop, und wechseln Sie dann zu "Einstellungen>Connectors>Hinzufügen eines benutzerdefinierten Connectors".

  2. Geben Sie die folgenden Werte ein:

    • Name: Power BI
    • REMOTE MCP-Server-URL: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • OAuth-Client-ID: die Anwendungs-ID (Client-ID) aus Schritt 1.

  3. Speichern Sie den Verbinder. Claude Desktop öffnet ein Browserfenster, damit Sie sich mit Ihrem Microsoft Entra Konto anmelden und den angeforderten Power BI Berechtigungen zustimmen können.

ChatGPT

  1. Wechseln Sie in ChatGPT zu "Einstellungen>Apps>Erstellen".

  2. Füllen Sie das Dialogfeld "Neue App " aus:

    • Name: Power BI
    • MCP-Server-URL: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Authentifizierung: Wählen Sie OAuth aus.

  3. Erweitern Sie erweiterte Einstellungen , um die ermittelten OAuth-Einstellungen zu überprüfen, und konfigurieren Sie dann Folgendes:

    • Registrierungsmethode: Wählen Sie User-Defined OAuth-Client aus.
    • OAuth-Client-ID: Geben Sie die Anwendungs-ID (Client-ID) aus Schritt 1 ein.

  4. Wählen Sie "Erstellen" aus. ChatGPT fordert Sie auf, sich mit Ihrem Microsoft Entra Konto anzumelden und den angeforderten Power BI Berechtigungen zuzustimmen.

Andere MCP-Clients

Folgen Sie für andere MCP-Clients der Dokumentation des Clients, um einen MCP-Remoteserver hinzuzufügen.

Ihre Verbindung testen

Nachdem Sie den Server im Client registriert haben, überprüfen Sie das Setup:

  1. Beginnen Sie eine neue Unterhaltung in Ihrem MCP-Client.
  2. Stellen Sie eine Frage, die den Power BI MCP-Server erfordert, z. B. "Welche Tabellen befinden sich im semantischen Modell [ID des semantischen Modells]?".
  3. Vergewissern Sie sich, dass der Client Ergebnisse aus Ihrem Power BI semantischen Modell zurückgibt.

Verwandte Inhalte

  • Last updated on