Isännöityjen Power BI MCP -palvelinten rekisteröinti ulkoisilla MCP-asiakkailla (esikatselu)

Isännöidyt Power BI MCP -palvelimet toimivat MCP-asiakkaiden kanssa, jotka lähettävät valmiiksi Microsoft Entra sovelluksella, kuten Visual Studio Code ja GitHub Copilot CLI:llä. Muut MCP-asiakkaat, kuten Claude Desktop ja ChatGPT, tarvitsevat OAuth-asiakastunnuksen. Microsoft Entra ID ei tällä hetkellä tue dynaamista asiakasrekisteröintiä, joten nämä asiakkaat eivät saa asiakastunnusta itse.

Jos haluat kiertää tämän rajoituksen, rekisteröi Microsoft Entra sovellus itse ja anna sovelluksen (asiakkaan) tunnus MCP-asiakkaalle OAuth-asiakastunnuksena.

Seuraavassa taulukossa on esitetty kaksi isännöityä palvelinta ja niiden päätepisteet:

Palvelin Päätepiste
Power BI MCP-palvelimen luominen https://api.fabric.microsoft.com/v1/mcp/powerbi/authoring
Power BI Consumption MCP -palvelin https://api.fabric.microsoft.com/v1/mcp/powerbi

Tässä artikkelissa opit:

  • Luo ja määritä Microsoft Entra sovelluksen rekisteröinti ulkoiselle MCP-asiakkaalle.
  • Rekisteröi isännöity Power BI MCP -palvelin ulkoisessa asiakasohjelmassa Microsoft Entra-sovellustunnuksella.

Edellytykset

  • Järjestelmänvalvojan hyväksyntä. Power BI järjestelmänvalvojan on otettava vuokraaja-asetus käyttöön. Käyttäjät voivat käyttää Power BI Mallin kontekstiprotokolla -palvelimen päätepistettä (esikatselu).
  • Oikeudet rekisteröidä sovellus. Voit joko rekisteröidä sovelluksia Microsoft Entra -vuokraajassa tai työskennellä vuokraajan järjestelmänvalvojan kanssa, joka voi rekisteröidä sovelluksen puolestasi.

Vaihe 1: Luo Microsoft Entra -sovelluksen rekisteröinti

Luo uusi sovellusrekisteröinti samaan Microsoft Entra -vuokralaiseen, joka isännöi Power BI-ympäristöäsi.

  1. Kirjaudu Microsoft Entra -hallintakeskus käyttäjänä, joka voi rekisteröidä sovelluksia.
  2. Mene App registrations ja valitse sitten Uusi rekisteröinti.
  3. Syötä merkityksellinen nimi, esimerkiksi Power BI MCP - Claude Desktop.
  4. Tuetut tilityypit -kohdasta valitse Tilit vain tästä organisaatiohakemistosta (Yksittäinen vuokralainen).
  5. Jätä Redirect URI tyhjäksi toistaiseksi. Seuraavassa vaiheessa konfiguroit sen.
  6. Valitse Rekisteröi.
  7. Kopioi sovelluksen Yleiskatsaussivullasovelluksen (asiakas) tunnus. Käytät sitä myöhemmin, kun konfiguroit MCP-asiakasohjelman.

Vaihe 2: Uudelleenohjauksen URI:n määrittäminen

Ulkoiset MCP-asiakkaat toimivat julkisina asiakkaina, joten sinun täytyy lisätä uudelleenohjaus-URI, jonka tyyppi on Julkinen asiakas/natiivi (mobiili ja työpöytä).

  1. Sovelluksen rekisteröinnissä valitse Authentication>Add Redirect URI>Mobile ja työpöytäsovellukset.

  2. Lisää MCP-asiakkaasi tarjoama uudelleenohjauksen URI-osoite. Esimerkkejä:

    MCP-asiakas Uudelleenohjauksen URI-osoite
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Muut asiakkaat Käytä OAuth-takaisinkutsun URL-osoitetta, jonka asiakastiedostot
  3. Valitse Määritä tallentaaksesi alustan asetukset.

  4. Todennussivulla, Tarkennetut asetukset, varmista, että Salli julkiset asiakasvirrat on asetettu Ei:ksi, ellei asiakasdokumentaatio sitä nimenomaisesti vaadi.

  5. Valitse Tallenna.

Important

Käytä aina mcP-asiakasasiakirjojen täsmällistä uudelleenohjauksen URI-osoitetta. Yhteensopimattomuus aiheuttaa OAuth-kirjautumisen epäonnistumisen.

Vaihe 3: Lisää delegoidut Power BI API -oikeudet

