Registrer den eksterne Power BI MCP-serveren med eksterne MCP-klienter (forhåndsvisning)

Den eksterne Power BI MCP-serveren fungerer rett ut av boksen med MCP-klienter som leveres med en forhåndsregistrert Microsoft Entra-applikasjon, som Visual Studio Code og GitHub Copilot CLI. Andre MCP-klienter – som Claude Desktop og ChatGPT – krever registrering av en OAuth Client ID. Microsoft Entra ID støtter for øyeblikket ikke klientregistrering, så disse klientene kan ikke automatisk få en klient-ID for Power BI MCP-serveren.

For å omgå dette registrerer du en Microsoft Entra-app selv og gir applikasjons-ID-en (klient-)ID-en til MCP-klienten som OAuth-klient-ID-en.

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

• Opprett og konfigurer en Microsoft Entra-appregistrering for en ekstern MCP-klient
• Registrer den eksterne Power BI MCP-serveren i den eksterne klienten ved å bruke Entra-app-ID-en

Forutsetninger

Før du begynner, må du sørge for at du har:

• Administrator godkjenning - Din Power BI-administrator må aktivere leietakerinnstillingen: Brukere kan bruke Power BI Model Context Protocol serverendepunkt (forhåndsvisning).
• Tillatelser til å registrere en app - Du kan enten registrere apper i din Microsoft Entra leietaker, eller samarbeide med en leietakeradministrator 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 omdirigerings-URI-en som er gitt av MCP-klienten din. 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 OAuth-callback-URL-en som er dokumentert av klienten

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.

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

Den eksterne Power BI MCP-serveren kaller Power BI REST API-ene på vegne av den innloggede brukeren. Gi følgende delegerte tillatelser til Power BI Service API.

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 følgende tillatelser:

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

   Omfang	Beskrivelse
   Dataset.Read.All	Les alle semantiske modeller brukeren kan få tilgang til.
   MLModel.Execute.All	Tillater kjøring av ML-modeller.
   Workspace.Read.All	Les arbeidsområdene brukeren har tilgang til.

4. Velg Legg til tillatelser.

5. (Valgfritt) Hvis leietakeren din krever administratorsamtykke for disse tillatelsene, velg Gi administratorsamtykke. Ellers blir brukerne bedt om å samtykke første gang de logger inn fra MCP-klienten.

Trinn 4: Registrer den eksterne Power BI MCP-serveren i MCP-klienten

Bruk Application (klient) ID fra steg 1 som OAuth-klient-ID når du legger til den eksterne Power BI MCP-serveren til klienten din. De nøyaktige konfigurasjonstrinnene avhenger av klienten.

Hvis innlogging mislykkes, verifiser at:

• Omdirigerings-URI-en i entra-appen din samsvarer nøyaktig med den klienten forventer.
• De nødvendige delegerte Power BI-tillatelsene gis (og administreres hvis det kreves av leietakeren din).
• Leietakerinnstillingen "Users can use the Power BI Model Context Protocol server endpoint (preview)" er aktivert.

Claude Desktop

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

2. Angi følgende verdier:

   • Navn: Power BI
   • Fjern MCP-server-URL:https://api.fabric.microsoft.com/v1/mcp/powerbi
   • 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.

ChatGPT

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

2. Fyll ut Ny App-dialogen :

   • Navn: Power BI
   • MCP Server URL:https://api.fabric.microsoft.com/v1/mcp/powerbi
   • 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.

Andre MCP-klienter

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

Test tilkoblingen

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 Power BI MCP-serveren, for eksempel: «Hvilke tabeller finnes i den semantiske modellen [ID til den semantiske modellen]?»
3. Bekreft at klienten returnerer resultater fra din Power BI-semantiske modell.

Relatert innhold

• Kom i gang med den eksterne Power BI MCP-serveren
• Registrer en søknad hos Microsofts identitetsplattform
• Model Context Protocol-spesifikasjonen