Registrar o servidor MCP Power BI remoto com clientes MCP externos (versão prévia)

O servidor MCP remoto do Power BI funciona imediatamente com clientes MCP que já vêm com um aplicativo pré-registrado do Microsoft Entra, como o Visual Studio Code e a CLI do GitHub Copilot. Outros clientes MCP , como Claude Desktop e ChatGPT , exigem o registro de uma ID do cliente OAuth. Microsoft Entra ID atualmente não dá suporte ao registro do cliente, portanto, esses clientes não podem obter automaticamente uma ID do cliente para o servidor MCP Power BI.

Para contornar isso, registre um aplicativo Microsoft Entra por conta própria e forneça sua ID de aplicativo (cliente) ao cliente MCP como a ID do cliente OAuth.

Este artigo mostra como:

  • Criar e configurar um registro de aplicativo Microsoft Entra para um cliente MCP externo
  • Registrar o servidor MCP Power BI remoto no cliente externo usando a ID do aplicativo Entra

Prerequisites

Antes de começar, verifique se você tem:

  • Aprovação do administrador - O administrador do Power BI deve habilitar a configuração do locatário: Os usuários podem usar o ponto de extremidade do servidor do Model Context Protocol do Power BI (versão prévia).
  • Permissões para registrar um aplicativo – você pode registrar aplicativos em seu locatário Microsoft Entra ou trabalhar com um administrador de locatário que possa registrar o aplicativo para você.

Etapa 1: Criar um registro de aplicativo do Microsoft Entra

Crie um novo registro de aplicativo no mesmo locatário Microsoft Entra que hospeda seu ambiente de Power BI.

  1. Entre no centro de administração do Microsoft Entra como um usuário que possa registrar aplicativos.
  2. Vá para Registros de aplicativo e, em seguida, selecione Novo registro.
  3. Insira um nome significativo, por exemplo, Power BI MCP - Claude Desktop.
  4. Em Tipos de conta com suporte, selecione Contas apenas neste diretório organizacional (locatário único).
  5. Deixe o URI de Redirecionamento vazio por enquanto. Configure-o na próxima etapa.
  6. Selecione Registrar.
  7. Na página Visão geral do aplicativo, copie a ID do aplicativo (cliente). Você o usará mais tarde quando configurar o cliente MCP.

Etapa 2: Configurar o URI de redirecionamento

Clientes MCP externos atuam como clientes públicos, portanto, você deve adicionar um URI de redirecionamento do tipo cliente público/nativo (mobile &desktop).

  1. No registro do aplicativo, selecione Autenticação>Adicionar URI de redirecionamento>Aplicativos móveis e de área de trabalho.

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

    Cliente MCP URI de redirecionamento
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Outros clientes Usar a URL de retorno de chamada OAuth documentada pelo cliente

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

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

  5. Selecione Salvar.

Importante

Sempre use o URI de redirecionamento exato documentado pelo cliente MCP. Uma incompatibilidade faz com que a entrada do OAuth falhe.

Etapa 3: Adicionar permissões de API do Power BI delegadas

O servidor MCP Power BI remoto chama as APIs REST Power BI em nome do usuário conectado. Conceda as seguintes permissões delegadas na API Power BI Service.

  1. No registro do aplicativo, selecione permissões> de APIAdicionar uma permissão.

  2. Selecione Power BI Service em Microsoft APIs.

  3. Selecione permissões delegadas e adicione as seguintes permissões:

    URI do recurso: https://analysis.windows.net/powerbi/api

    Scope Descrição
    Dataset.Read.All Leia todos os modelos semânticos que o usuário pode acessar.
    MLModel.Execute.All Permite a execução de modelos de ML.
    Workspace.Read.All Visualize os espaços de trabalho que o usuário pode acessar.

  4. Selecione Adicionar permissões.

  5. (Opcional) Se o locatário exigir consentimento do administrador para essas permissões, selecione Conceder consentimento do administrador. Caso contrário, os usuários serão solicitados a consentir na primeira vez que entrarem do cliente MCP.

Etapa 4: Registrar o servidor MCP do Power BI remoto no cliente MCP

Use o ID do aplicativo (cliente) da etapa 1 como o ID do cliente OAuth ao adicionar o servidor MCP remoto do Power BI ao seu cliente. As etapas exatas de configuração dependem do cliente.

Se não for possível entrar, verifique se:

  • O URI de redirecionamento em seu aplicativo Entra corresponde exatamente ao esperado pelo cliente.
  • As permissões de Power BI delegadas necessárias são concedidas (e consentidas pelo administrador, se exigido pelo locatário).
  • A configuração de locatário "Os usuários podem usar o endpoint do servidor do Protocolo de Contexto de Modelo do Power BI (versão prévia)" está habilitada.

Claude Desktop

  1. Abra o Claude Desktop e depois vá para Configurações>Conectores>Adicionar conector personalizado.

  2. Insira os valores a seguir:

    • Nome: Power BI
    • URL do servidor MCP remoto: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • ID do cliente OAuth: a ID do aplicativo (cliente) da etapa 1.

  3. Salve o conector. O Claude Desktop abre uma janela do navegador para que você possa entrar com sua conta Microsoft Entra e consentir com as permissões de Power BI solicitadas.

ChatGPT

  1. No ChatGPT, vá para Configurações>aplicativos>criar aplicativo.

  2. Preencha a caixa de diálogo Novo Aplicativo :

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

  3. Expanda as configurações avançadas para examinar as configurações do OAuth descobertas e, em seguida, defina:

    • Método de registro: selecione Cliente OAuth definido pelo usuário.
    • ID do cliente OAuth: insira a ID do aplicativo (cliente) da etapa 1.

  4. Selecione Criar. O ChatGPT solicita que você entre com sua conta Microsoft Entra e consenta com as permissões de Power BI solicitadas.

Outros clientes MCP

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

Testar a conexão

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

  1. Inicie uma nova conversa em seu cliente MCP.
  2. Faça uma pergunta que exija o servidor MCP Power BI, por exemplo: "Quais tabelas estão no modelo semântico [ID do modelo semântico]?".
  3. Confirme se o cliente retorna resultados de seu modelo semântico Power BI.

Conteúdo relacionado

  • Last updated on