Isännöidyt Power BI MCP -palvelimet kutsuvat Power BI REST-ohjelmointirajapintoja kirjautuneen käyttäjän puolesta. Myönnä skenaariosi tarvitsemat delegoidut käyttöoikeudet Power BI -palvelun ohjelmointirajapinnassa.

  1. Valitse sovelluksen rekisteröinnissä Ohjelmointirajapinnan käyttöoikeudet>Lisää käyttöoikeus.

  2. Valitse Power BI ServiceMicrosoft API:ssa.

  3. Valitse Delegoidut käyttöoikeudet ja lisää sitten rekisteröitävän palvelimen käyttöoikeudet.

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

    Käyttöalue Description Tarvitaan:
    Dataset.Read.All Lue kaikki käytettävissä olevat semanttiset mallit. Kulutuspalvelin
    MLModel.Execute.All Suorita koneoppimismalleja. Kulutuspalvelin
    Workspace.Read.All Lue työtilat, joita voit käyttää. Luonti- ja kulutuspalvelin
    SemanticModel.ReadWrite.All Lue ja kirjoita kaikki käytettävissä olevat semanttiset mallit. Luontipalvelin
  4. Valitse Lisää käyttöoikeudet.

  5. Jos vuokraajasi tarvitsee järjestelmänvalvojan suostumuksen näihin käyttöoikeuksiin, valitse Myönnä järjestelmänvalvojan suostumus. Muussa tapauksessa MCP-asiakas pyytää sinua suostumaan, kun kirjaudut sisään ensimmäisen kerran.

Vaihe 4: Rekisteröi palvelin MCP-asiakasohjelmistossa

Käytä vaiheessa 1 olevaa Sovellus (asiakas) -tunnusta OAuth-asiakastunnuksena, kun lisäät isännöityä Power BI MCP-palvelinta asiakkaaseen ja käytät haluamasi palvelimen päätepistettä. Tarkat konfigurointivaiheet riippuvat asiakkaasta.

Jos kirjautuminen epäonnistuu, varmista, että:

  • Microsoft Entra sovelluksesi uudelleenohjauksen URI-osoite vastaa tarkalleen asiakkaan odottamia.
  • Tarvittavat delegoidut Power BI käyttöoikeudet myönnetään, ja järjestelmänvalvoja antaa suostumuksen, jos vuokraaja edellyttää sitä.
  • Vuokraaja-asetus Käyttäjät voivat käyttää Power BI Mallin kontekstiprotokollapalvelimen päätepiste (esikatselu) on käytössä.

Power BI MCP -palvelimen rekisteröinti Claude Desktopissa

  1. Avaa Claude Desktop ja mene sitten Settings>Connectors>Lisää mukautettu liitin.

  2. Syötä seuraavat arvot:

    • Nimi: Power BI
    • MCP-etäpalvelimen URL-osoite: sen palvelimen päätepiste, jonka haluat rekisteröidä.
    • OAuth Client ID: sovelluksen (asiakas) ID vaiheesta 1.
  3. Säästä liitin. Claude Desktop avaa selainikkunan, jotta voit kirjautua sisään Microsoft Entra -tililläsi ja suostua pyydetyihin Power BI -oikeuksiin.

Power BI MCP -palvelimen rekisteröinti ChatGPT:ssä

  1. ChatGPT:ssä mene Asetukset>Sovellukset>Luo sovellus.

  2. Täytä Uusi sovellus -valinta:

    • Nimi: Power BI
    • MCP-palvelimen URL: sen palvelimen päätepiste, jonka haluat rekisteröidä.
    • Todennus: Valitse OAuth.
  3. Laajenna Lisäasetukset tarkastellaksesi löydetyt OAuth-asetukset ja määritä sitten:

    • Rekisteröintitapa: ValitseUser-Defined OAuth-asiakas.
    • OAuth Client ID: Syötä sovelluksen (asiakas) ID vaiheesta 1.
  4. Valitse Luo. ChatGPT kehottaa sinua kirjautumaan sisään Microsoft Entra-tililläsi ja suostumaan pyydetyihin Power BI-oikeuksiin.

Power BI MCP -palvelimen rekisteröinti muissa MCP-asiakasohjelmissa

Muiden MCP-asiakkaiden kohdalla seuraa asiakkaan dokumentaatiota ja lisää etä-MCP-palvelin.

Power BI MCP -palvelinyhteyden testaaminen

Kun olet rekisteröinyt palvelimen asiakkaaseen, varmista asetus:

  1. Aloita uusi keskustelu MCP-asiakkaassasi.
  2. Esitä kysymys, joka edellyttää palvelinta. Jos kyseessä on kulutuspalvelin, kokeile What tables are in semantic model [ID of the semantic model]?. Jos kyseessä on Luontipalvelin, kokeile Connect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'.
  3. Vahvista, että asiakas palauttaa tulokset Power BI.