Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O servidor MCP para consumo do Power BI é um endpoint hospedado remotamente no qual agentes de IA interagem com dados em modelos semânticos do 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.
Para criar ou alterar modelos semânticos em vez de consultá-los, consulte servidor MCP de criação do Power BI.
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
Importante
Para consumir modelos semânticos, prefira usar o servidor MCP do Fabric IQ. Fabric IQ é o principal servidor MCP para levar dados empresariais confiáveis e contexto de modelos semânticos e relatórios do Power BI para clientes de IA. Este artigo aborda o ponto de extremidade de consumo do MCP Power BI anterior, que está em versão prévia.
Pré-requisitos
- 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:
Esse instalador define automaticamente o servidor MCP nas configurações do VS Code.
Instalação manual
Para configurar manualmente o servidor, adicione o seguinte código 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 sua conexão de servidor MCP Power BI
Após a configuração, verifique se a configuração funciona:
Iniciar o servidor MCP no VS Code
- Abrir o painel de servidores MCP
- Verifique se o servidor MCP do Power BI é exibido como conectado
Abrir GitHub Copilot
- Iniciar a janela de bate-papo no VS Code
- Habilitar o modo de agente
Forneça sua ID de modelo semântico
- Obtenha sua ID de modelo semântico do serviço do Power BI (consulte Localizar sua ID de modelo semântico)
- Compartilhe a ID com o Copilot em sua conversa
Fazer uma pergunta
- Exemplo: "Quais tabelas estão neste modelo semântico?"
- Exemplo: "Mostre-me os 10 principais produtos por vendas"
Autorizar a ferramenta
- Quando solicitado, permita que o Copilot use a ferramenta de servidor MCP
- Autenticar com suas credenciais da Microsoft, se solicitado
Examinar a resposta
- Copilot consulta seu modelo e retorna resultados
Dica
Para obter melhores resultados de consulta, prepare seus modelos semânticos para IA adicionando instruções de IA e respostas verificadas.
Solução de problemas:Gerenciar servidores MCP no VS Code
Ferramentas de servidor MCP Power BI disponíveis
O servidor MCP Power BI remoto fornece as seguintes ferramentas para os agentes de IA invocarem: Executar Consulta, Obter Esquema de Modelo Semântico, Obter Metadados de Relatório e Gerar Consulta. As seções a seguir descrevem cada ferramenta.
Ferramenta de execução de consulta
A ferramenta Executar Consulta executa uma consulta DAX em um modelo semântico Power BI e retorna os resultados para o agente de IA.
Entradas necessárias:
- ID do modelo semântico
- Expressão de consulta DAX
Permissões:
- Você deve ter pelo menos as permissões de compilação 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) se aplica à autenticação do usuário
- Atualmente, a autenticação da entidade de serviço não dá suporte ao RLS
Consulte também:Executar consultas da API REST
Obter ferramenta de esquema de modelo semântico
A ferramenta Obter Esquema de Modelo Semântico recupera metadados abrangentes para um modelo semântico Power BI, incluindo tabelas, colunas, medidas, relações e quaisquer 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 o seu modelo, ajudam a orientar o Copilot para os dados corretos no modelo e ajudam a aumentar a qualidade da saída do Copilot.
Ferramenta Obter Metadados do Relatório
A ferramenta 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 um relatório usa o modelo semântico na prática e pode 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 pelo relatório e apresentar orientações fornecidas pelo autor que melhoram 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. A ferramenta exclui visuais sem dados, como botões de ação, formas geométricas, imagens e retângulos.
- Colunas e medidas ocultas quando os visuais fazem referência a elas
- 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 ferramenta de consulta
A ferramenta Gerar Consulta usa Copilot em Power BI para criar consultas DAX otimizadas a partir de prompts de linguagem natural. 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 que o agente determina (tabelas, colunas, medidas)
Requirements:
- licença do Copilot para você ou sua organização
Note
Se você preferir não consumir a capacidade do Copilot, desabilite essa ferramenta na configuração do cliente MCP e dependa da LLM do cliente para gerar o DAX diretamente.
Localizar a ID do modelo semântico
Para obter uma ID de modelo semântico do serviço do Power BI:
- Entrar no Power BI
- Navegue até o workspace que contém seu modelo semântico
- Selecione o modelo semântico para abrir sua página de detalhes
- 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}
Dica
- Armazene IDs de modelo usadas com frequência em que seu agente pode acessá-las como um
semantic-model-ids.jsonarquivo local ou arquivos de instrução de agente. - Você também pode recuperar IDs de modelo semântico programaticamente usando a API REST Power BI.
Limitações e considerações
Autenticação e segurança
- Segurança em nível de linha (RLS): O Power BI não aplica a RLS ao usar a autenticação de entidade de serviço. Quando uma entidade de serviço executa consultas, ela pode acessar todos os dados que a entidade de serviço 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 de prompts 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: O modelo de IA que seu cliente MCP usa limita a quantidade de contexto que ele pode manter em turnos de conversa.
- Consultas sem estado: Cada consulta é executada de forma independente. O servidor não mantém o estado de consulta entre solicitações.