Externe Power BI MCP-server registreren met externe MCP-clients (preview)

De externe Power BI MCP-server werkt standaard met MCP-clients die worden verzonden met een vooraf geregistreerde Microsoft Entra-toepassing, zoals Visual Studio Code en de GitHub Copilot CLI. Andere MCP-clients, zoals Claude Desktop en ChatGPT , vereisen registratie van een OAuth-client-id. Microsoft Entra ID momenteel geen ondersteuning biedt voor clientregistratie, zodat deze clients niet automatisch een client-id voor de Power BI MCP-server kunnen verkrijgen.

U kunt dit omzeilen door zelf een Microsoft Entra app te registreren en de toepassings-id (client) op te geven aan de MCP-client als de OAuth-client-id.

In dit artikel leest u hoe u het volgende kunt doen:

  • Een Microsoft Entra-app-registratie maken en configureren voor een externe MCP-client
  • Registreer de externe Power BI MCP-server in de externe client met behulp van de Entra-app-id

Prerequisites

Voordat u begint, moet u ervoor zorgen dat u het volgende heeft:

  • Administrator-goedkeuring : de Power BI-beheerder moet de tenantinstelling inschakelen: Gebruikers kunnen het eindpunt van de Power BI Model Context Protocol-server (preview) gebruiken.
  • machtigingen voor het registreren van een app : u kunt apps registreren in uw Microsoft Entra-tenant of samenwerken met een tenantbeheerder die de app voor u kan registreren.

Stap 1: Een Microsoft Entra-app-registratie maken

Maak een nieuwe app-registratie in dezelfde Microsoft Entra tenant die als host fungeert voor uw Power BI-omgeving.

  1. Meld u aan bij de Microsoft Entra-beheercentrum als gebruiker die toepassingen kan registreren.
  2. Ga naar App-registraties en selecteer vervolgens Nieuwe registratie.
  3. Voer een betekenisvolle naam in, bijvoorbeeld Power BI MCP - Claude Desktop.
  4. Onder Ondersteunde accounttypen, selecteert u alleen accounts in deze organisatiemap (één tenant).
  5. Laat de omleidings-URI voorlopig leeg. U configureert deze in de volgende stap.
  6. Selecteer Registreren.
  7. Kopieer op de overzichtspagina van de app de toepassings-id (client). U gebruikt deze later wanneer u de MCP-client configureert.

Stap 2: de omleidings-URI configureren

Externe MCP-clients fungeren als openbare clients, dus u moet een omleidings-URI van het type Openbare client/systeemeigen (mobiel en desktop) toevoegen.

  1. Selecteer in uw app-registratie Verificatie>Omleidings-URI toevoegen>Mobiele en desktoptoepassingen.

  2. Voeg de omleidings-URI toe die wordt geleverd door uw MCP-client. Voorbeeld:

    MCP-client Omleidings-URL
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Andere clients De OAuth-callback-URL gebruiken die wordt gedocumenteerd door de client

  3. Selecteer Configureren om de platformconfiguratie op te slaan.

  4. Controleer op de pagina Verificatie onder Geavanceerde instellingen of Openbare clientstromen toestaan is ingesteld op Nee , tenzij uw clientdocumentatie dit expliciet vereist.

  5. Selecteer Opslaan.

Important

Gebruik altijd de exacte omleidings-URI die wordt beschreven door uw MCP-client. Een afwijking leidt ertoe dat de OAuth-aanmelding mislukt.

Stap 3: Gedelegeerde API van Power BI machtigingen toevoegen

De externe Power BI MCP-server roept de Power BI REST API's aan namens de aangemelde gebruiker. Verdeel de volgende gedelegeerde machtigingen voor de API Power BI Service.

  1. Selecteer API-machtigingen>toevoegen in uw app-registratie.

  2. Selecteer Power BI Service in Microsoft APIs.

  3. Selecteer Gedelegeerde machtigingen en voeg vervolgens de volgende machtigingen toe:

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

    Scope Description
    Dataset.Read.All Lees alle semantische modellen waartoe de gebruiker toegang heeft.
    MLModel.Execute.All Hiermee kunt u ML-modellen uitvoeren.
    Workspace.Read.All Lees de werkruimtes waartoe de gebruiker toegang heeft.

  4. Selecteer Machtigingen toevoegen.

  5. (Optioneel) Als uw tenant beheerderstoestemming voor deze machtigingen vereist, selecteert u Beheerderstoestemming verlenen. Anders wordt gebruikers gevraagd toestemming te geven wanneer ze zich de eerste keer aanmelden bij de MCP-client.

Stap 4: Registreer de externe Power BI MCP-server in de MCP-client

Gebruik de Application-id (client)-id uit stap 1 als de OAuth-client-id wanneer u de externe Power BI MCP-server aan uw client toevoegt. De exacte configuratiestappen zijn afhankelijk van de client.

Als het aanmelden mislukt, controleert u of:

  • De omleidings-URI in uw Entra-app komt exact overeen met de omleidings-URI die door de client wordt verwacht.
  • De vereiste gedelegeerde Power BI machtigingen worden verleend (en beheerderstoestemming indien vereist door uw tenant).
  • De tenantinstelling 'Gebruikers kunnen het eindpunt van de Power BI Model Context Protocol-server (preview)' gebruiken, is ingeschakeld.

Claude Desktop

  1. Open Claude Desktop en ga vervolgens naarInstellingenconnectors>>Aangepaste connector toevoegen.

  2. Voer de volgende waarden in:

    • Naam: Power BI
    • URL van externe MCP-server: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • OAuth-client-id: de toepassings-id (client) uit stap 1.

  3. Sla de connector op. Claude Desktop opent een browservenster, zodat u zich kunt aanmelden met uw Microsoft Entra-account en toestemming kunt geven voor de aangevraagde Power BI machtigingen.

ChatGPT

  1. Ga in ChatGPT naarInstellingen-apps>>app maken.

  2. Vul het dialoogvenster Nieuwe app in:

    • Naam: Power BI
    • URL van MCP-server: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Verificatie: Selecteer OAuth.

  3. Vouw Geavanceerde instellingen uit om de gedetecteerde OAuth-instellingen te controleren en configureer vervolgens:

    • Registratiemethode: selecteer User-Defined OAuth-client.
    • OAuth-client-id: voer de toepassings-id (client) in uit stap 1.

  4. Klik op Creëren. ChatGPT vraagt u zich aan te melden met uw Microsoft Entra-account en toestemming te geven voor de aangevraagde Power BI machtigingen.

Andere MCP-clients

Voor andere MCP-clients volgt u de documentatie van de client om een externe MCP-server toe te voegen.

Uw verbinding testen

Nadat u de server in de client hebt geregistreerd, valideert u de installatie:

  1. Start een nieuw gesprek in uw MCP-client.
  2. Stel een vraag waarvoor de Power BI MCP-server is vereist, bijvoorbeeld: 'Welke tabellen bevinden zich in het semantische model [id van het semantische model]?'.
  3. Controleer of de client resultaten retourneert van uw Power BI semantisch model.

Verwante inhoud

  • Last updated on