Registrare i server MCP ospitati Power BI con client MCP esterni (anteprima)

I server MCP ospitati di Power BI sono compatibili con i client MCP che includono un'applicazione Microsoft Entra preregistrata, ad esempio Visual Studio Code e GitHub Copilot CLI. Altri client MCP, ad esempio Claude Desktop e ChatGPT, richiedono un ID client OAuth. Microsoft Entra ID attualmente non supporta la registrazione client dinamica, quindi questi client non possono ottenere un ID client autonomamente.

Per ovviare a questa limitazione, registrare manualmente un'app Microsoft Entra e assegnare il relativo ID applicazione (client) al client MCP come ID client OAuth.

La tabella seguente illustra i due server ospitati e i relativi endpoint:

Questo articolo illustra come:

• Creare e configurare una registrazione dell'app Microsoft Entra per un client MCP esterno.
• Registrare un server MCP di Power BI ospitato nel client esterno usando l'ID app di Microsoft Entra.

Prerequisiti

• Approvazione dell'amministratore. L'amministratore Power BI deve abilitare l'impostazione del tenant Gli utenti possono usare l'endpoint server Power BI Model Context Protocol (anteprima).
• Autorizzazioni per registrare un'app. È possibile registrare le app nel tenant Microsoft Entra oppure collaborare con un amministratore tenant che può registrare l'app.

Passaggio 1: Creare una registrazione dell'app Microsoft Entra

Creare una nuova registrazione dell'app nello stesso tenant Microsoft Entra che ospita l'ambiente Power BI.

1. Accedere al Interfaccia di amministrazione di Microsoft Entra come utente che può registrare le applicazioni.
2. Passare a Registrazioni app e quindi selezionare Nuova registrazione.
3. Immettere un nome significativo, ad esempio Power BI MCP - Claude Desktop.
4. In Tipi di account supportati selezionare Account solo in questa directory organizzativa (tenant singolo).
5. Lasciare vuoto l'URI di reindirizzamento per il momento. Lo configuri nel passaggio successivo.
6. Selezionare Registrazione.
7. Nella pagina Panoramica dell'app, copia l'ID applicazione (client). Verrà usato in un secondo momento quando si configura il client MCP.

Passaggio 2: Configurare l'URI di reindirizzamento

I client MCP esterni fungono da client pubblici, pertanto è necessario aggiungere un URI di reindirizzamento di tipo Client pubblico/nativo (mobile e desktop).

1. Nella registrazione dell'app selezionare Autenticazione>Aggiungi URI> di reindirizzamentoApplicazioni per dispositivi mobili e desktop.

2. Aggiungere l'URI di reindirizzamento fornito dal client MCP. Per esempio:

   Client MCP	URI di reindirizzamento
   Claude Desktop	https://claude.ai/api/mcp/auth_callback
   ChatGPT	https://chatgpt.com/connector/oauth/<random_chars>
   Altri clienti	Utilizza l'URL di callback OAuth documentato dal client

3. Selezionare Configura per salvare la configurazione della piattaforma.

4. Nella pagina Autenticazione, in Impostazioni avanzate, verificare che l'opzioneConsenti flussi client pubblici sia impostata su No, a meno che la documentazione client non lo richieda in modo esplicito.

5. Seleziona Salva.

Passaggio 3: Aggiungere autorizzazioni delegate per l'API di Power BI

I server MCP Power BI ospitati chiamano le API REST Power BI per conto dell'utente connesso. Concedere le autorizzazioni delegate necessarie per lo scenario nell'API del servizio Power BI.

1. Nella registrazione dell'app selezionare Autorizzazioni> APIAggiungi un'autorizzazione.

2. Selezionare Power BI Service in Microsoft API.

3. Selezionare Autorizzazioni delegate e quindi aggiungere le autorizzazioni per il server che si sta registrando.

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

   Scope	Description	Necessario per
   Dataset.Read.All	Leggere tutti i modelli semantici a cui è possibile accedere.	Server di consumo
   MLModel.Execute.All	Eseguire modelli di Machine Learning.	Server di fruizione
   Workspace.Read.All	Leggere le aree di lavoro a cui è possibile accedere.	Server di authoring e di fruizione
   SemanticModel.ReadWrite.All	Leggere e scrivere tutti i modelli semantici a cui è possibile accedere.	Server di creazione

4. Seleziona Aggiungi autorizzazioni.

5. Se il tenant richiede il consenso amministratore per queste autorizzazioni, selezionare Concedi consenso amministratore. In caso contrario, il client MCP chiede di fornire il consenso la prima volta che si esegue l'accesso.

Passaggio 4: Registrare il server nel client MCP

Usa l'ID applicazione (client) indicato nel passaggio 1 come ID client di OAuth quando aggiungi al client un server MCP Power BI ospitato e usa l'endpoint del server che vuoi utilizzare. I passaggi di configurazione esatti dipendono dal client.

Se l'accesso non riesce, verificare che:

• L'URI di reindirizzamento nell'app Microsoft Entra corrisponde esattamente a quello previsto dal client.
• Le autorizzazioni di Power BI delegate necessarie vengono concesse e l'amministratore acconsente se il tenant lo richiede.
• L'impostazione del tenant Gli utenti possono usare l'endpoint del server Power BI Model Context Protocol (anteprima) è abilitata.

Registrare un server MCP Power BI in Claude Desktop

1. Aprire Claude Desktop e quindi passare a Impostazioni>Connettori>Aggiungi connettore personalizzato.

2. Immettere i valori seguenti:

   • Nome: Power BI
   • URL del server MCP remoto: l'endpoint per il server da registrare.
   • ID client di OAuth: ID applicazione (client) del passaggio 1.

3. Salva il connettore. Claude Desktop apre una finestra del browser in modo che sia possibile accedere con l'account Microsoft Entra e fornire il consenso alle autorizzazioni di Power BI richieste.

Registrare un server MCP Power BI in ChatGPT

1. In ChatGPT passare a Impostazioni>App>crea app.

2. Compilare la finestra di dialogo Nuova app :

   • Nome: Power BI
   • URL del server MCP: l'endpoint del server che vuoi registrare.
   • Autenticazione: selezionare OAuth.

3. Espandere Impostazioni avanzate per esaminare le impostazioni OAuth individuate e quindi configurare:

   • Metodo di registrazione: selezionare User-Defined client OAuth.
   • ID client OAuth: immettere l'ID applicazione (client) del passaggio 1.

4. Fare clic su Crea. ChatGPT richiede di accedere con l'account Microsoft Entra e di fornire il consenso alle autorizzazioni Power BI richieste.

Registrare un server MCP di Power BI in altri client MCP

Per altri client MCP, seguire la documentazione del client per aggiungere un server MCP remoto.

Testare la connessione al server MCP Power BI

Dopo aver registrato il server nel client, convalidare l'installazione:

1. Avviare una nuova conversazione nel client MCP.
2. Porre una domanda che richiede il server. Per il server a consumo, provare What tables are in semantic model [ID of the semantic model]?. Per il server di authoring, provare con Connect to semantic model '[Semantic Model Name]' in Fabric Workspace '[Workspace Name]'.
3. Verificare che il client restituisca i risultati di Power BI.

Contenuti correlati

• Server MCP per Power BI
• Server MCP di creazione di Power BI
• Introduzione al server MCP Power BI Consumption
• Registrare un'applicazione con Microsoft Identity Platform
• Specifica del protocollo del contesto del modello