Introdução ao servidor MCP de Power BI remoto (versão prévia)

O servidor MCP Power BI remoto é um ponto de extremidade hospedado remotamente que permite que agentes de IA conversem com dados em modelos semânticos Power BI usando linguagem natural. Criado com base no PROTOCOLO MCP (Model Context Protocol), ele converte seus prompts em operações de Power BI – gerando consultas DAX e executando-as respeitando suas permissões e políticas de segurança.

Este artigo mostra como:

• Conectar-se ao servidor MCP remoto do Power BI no Visual Studio Code
• Conectar o GitHub Copilot aos modelos semânticos do Power BI
• Validar a conexão com consultas de teste

Pré-requisitos

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

• Aprovação do administrador – o administrador do Power BI deve habilitar a configuração de inquilino: "Os usuários podem usar o endpoint do servidor do Protocolo de Contexto de Modelo do Power BI (versão prévia)"
• Visual Studio Code - Baixar o VS Code
• GitHub Copilot - Habilitar o GitHub Copilot no VS Code
• Acesso semântico ao modelo – Criar permissões em pelo menos um modelo semântico do Power BI
• (Recomendado) Modelos - otimizadosPreparar seus modelos semânticos para IA para melhorar a qualidade da geração de consultas

Configurar no VS Code

O servidor MCP remoto do Power BI está disponível em:

https://api.fabric.microsoft.com/v1/mcp/powerbi

Instalação rápida (recomendado)

A maneira mais fácil de configurar o servidor é usando o instalador de um clique:

Isso define automaticamente o servidor MCP nas configurações do VS Code.

Instalação manual

Para configurar manualmente o servidor, adicione o seguinte ao arquivo de configuração do MCP:

{
    "servers": {
        "powerbi-remote": {
            "type": "http",
            "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
        }
    }
}

Saiba mais:Servidores MCP no VS Code

Testar a conexão

Depois de configurada, verifique se a configuração está funcionando:

1. Iniciar o servidor MCP no VS Code

   • Abrir o painel de servidores MCP
   • Verifique se o servidor MCP do Power BI é exibido como conectado

2. Abrir GitHub Copilot

   1. Iniciar a janela de bate-papo no VS Code
   2. Habilitar o modo de agente

3. Forneça sua ID de modelo semântico

   1. Obtenha sua ID de modelo semântico do serviço do Power BI (consulte Localizar sua ID de modelo semântico)
   2. Compartilhe a ID com o Copilot em sua conversa

4. Fazer uma pergunta

   • Exemplo: "Quais tabelas estão neste modelo semântico?"
   • Exemplo: "Mostre-me os 10 principais produtos por vendas"

5. Autorizar a ferramenta

   1. Quando solicitado, permita que o Copilot use a ferramenta de servidor MCP
   2. Autenticar com suas credenciais da Microsoft, se solicitado

6. Examinar a resposta

   • Copilot consultará seu modelo e retornará resultados

Solução de problemas:Gerenciar servidores MCP no VS Code

Ferramentas disponíveis

O servidor MCP fornece as seguintes ferramentas para os agentes de IA invocarem.

Executar Consulta

Executa uma consulta DAX em um modelo semântico e retorna os resultados para o agente de IA.

Entradas necessárias:

• ID do modelo semântico
• Expressão de consulta DAX

Permissões:

• Os usuários devem ter pelo menos permissões de Build no modelo semântico
• Consultas são executadas no contexto do usuário autenticado

Considerações de segurança:

• A RLS (segurança em nível de linha) é imposta para autenticação de usuário
• Atualmente, não há suporte para RLS ao usar a autenticação de Principal de Serviço

Consulte também:Executar consultas da API REST

Obter esquema de modelo semântico

Recupera metadados abrangentes para um modelo semântico Power BI, incluindo tabelas, colunas, medidas, relações e todos os metadados otimizados para IA configurados pelo autor do modelo. Use esta ferramenta para basear a geração de consultas DAX na estrutura do modelo e destacar orientações fornecidas pelo autor que melhoram a precisão das consultas.

Entrada necessária: ID do modelo semântico

O que está incluído:

