Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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.
- Logg inn på Microsoft Entra administrasjonssenter som en bruker som kan registrere applikasjoner.
- Gå til App registrations, og velg deretter Ny registrering.
- Skriv inn et meningsfullt navn, for eksempel
Power BI MCP - Claude Desktop. - Under Støttede kontotyper, velg Kontoer kun i denne organisasjonskatalogen (Enkelt leietaker).
- La omdirigerings-URI stå tom foreløpig. Du konfigurerer det i neste steg.
- Velg Registrer.
- 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).
I appregistreringen din, velg Autentisering>Legg til omdirigering URI>mobil- og skrivebordsapplikasjoner.
Legg til omadresserings-URI-en som MCP-klienten tilbyr. Eksempel:
MCP-klient URI-adresse for omdirigering Claude Desktop https://claude.ai/api/mcp/auth_callbackChatGPT https://chatgpt.com/connector/oauth/<random_chars>Andre klienter Bruk URL-adressen for tilbakeringing av OAuth som klientdokumentene Velg Konfigurer for å lagre plattformkonfigurasjonen.
På autentiseringssiden , under Avanserte innstillinger, bekreft at Tillat offentlige klientflyter er satt til Nei med mindre klientdokumentasjonen din eksplisitt krever det.
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.
Velg API-tillatelser>Legg til en tillatelse i appregistreringen.
Velg Power BI Service i Microsoft APIer.
Velg Delegerte tillatelser, og legg deretter til tillatelsene for serveren du registrerer.
Ressurs-URI:
https://analysis.windows.net/powerbi/apiOmfang Beskrivelse Nødvendig for Dataset.Read.AllLes alle semantiske modeller du har tilgang til. Forbruksserver MLModel.Execute.AllUtfør ML-modeller. Forbruksserver Workspace.Read.AllLes arbeidsområdene du har tilgang til. Redigerings- og forbruksserver SemanticModel.ReadWrite.AllLes og skriv alle semantiske modeller du har tilgang til. Redigeringsserver Velg Legg til tillatelser.
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
Åpne Claude Desktop, og gå deretter til Innstillinger>Koblinger>Legg til egendefinert kontakt.
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.
-
Navn:
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
I ChatGPT, gå til Innstillinger>Apper>Lag app.
Fyll ut Ny App-dialogen :
-
Navn:
Power BI - URL-adresse for MCP-server: endepunktet for serveren du vil registrere.
- Autentisering: Velg OAuth.
-
Navn:
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.
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:
- Start en ny samtale i MCP-klienten din.
- 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 redigeringsserverenConnect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'. - Bekreft at klienten returnerer resultater fra Power BI.