Registrer de hostede Power BI MCP-servere med eksterne MCP-klienter (prøveversion)

De hostede Power BI MCP-servere fungerer sammen med MCP-klienter, der leveres med et forudregistreret Microsoft Entra-program, f.eks. Visual Studio Code og GitHub Copilot CLI. Andre MCP-klienter, f.eks . Claude Desktop og ChatGPT, kræver et OAuth-klient-id. Microsoft Entra ID understøtter i øjeblikket ikke dynamisk klientregistrering, så disse klienter kan ikke selv få et klient-id.

Du kan løse denne begrænsning ved selv at registrere en Microsoft Entra app og give dens program-id (klient)-id til MCP-klienten som OAuth-klient-id'et.

I følgende tabel vises de to hostede servere og deres slutpunkter:

Server Slutpunkt
Power BI oprettelse af MCP-server https://api.fabric.microsoft.com/v1/mcp/powerbi/authoring
mcp-server til Power BI forbrug https://api.fabric.microsoft.com/v1/mcp/powerbi

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

  • Opret og konfigurer en Microsoft Entra appregistrering for en ekstern MCP-klient.
  • Registrer en hostet Power BI MCP-server i den eksterne klient ved hjælp af det Microsoft Entra app-id.

Forudsætninger

  • Administratorgodkendelse. Din Power BI administrator skal aktivere lejerindstillingen Brugere kan bruge slutpunktet for Power BI Model Context Protocol-server (prøveversion).
  • Tilladelser til at registrere en app. Du kan enten registrere apps i din Microsoft Entra lejer eller arbejde sammen med en lejeradministrator, der 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 mcp-klienten leverer. 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 url-adressen til OAuth-tilbagekald, 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 nøjagtige omdirigerings-URI, som mcp-klienten dokumenterer. En mismatch får OAuth-login-processen til at fejle.

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

De hostede Power BI MCP-servere kalder Power BI REST API'er på vegne af den bruger, der er logget på. Tildel de delegerede tilladelser, som dit scenarie har brug for, til api'en til Power BI-tjenesten.

  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 tilladelserne for den server, du registrerer.

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

    Omfanget Beskrivelse Nødvendig til
    Dataset.Read.All Læs alle semantiske modeller, du har adgang til. Forbrugsserver
    MLModel.Execute.All Udfør ML-modeller. Forbrugsserver
    Workspace.Read.All Læs de arbejdsområder, du har adgang til. Server til oprettelse og forbrug
    SemanticModel.ReadWrite.All Læs og skriv alle semantiske modeller, du har adgang til. Oprettelsesserver

  4. Vælg Tilføj tilladelser.

  5. Hvis din lejer kræver administratorsamtykke for disse tilladelser, skal du vælge Giv administratorsamtykke. Ellers beder MCP-klienten dig om at give dit samtykke, første gang du logger på.

Trin 4: Registrer serveren i MCP-klienten

Brug program-id'et (klient) fra trin 1 som OAuth-klient-id, når du føjer en hostet Power BI MCP-server til klienten, og brug slutpunktet for den ønskede server. De præcise konfigurationstrin afhænger af klienten.

Hvis login fejler, skal du verificere at:

  • Omdirigerings-URI'en i din Microsoft Entra app stemmer nøjagtigt overens med den, klienten forventer.
  • De påkrævede delegerede Power BI tilladelser tildeles, og administratoren giver samtykke, hvis din lejer kræver det.
  • Lejerindstillingen Brugere kan bruge det Power BI Serverslutpunkt for modelkontekstprotokol (prøveversion) er aktiveret.

Registrer en Power BI MCP-server i 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
    • URL-adresse til ekstern MCP-server: slutpunktet for den server, du vil registrere.
    • 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.

Registrer en Power BI MCP-server i ChatGPT

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

  2. Udfyld dialogen Ny App :

    • Navn: Power BI
    • URL-adresse til MCP-server: slutpunktet for den server, du vil registrere.
    • 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.

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

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

Test din Power BI MCP-serverforbindelse

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 serveren. Prøv What tables are in semantic model [ID of the semantic model]?for forbrugsserveren. Prøv Connect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'for oprettelsesserveren.
  3. Bekræft, at klienten returnerer resultater fra Power BI.

Relateret indhold

  • Sidst opdateret den