• Tabelas, colunas, medidas e relações
• Tipos de dados e hierarquias
• Metadados de ferramentas do Copilot, quando configurados, fornecem mais contexto sobre seu modelo, ajudam a orientar o Copilot para os dados corretos no modelo e contribuem para aumentar a qualidade da saída do Copilot.

Obter metadados de relatório

Recupera o esquema de alto nível de um relatório Power BI, incluindo informações de workspace, detalhes semânticos do modelo, páginas, informações visuais e filtros. Os relatórios revelam como o modelo semântico é usado na prática e podem esclarecer o contexto, as relações e a lógica de filtragem pretendidas que devem orientar a geração de consulta DAX. Use esta ferramenta para basear a geração de consultas DAX na estrutura do esquema do modelo usado no relatório e apresentar orientações fornecidas pelo autor para melhorar a precisão das consultas.

Entrada necessária: ID do relatório

O que está incluído:

• Páginas no relatório, independentemente do estado oculto
• Visuais com referências válidas ao esquema do modelo, incluindo gráficos, tabelas, matrizes, segmentadores e cartões. Elementos visuais que não representam dados, como botões de ação, formas, imagens e retângulos, são excluídos.
• Colunas e medidas ocultas quando são referenciadas em elementos visuais
• Associações visuais que mapeiam campos para funções visuais como Categoria, Valores, Legenda e Dicas de Ferramentas
• Conteúdo da caixa de texto de cada página

Limites:

• As solicitações falham quando os metadados do relatório excedem o tamanho máximo com suporte.

Gerar consulta

Gera consultas DAX otimizadas a partir de prompts de linguagem natural usando o Copilot no Power BI. A ferramenta usa o mesmo mecanismo de geração DAX que o Copilot para Power BI para criar consultas que seguem as melhores práticas.

Entradas necessárias:

• ID do modelo semântico
• Pergunta ou prompt de linguagem natural
• Contexto de esquema relevante, conforme determinado pelo agente (tabelas, colunas, medidas)

Requirements:

• Licença do Copilot para o usuário ou organização

Localizar a ID do modelo semântico

Para obter uma ID de modelo semântico do serviço do Power BI:

1. Entrar no Power BI
2. Navegue até o workspace que contém seu modelo semântico
3. Selecione o modelo semântico para abrir sua página de detalhes
4. Copiar a ID do modelo semântico da URL

As URLs de modelo semântico seguem este formato:

https://app.powerbi.com/groups/{workspaceId}/datasets/{semanticModelId}

Limitações e considerações

Autenticação e segurança

• RLS (segurança em nível de linha): Atualmente, não é aplicada ao usar a autenticação do Principal do Serviço. Quando uma entidade de serviço executa consultas, ela tem acesso a todos os dados que está autorizada a acessar. Examine cuidadosamente as implicações de segurança antes de expor agentes autenticados pela entidade de serviço aos usuários finais.
• Configurações de locatário: Os administradores devem habilitar "Os usuários podem usar o ponto de extremidade do servidor do Protocolo de Contexto do Modelo do Power BI (versão prévia)" para sua organização.

Geração de consulta

• DAX complexo: Cálculos altamente complexos ou lógica aninhada podem não se traduzir perfeitamente a partir de sugestões de linguagem natural.
• Otimização de modelo: A qualidade da geração de consulta melhora significativamente quando você prepara seus dados para IA.

Performance

• Impacto no design do modelo: O desempenho da execução da consulta depende do design, do tamanho e da otimização do modelo semântico.
• Esquemas grandes: Modelos com centenas de tabelas ou milhares de colunas podem resultar em grandes cargas de esquema.
• Complexidade da consulta: Consultas DAX complexas podem levar mais tempo para serem geradas e executadas.

Contexto e diálogo

• Limites da janela de contexto: Há limites para a quantidade de contexto que pode ser mantida entre as rodadas de conversa, dependendo do modelo de IA usado pelo cliente MCP.
• Consultas sem estado: Cada consulta é executada de forma independente. O servidor não mantém o estado de consulta entre solicitações.

Conteúdo relacionado

• O que são os servidores MCP do Power BI?
• Servidor MCP de modelagem do Power BI no GitHub
• Preparar seus dados para IA
• Servidores MCP no VS Code
• APIs REST do Power BI
• Referência do DAX
• Especificação do Protocolo de Contexto do Modelo