Registar o servidor remoto Power BI MCP com clientes MCP externos (pré-visualização)

O servidor remoto Power BI MCP funciona logo de uso com clientes MCP que vêm com uma aplicação Microsoft Entra pré-registada, como o Visual Studio Code e o GitHub Copilot CLI. Outros clientes MCP – como o Claude Desktop e o ChatGPT – exigem o registo de um ID de Cliente OAuth. O Microsoft Entra ID atualmente não suporta registo de clientes, por isso estes clientes não podem obter automaticamente um ID de cliente para o servidor Power BI MCP.

Para contornar isto, regista uma aplicação Microsoft Entra por si próprio e fornece o seu ID de aplicação (cliente) ao cliente MCP como o ID de cliente OAuth.

Este artigo mostra-lhe como:

  • Crie e configure um registo de uma aplicação Microsoft Entra para um cliente MCP externo
  • Registe o servidor remoto Power BI MCP no cliente externo usando o ID da aplicação Entra

Prerequisites

Antes de começar, certifique-se de que tem:

  • Aprovação do administrador - O seu administrador Power BI deve ativar a definição de inquilino: Os utilizadores podem usar o endpoint do servidor do Power BI Model Context Protocol (pré-visualização).
  • Permissões para registar uma aplicação - Pode registar aplicações no seu inquilino Microsoft Entra ou trabalhar com um administrador de inquilinos que pode registar a aplicação por si.

Passo 1: Criar um registo numa aplicação Microsoft Entra

Crie um novo registo de aplicação no mesmo tenant Microsoft Entra que aloja o seu ambiente Power BI.

  1. Iniciar sessão no centro de administração Microsoft Entra como utilizador que pode registar aplicações.
  2. Vai a Registos de aplicações e depois seleciona Novo registo.
  3. Insira um nome com significado, por exemplo Power BI MCP - Claude Desktop.
  4. Em Tipos de Conta Suportados, selecione Contas apenas neste diretório organizacional (Inquilino único).
  5. Deixa o URI de Redirecionamento vazio por agora. Configura-o no passo seguinte.
  6. Selecione Register.
  7. Na página de Visão Geral da aplicação, copie o ID da Aplicação (cliente). Usa-o mais tarde, quando configuras o cliente MCP.

Etapa 2: Configurar o URI de redirecionamento

Os clientes MCP externos atuam como clientes públicos, por isso deve adicionar um URI de redirecionamento do tipo Cliente Público/nativo (móvel e desktop).

  1. No registo da sua aplicação, selecione Autenticação>Adicionar Redirecionar URI>Aplicações móveis e desktop.

  2. Adicione o URI de redirecionamento fornecido pelo seu cliente MCP. Por exemplo:

    Cliente MCP Redirecionar URL
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Outros clientes Utilize o URL de callback OAuth documentado pelo cliente

  3. Selecione Configurar para guardar a configuração da plataforma.

  4. Na página de Autenticação , em Definições Avançadas, confirme que Permitir fluxos públicos de cliente está definido como Não , a menos que a documentação do seu cliente o exija explicitamente.

  5. Selecione Guardar.

Importante

Use sempre o URI de redirecionamento exato documentado pelo seu cliente MCP. Uma incompatibilidade leva à falha do início de sessão OAuth.

Passo 3: Adicionar permissões delegadas da API Power BI

O servidor MCP remoto do Power BI invoca as APIs REST do Power BI em nome do utilizador com sessão iniciada. Conceda as seguintes permissões delegadas na API do Power BI Service.

  1. No registo da sua aplicação, selecione permissões API Adicionar>uma permissão.

  2. Selecione Power BI Service em APIs da Microsoft.

  3. Selecione permissões Delegadas e depois adicione as seguintes permissões:

    URI de Recursos: https://analysis.windows.net/powerbi/api

    Scope Description
    Dataset.Read.All Leia todos os modelos semânticos a que o utilizador possa aceder.
    MLModel.Execute.All Permite executar modelos de ML.
    Workspace.Read.All Leia os espaços de trabalho a que o utilizador pode aceder.

  4. Selecione Adicionar permissões.

  5. (Opcional) Se o seu inquilino exigir consentimento de administrador para estas permissões, selecione Conceder consentimento de administrador. Caso contrário, os utilizadores são convidados a consentir na primeira vez que iniciam sessão a partir do cliente MCP.

Passo 4: Registar o servidor remoto Power BI MCP no cliente MCP

Use o ID Application (cliente) do passo 1 como ID de cliente OAuth quando adicionar o servidor remoto Power BI MCP ao seu cliente. Os passos exatos de configuração dependem do cliente.

Se o início de sessão falhar, verifique se:

  • O URI de redirecionamento na tua aplicação Entra corresponde exatamente ao esperado pelo cliente.
  • As permissões delegadas necessárias do Power BI foram concedidas (e foi dado o consentimento do administrador, se exigido pelo seu tenant).
  • A definição de tenant "Utilizadores podem usar o endpoint do servidor do Power BI Model Model Context Protocol (pré-visualização)" está ativada.

Claude Desktop

  1. Abra o Claude Desktop e, em seguida, vá a Definições>Conectores>Adicionar conector personalizado.

  2. Insira os seguintes valores:

    • Nome: Power BI
    • URL remoto do servidor MCP: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • OAuth Client ID: o ID da Aplicação (cliente) do passo 1.

  3. Guarda o conector. O Claude Desktop abre uma janela do navegador para que possa iniciar sessão com a sua conta Microsoft Entra e consentir as permissões Power BI solicitadas.

ChatGPT

  1. No ChatGPT, vai a Definições>Apps>Criar App.

  2. Preencha o diálogo de Nova Aplicação :

    • Nome: Power BI
    • URL do servidor MCP: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Autenticação: Selecione OAuth.

  3. Expanda as definições avançadas para rever as definições de OAuth descobertas e depois configure:

    • Método de registo: Selecione Cliente OAuth definido pelo utilizador.
    • ID de Cliente OAuth: Insira o ID da Aplicação (cliente) a partir do passo 1.

  4. Selecione Criar. O ChatGPT pede que faça login com a sua conta Microsoft Entra e consinta com as permissões Power BI solicitadas.

Outros clientes MCP

Para outros clientes MCP, siga a documentação do cliente para adicionar um servidor MCP remoto.

Teste a sua ligação

Depois de registar o servidor no cliente, valide a configuração:

  1. Inicia uma nova conversa com o teu cliente MCP.
  2. Faça uma pergunta que exija o servidor MCP do Power BI, por exemplo: "Que tabelas estão no modelo semântico [ID do modelo semântico]?".
  3. Confirme que o cliente devolve os resultados do seu modelo semântico do Power BI.

Conteúdo relacionado

  • Last updated on