Rekisteröi etä-Power BI MCP -palvelin ulkoisille MCP-asiakkaille (esikatselu)

Etä-Power BI MCP -palvelin toimii alusta alkaen MCP-asiakkaiden kanssa, jotka toimitetaan esirekisteröidyn Microsoft Entra -sovelluksen, kuten Visual Studio Code ja GitHub Copilot CLI:n kanssa. Muut MCP-asiakkaat – kuten Claude Desktop ja ChatGPT – vaativat OAuth Client ID:n rekisteröinnin. Microsoft Entra ID ei tällä hetkellä tue asiakasrekisteröintiä, joten nämä asiakkaat eivät voi automaattisesti hankkia asiakas-ID:tä Power BI MCP -palvelimelle.

Tämän kiertämiseksi rekisteröit itse Microsoft Entra -sovelluksen ja annat sen sovelluksen (asiakas) tunnuksen MCP-asiakkaalle OAuth-asiakastunnuksena.

Tässä artikkelissa opit:

• Luo ja konfiguroi Microsoft Entra -sovelluksen rekisteröinti ulkoiselle MCP-asiakasohjelmalle
• Rekisteröi etä-Power BI MCP -palvelin ulkoisessa asiakkaassa käyttäen Entra-sovellus-ID:tä

Edellytykset

Varmista ennen aloittamista, että sinulla on:

• Administrator approval - Power BI-ylläpitäjäsi on otettava käyttöön tenant-asetus: Käyttäjät voivat käyttää Power BI Model Context Protocol -palvelimen päätepistettä (preview).
• Käyttöoikeudet sovelluksen rekisteröintiin - Voit joko rekisteröidä sovellukset Microsoft Entra vuokralaiseen tai tehdä yhteistyötä vuokralaisen ylläpitäjän 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 uudelleenohjaus-URI. 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ä asiakkaan dokumentoimaa OAuth-callback-URL-osoitetta

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.

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

Etä-Power BI MCP -palvelin kutsuu Power BI REST -rajapintoja kirjautuneen käyttäjän puolesta. Myönnä seuraavat delegoidut oikeudet Power BI Service API:lle.

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

2. Valitse Power BI ServiceMicrosoft API:ssa.

3. Valitse delegoidut oikeudet ja lisää seuraavat oikeudet:

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

   Käyttöalue	Description
   Dataset.Read.All	Lue kaikki semanttiset mallit, joihin käyttäjä pääsee käsiksi.
   MLModel.Execute.All	Mahdollistaa koneoppimismallien suorittamisen.
   Workspace.Read.All	Lue käyttäjä pääsee käsiksi työtiloihin.

4. Valitse Lisää käyttöoikeudet.

5. (Valinnainen) Jos vuokralaisesi tarvitsee ylläpitäjän suostumus näihin oikeuksiin, valitse Myönnä ylläpitäjän suostumus. Muussa tapauksessa käyttäjiä pyydetään antamaan suostumus ensimmäisellä kirjautumiskerralla MCP-asiakkaasta.

Vaihe 4: Rekisteröi etä-Power BI MCP -palvelin MCP-asiakkaaseen

Käytä Application (client) ID vaiheesta 1 OAuth-asiakastunnuksena, kun lisäät etäpalvelimen Power BI MCP-palvelimen asiakkaaseen. Tarkat konfigurointivaiheet riippuvat asiakkaasta.

Jos kirjautuminen epäonnistuu, varmista, että:

• Entra-sovelluksesi uudelleenohjaus-URI vastaa täsmälleen asiakkaan odotusta.
• Vaaditut delegoidut Power BI -oikeudet myönnetään (ja vuokralaisen vaatiessa ylläpitäjän suostumuksella).
• Tenant-asetus "Users can use the Power BI Model Context Protocol server endpoint (preview)" on käytössä.

Claude Desktop

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

2. Syötä seuraavat arvot:

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

ChatGPT

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

2. Täytä Uusi sovellus -valinta:

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

Muut MCP-asiakkaat

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

Testaa yhteyttäsi

Kun olet rekisteröinyt palvelimen asiakkaaseen, varmista asetus:

1. Aloita uusi keskustelu MCP-asiakkaassasi.
2. Kysy kysymys, joka vaatii Power BI MCP -palvelimen, esimerkiksi: "Mitä taulukoita ovat semanttisessa mallissa [semanttisen mallin ID]?".
3. Varmista, että asiakas palauttaa tulokset Power BI-semanttisesta mallistasi.

Liittyvä sisältö

• Aloita etä-Power BI MCP -palvelimen käyttö
• Rekisteröi hakemus Microsoftin käyttäjätietoympäristö
• Mallikontekstiprotokollan määritys