Registrer den eksterne Power BI MCP-server hos eksterne MCP-klienter (forhåndsvisning)

Den eksterne Power BI MCP-server fungerer direkte med MCP-klienter, der leveres med en forudregistreret Microsoft Entra-applikation, såsom Visual Studio Code og GitHub Copilot CLI. Andre MCP-klienter – såsom Claude Desktop og ChatGPT – kræver registrering af et OAuth Client ID. Microsoft Entra ID understøtter i øjeblikket ikke klientregistrering, så disse klienter kan ikke automatisk få et klient-ID for Power BI MCP-serveren.

For at omgå dette registrerer du selv en Microsoft Entra-app og giver dens applikations-(klient-)ID til MCP-klienten som OAuth-klient-ID.

I denne artikel lærer du, hvordan du kan:

  • Opret og konfigurer en Microsoft Entra-appregistrering til en ekstern MCP-klient
  • Registrer den eksterne Power BI MCP-server i den eksterne klient ved hjælp af Entra-app-ID'et

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

  • Administrator approval - Din Power BI admin skal aktivere lejerindstillingen: Brugere kan bruge Power BI Model Context Protocol serverendpoint (preview).
  • Tilladelser til at registrere en app - Du kan enten registrere apps i din Microsoft Entra lejer, eller samarbejde med en lejeradministrator, som kan registrere appen for dig.

Trin 1: Opret en Microsoft Entra-app-registrering

Opret en ny app-registrering i den samme Microsoft Entra-lejer, der hoster dit Power BI-miljø.

  1. Log ind på Microsoft Entra-administrationscenter som en bruger, der kan registrere applikationer.
  2. Gå til App registrations, og vælg derefter Ny registrering.
  3. Indtast et meningsfuldt navn, for eksempel Power BI MCP - Claude Desktop.
  4. Under Understøttede kontotyper vælg kun konti i denne organisationsmappe (Enkelt lejer).
  5. Lad Redirect-URI stå tom for nu. Du konfigurerer det i næste trin.
  6. Vælg Registrer.
  7. På appens Oversigtsside kopierer du applikations-ID'et (klient-ID'et). Du bruger det senere, når du konfigurerer MCP-klienten.

Trin 2: Konfigurer omdirigerings-URI'en

Eksterne MCP-klienter fungerer som offentlige klienter, så du skal tilføje en omdirigerings-URI af typen Offentlig klient/native (mobil og desktop).

  1. I din app-registrering skal du vælge Autentificering>Tilføj omdiriger URI>Mobil- og desktopapplikationer.

  2. Tilføj den omdirigerings-URI, som din MCP-klient har leveret. Eksempel:

    MCP-klient Omdiriger URI-adresse
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Andre klienter Brug OAuth callback-URL'en, som klienten dokumenterer

  3. Vælg Konfigurér for at gemme platformkonfigurationen.

  4. På Autentificeringssiden , under Avancerede indstillinger, bekræft at Tillad offentlige klientflows er sat til Nej , medmindre din klientdokumentation eksplicit kræver det.

  5. Vælg Gem.

Vigtigt

Brug altid den præcise omdirigerings-URI, som din MCP-klient dokumenterer. En mismatch får OAuth-login-processen til at fejle.

Trin 3: Tilføj delegerede Power BI-API-tilladelser

Den eksterne Power BI MCP-server kalder Power BI REST API'erne på vegne af den indloggede bruger. Giv følgende delegerede tilladelser til Power BI Service API'en.

  1. I din appregistrering skal du vælge API-tilladelser>Tilføj en tilladelse.

  2. Vælg Power BI Service i Microsoft APIs.

  3. Vælg Delegerede tilladelser, og tilføj derefter følgende tilladelser:

    Ressource URI: https://analysis.windows.net/powerbi/api

    Omfanget Beskrivelse
    Dataset.Read.All Læs alle semantiske modeller, som brugeren kan få adgang til.
    MLModel.Execute.All Muliggør udførelse af ML-modeller.
    Workspace.Read.All Læs de arbejdsområder, brugeren kan få adgang til.

  4. Vælg Tilføj tilladelser.

  5. (Valgfrit) Hvis din lejer kræver admin-samtykke for disse tilladelser, vælg Giv admin-samtykke. Ellers bliver brugerne bedt om at give samtykke første gang, de logger ind fra MCP-klienten.

Trin 4: Registrer den eksterne Power BI MCP-server i MCP-klienten

Brug Application (klient) ID fra trin 1 som OAuth-klient-ID, når du tilføjer den eksterne Power BI MCP-server til din klient. De præcise konfigurationstrin afhænger af klienten.

Hvis login fejler, skal du verificere at:

  • Redirect-URI'en i din Entra-app matcher præcis den, klienten forventer.
  • De nødvendige delegerede Power BI-tilladelser gives (og administreres af administrator, hvis det kræves af din lejer).
  • Lejerindstillingen "Brugere kan bruge Power BI Model Context Protocol serverendpoint (preview)" er aktiveret.

Claude Desktop

  1. Åbn Claude Desktop, og gå derefter til Indstillinger>Stik>Tilføj brugerdefineret stik.

  2. Angiv følgende værdier:

    • Navn: Power BI
    • Fjern MCP-server-URL:https://api.fabric.microsoft.com/v1/mcp/powerbi
    • OAuth Client ID:Application (klient) ID fra trin 1.

  3. Gem stikket. Claude Desktop åbner et browservindue, så du kan logge ind med din Microsoft Entra-konto og give samtykke til de ønskede Power BI-tilladelser.

ChatGPT

  1. I ChatGPT skal du gå til Indstillinger>Apps>Opret app.

  2. Udfyld dialogen Ny App :

    • Navn: Power BI
    • MCP Server URL:https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Autentificering: Vælg OAuth.

  3. Udvid Avancerede indstillinger for at gennemgå de opdagede OAuth-indstillinger, og konfigurér derefter:

    • Registreringsmetode: Vælg User-Defined OAuth Client.
    • OAuth Client ID: Indtast Application (klient) ID fra trin 1.

  4. Vælg Opret. ChatGPT beder dig om at logge ind med din Microsoft Entra-konto og give samtykke til de ønskede Power BI-tilladelser.

Andre MCP-klienter

For andre MCP-klienter skal du følge klientens dokumentation for at tilføje en fjern MCP-server.

Test din forbindelse

Efter du har registreret serveren i klienten, validerer du opsætningen:

  1. Start en ny samtale i din MCP-klient.
  2. Stil et spørgsmål, der kræver Power BI MCP-serveren, for eksempel: "Hvilke tabeller er i den semantiske model [ID for den semantiske model]?".
  3. Bekræft, at klienten returnerer resultater fra din Power BI semantiske model.

Relateret indhold

  • Last updated on