Registrer vertsbaserte Power BI MCP-servere med eksterne MCP-klienter (forhåndsversjon)

De driftede Power BI MCP-serverne fungerer med MCP-klienter som leveres med et forhåndsregistrert Microsoft Entra program, for eksempel Visual Studio Code og GitHub Copilot CLI. Andre MCP-klienter, for eksempel Claude Desktop og ChatGPT, krever en OAuth-klient-ID. Microsoft Entra ID støtter for øyeblikket ikke dynamisk klientregistrering, slik at disse klientene ikke kan få en klient-ID på egen hånd.

Hvis du vil omgå denne begrensningen, registrerer du en Microsoft Entra app selv og gir programmets (klient)-ID til MCP-klienten som OAuth-klient-ID.

Tabellen nedenfor viser de to vertsbaserte serverne og endepunktene:

Server Endepunktet
Power BI Redigering av MCP-server https://api.fabric.microsoft.com/v1/mcp/powerbi/authoring
Power BI MCP-server for forbruk https://api.fabric.microsoft.com/v1/mcp/powerbi

Denne artikkelen viser deg hvordan du gjør følgende:

  • Opprett og konfigurer en Microsoft Entra appregistrering for en ekstern MCP-klient.
  • Registrer en vert Power BI MCP-server i den eksterne klienten ved hjelp av Microsoft Entra app-ID.

Forutsetninger

  • Administratorgodkjenning. Den Power BI administratoren må aktivere leierinnstillingen Brukere kan bruke endepunktet for Power BI Model Context Protocol Server (forhåndsvisning).
  • Tillatelser til å registrere en app. Du kan enten registrere apper i Microsoft Entra tenanten eller arbeide med en leieradministrator som kan registrere appen for deg.

Trinn 1: Opprett en Microsoft Entra-appregistrering

Opprett en ny appregistrering i samme Microsoft Entra-leietaker som hoster Power BI-miljøet ditt.

  1. Logg inn på Microsoft Entra administrasjonssenter som en bruker som kan registrere applikasjoner.
  2. Gå til App registrations, og velg deretter Ny registrering.
  3. Skriv inn et meningsfullt navn, for eksempel Power BI MCP - Claude Desktop.
  4. Under Støttede kontotyper, velg Kontoer kun i denne organisasjonskatalogen (Enkelt leietaker).
  5. La omdirigerings-URI stå tom foreløpig. Du konfigurerer det i neste steg.
  6. Velg Registrer.
  7. På appens Oversiktsside, kopier applikasjons-ID-en (klient). Du bruker det senere når du konfigurerer MCP-klienten.

Trinn 2: Konfigurer omdirigerings-URI-en

Eksterne MCP-klienter fungerer som offentlige klienter, så du må legge til en omdirigerings-URI av typen Offentlig klient/native (mobil og desktop).

  1. I appregistreringen din, velg Autentisering>Legg til omdirigering URI>mobil- og skrivebordsapplikasjoner.

  2. Legg til omadresserings-URI-en som MCP-klienten tilbyr. Eksempel:

    MCP-klient URI-adresse for omdirigering
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Andre klienter Bruk URL-adressen for tilbakeringing av OAuth som klientdokumentene
  3. Velg Konfigurer for å lagre plattformkonfigurasjonen.

  4. På autentiseringssiden , under Avanserte innstillinger, bekreft at Tillat offentlige klientflyter er satt til Nei med mindre klientdokumentasjonen din eksplisitt krever det.

  5. Velg Lagre.

Important

Bruk alltid den nøyaktige omadresserings-URI-en som MCP-klienten dokumenterer. En mismatch fører til at OAuth-innloggingen feiler.

Trinn 3: Legg til delegerte Power BI-API-tillatelser

De driftede Power BI MCP-serverne kaller Power BI REST-API-er på vegne av den påloggede brukeren. Gi delegerte tillatelsene scenarioet trenger på Power BI tjeneste-API-en.

  1. Velg API-tillatelser>Legg til en tillatelse i appregistreringen.

  2. Velg Power BI Service i Microsoft APIer.

  3. Velg Delegerte tillatelser, og legg deretter til tillatelsene for serveren du registrerer.

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

    Omfang Beskrivelse Nødvendig for
    Dataset.Read.All Les alle semantiske modeller du har tilgang til. Forbruksserver
    MLModel.Execute.All Utfør ML-modeller. Forbruksserver
    Workspace.Read.All Les arbeidsområdene du har tilgang til. Redigerings- og forbruksserver
    SemanticModel.ReadWrite.All Les og skriv alle semantiske modeller du har tilgang til. Redigeringsserver
  4. Velg Legg til tillatelser.

  5. Hvis tenanten krever administratorsamtykke for disse tillatelsene, velger du Gi administratorsamtykke. Ellers ber MCP-klienten deg om å samtykke første gang du logger deg på.

Trinn 4: Registrere serveren i MCP-klienten

Bruk program-ID-en (klient) fra trinn 1 som OAuth-klient-ID når du legger til en vertsbasert Power BI MCP-server til klienten, og bruk endepunktet for serveren du vil bruke. De nøyaktige konfigurasjonstrinnene avhenger av klienten.

Hvis innlogging mislykkes, verifiser at:

  • Omadresserings-URI-en i Microsoft Entra-appen samsvarer nøyaktig med den klienten forventer.
  • De nødvendige delegerte Power BI tillatelser gis, og administratorsamtykket hvis leieren krever det.
  • Leierinnstillingen Brukere kan bruke endepunktet for Power BI Model Context Protocol Server (forhåndsvisning) er aktivert.

Registrere en Power BI MCP-server i Claude Desktop

  1. Åpne Claude Desktop, og gå deretter til Innstillinger>Koblinger>Legg til egendefinert kontakt.

  2. Angi følgende verdier:

    • Navn: Power BI
    • Url-adresse for ekstern MCP-server: endepunktet for serveren du vil registrere.
    • OAuth Client ID: Application (klient) ID fra steg 1.
  3. Spar kontakten. Claude Desktop åpner et nettleservindu slik at du kan logge inn med din Microsoft Entra-konto og samtykke til de forespurte Power BI-tillatelsene.

Registrere en Power BI MCP-server i ChatGPT

  1. I ChatGPT, gå til Innstillinger>Apper>Lag app.

  2. Fyll ut Ny App-dialogen :

    • Navn: Power BI
    • URL-adresse for MCP-server: endepunktet for serveren du vil registrere.
    • Autentisering: Velg OAuth.
  3. Utvid avanserte innstillinger for å se de oppdagede OAuth-innstillingene, og konfigurer deretter:

    • Registreringsmetode: Velg User-Defined OAuth-klienten.
    • OAuth Client ID: Skriv inn Application (klient) ID fra steg 1.
  4. Velg Opprett. ChatGPT ber deg logge inn med din Microsoft Entra-konto og samtykke til de forespurte Power BI-tillatelsene.

Registrere en Power BI MCP-server i andre MCP-klienter

For andre MCP-klienter, følg klientens dokumentasjon for å legge til en ekstern MCP-server.

Test Power BI MCP-servertilkoblingen

Etter at du har registrert serveren i klienten, valider oppsettet:

  1. Start en ny samtale i MCP-klienten din.
  2. Still et spørsmål som krever serveren. Prøv for forbruksserveren What tables are in semantic model [ID of the semantic model]?. Prøv for redigeringsserveren Connect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'.
  3. Bekreft at klienten returnerer resultater fra Power BI.