Registrare il server MCP Power BI remoto con client MCP esterni (anteprima)

Il server MCP remoto di Power BI funziona immediatamente con i client MCP che includono un'applicazione Microsoft Entra preregistrata, ad esempio Visual Studio Code e la CLI di GitHub Copilot. Altri client MCP, ad esempio Claude Desktop e ChatGPT , richiedono la registrazione di un ID client OAuth. Microsoft Entra ID attualmente non supporta la registrazione client, quindi questi client non possono ottenere automaticamente un ID client per il server MCP Power BI.

Per risolvere questo problema, registrare manualmente un'app Microsoft Entra e specificare il relativo ID applicazione (client) al client MCP come ID client OAuth.

Questo articolo illustra come:

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

Prerequisiti

Prima di iniziare, assicurati di avere:

  • Approvazione dell'amministratore - L'amministratore di Power BI deve abilitare l'impostazione del tenant: Gli utenti possono usare l'endpoint del server Power BI Model Context Protocol (anteprima).
  • Permissions per registrare un'app: è possibile registrare le app nel tenant Microsoft Entra oppure rivolgersi a un amministratore tenant che può registrare automaticamente 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 Usare l'URL di callback OAuth specificato nella documentazione del 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.

Importante

Usare sempre l'URI di reindirizzamento esatto documentato dal client MCP. Una mancata corrispondenza causa l'esito negativo dell'accesso OAuth.

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

Il server MCP Power BI remoto chiama le API REST Power BI per conto dell'utente connesso. Concedere le autorizzazioni delegate seguenti per l'API Power BI Service.

  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 seguenti:

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

    Scope Description
    Dataset.Read.All Leggere tutti i modelli semantici a cui l'utente può accedere.
    MLModel.Execute.All Consente l'esecuzione di modelli di Machine Learning.
    Workspace.Read.All Leggere le aree di lavoro a cui l'utente può accedere.

  4. Seleziona Aggiungi autorizzazioni.

  5. (Facoltativo) Se il tenant richiede il consenso amministratore per queste autorizzazioni, selezionare Concedi consenso amministratore. In caso contrario, agli utenti viene richiesto di fornire il consenso alla prima volta che accedono dal client MCP.

Passaggio 4: Registrare il server MCP Power BI remoto nel client MCP

Usare l'ID client Application dal passaggio 1 come ID client OAuth quando si aggiunge il server MCP Power BI remoto al client. I passaggi di configurazione esatti dipendono dal client.

Se l'accesso non riesce, verificare che:

  • L'URI di reindirizzamento nell'app Entra corrisponde esattamente a quello previsto dal client.
  • Le autorizzazioni delegate di Power BI necessarie sono concesse (e approvate dall'amministratore, se richiesto dal tenant).
  • L'impostazione del tenant "Gli utenti possono usare l'endpoint del server del protocollo di contesto del modello di Power BI (anteprima)" è abilitata.

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: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • 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.

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: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • 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.

Altri clienti MCP

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

Test della connessione

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 MCP Power BI, ad esempio: "Quali tabelle si trovano nel modello semantico [ID del modello semantico]?".
  3. Verificare che il client restituisca i risultati dal modello semantico Power BI.

Contenuti correlati

  • Last updated on