Registrera fjärrservern Power BI MCP med externa MCP-klienter (förhandsversion)

Den fjärranslutna Power BI MCP-servern fungerar direkt med MCP-klienter som levereras med ett förregistrerat Microsoft Entra program, till exempel Visual Studio Code och GitHub Copilot CLI. Andra MCP-klienter – till exempel Claude Desktop och ChatGPT kräver registrering av ett OAuth-klient-ID. Microsoft Entra ID stöder för närvarande inte klientregistrering, så dessa klienter kan inte automatiskt hämta ett klient-ID för Power BI MCP-servern.

För att undvika detta registrerar du själv en Microsoft Entra app och anger dess program-ID (klient)-ID till MCP-klienten som OAuth-klient-ID.

Den här artikeln visar hur du gör följande:

  • Skapa och konfigurera en Microsoft Entra appregistrering för en extern MCP-klient
  • Registrera fjärrservern Power BI MCP i den externa klienten med hjälp av Entra-app-ID:t

Förutsättningar

Kontrollera att du har följande innan du börjar:

  • Administrator approval – Din Power BI administratör måste aktivera klientinställningen: Användare kan använda serverslutpunkten Power BI Model Context Protocol (förhandsversion).
  • Behörigheter för att registrera en app – Du kan antingen registrera appar i din Microsoft Entra klientorganisation eller arbeta med en klientadministratör som kan registrera appen åt dig.

Steg 1: Skapa en Microsoft Entra-appregistrering

Skapa en ny appregistrering i samma Microsoft Entra klientorganisation som är värd för din Power BI miljö.

  1. Logga in på Microsoft Entra administrationscenter som en användare som kan registrera program.
  2. Gå till App registrations och välj sedan Ny registrering.
  3. Ange ett beskrivande namn, till exempel Power BI MCP - Claude Desktop.
  4. Under Kontotyper som stöds väljer du Endast konton i den här organisationskatalogen (enskild klient).
  5. Lämna omdirigerings-URI tom för tillfället. Du konfigurerar det i nästa steg.
  6. Välj Registrera.
  7. På appens översiktssida kopierar du program-ID:t (klient-ID:t). Du använder den senare när du konfigurerar MCP-klienten.

Steg 2: Konfigurera omdirigerings-URI:n

Externa MCP-klienter fungerar som offentliga klienter, så du måste lägga till en omdirigerings-URI av typen Offentlig klient/intern (mobil och skrivbord).

  1. I appregistreringen väljer du Autentisering>Lägg till omdirigerings-URI-mobil>- och skrivbordsprogram.

  2. Lägg till omdirigerings-URI:n som tillhandahålls av MCP-klienten. Ett exempel:

    MCP-klient URI för omdirigering
    Claude-skrivbordet https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Övriga klienter Använd url:en för OAuth-återanrop som dokumenterats av klienten

  3. Välj Konfigurera för att spara plattformskonfigurationen.

  4. På sidan Autentisering under Avancerade inställningar kontrollerar du att Tillåt offentliga klientflöden är inställt på Nej om inte klientdokumentationen uttryckligen kräver det.

  5. Välj Spara.

Viktigt!

Använd alltid den exakta omdirigerings-URI som dokumenteras av MCP-klienten. Ett matchningsfel gör att OAuth-inloggningen misslyckas.

Steg 3: Lägg till delegerade rozhranie API služby Power BI behörigheter

Fjärrservern Power BI MCP anropar Power BI REST-API:er för den inloggade användarens räkning. Bevilja följande delegerade behörigheter för API:et Power BI Service.

  1. I appregistreringen väljer du API-behörigheter>Lägg till en behörighet.

  2. Välj Power BI Service i api:erna Microsoft.

  3. Välj Delegerade behörigheter och lägg sedan till följande behörigheter:

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

    Scope Description
    Dataset.Read.All Läs alla semantiska modeller som användaren kan komma åt.
    MLModel.Execute.All Gör det möjligt att köra ML-modeller.
    Workspace.Read.All Läs de arbetsytor som användaren kan komma åt.

  4. Välj Lägg till behörigheter.

  5. (Valfritt) Om din klientorganisation kräver administratörsmedgivande för dessa behörigheter väljer du Bevilja administratörsmedgivande. Annars uppmanas användarna att godkänna första gången de loggar in från MCP-klienten.

Steg 4: Registrera fjärrservern Power BI MCP i MCP-klienten

Använd Application (klient)-ID från steg 1 som OAuth-klient-ID när du lägger till fjärrservern Power BI MCP till klienten. De exakta konfigurationsstegen beror på klienten.

Om inloggningen misslyckas kontrollerar du att:

  • Omdirigerings-URI:n i Din Entra-app matchar exakt den som förväntas av klienten.
  • Nödvändiga delegerade Power BI behörigheter beviljas (och administratörsmedgivande om det krävs av din klient).
  • Klientinställningen "Användare kan använda serverslutpunkten Power BI Model Context Protocol (förhandsversion)" är aktiverad.

Claude-skrivbordet

  1. Öppna Claude Desktop och gå sedan till Inställningar>Anslutningsappar>Lägg till anpassad anslutningsapp.

  2. Ange följande värden:

    • Namn: Power BI
    • URL för fjärr-MCP-server: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • OAuth-klient-ID: program-ID (klient)-ID från steg 1.

  3. Spara anslutningen. Claude Desktop öppnar ett webbläsarfönster så att du kan logga in med ditt Microsoft Entra-konto och godkänna de begärda Power BI behörigheterna.

ChatGPT

  1. I ChatGPT går du till Inställningar>Appar>Skapa app.

  2. Fyll i dialogrutan Ny app :

    • Namn: Power BI
    • MCP-server-URL: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Autentisering: Välj OAuth.

  3. Expandera Avancerade inställningar för att granska de identifierade OAuth-inställningarna och konfigurera sedan:

    • Registreringsmetod: Välj User-Defined OAuth-klient.
    • OAuth-klient-ID: Ange program-ID (klient)-ID från steg 1.

  4. Välj Skapa. ChatGPT uppmanar dig att logga in med ditt Microsoft Entra-konto och samtycka till de begärda Power BI behörigheterna.

Andra MCP-klienter

För andra MCP-klienter följer du klientens dokumentation för att lägga till en fjärr-MCP-server.

Testa anslutningen

När du har registrerat servern i klienten verifierar du konfigurationen:

  1. Starta en ny konversation i MCP-klienten.
  2. Ställ en fråga som kräver Power BI MCP-server, till exempel: "Vilka tabeller finns i semantisk modell [ID för semantikmodellen]?".
  3. Bekräfta att klienten returnerar resultat från din Power BI semantiska modell.

Relaterat innehåll

  • Last updated on