Power BI via MCP

Configurando o Claude para Controlar o Power BI via MCP

Guia para quem não tem experiência técnica em linha de comando ou programação. Substitui integralmente a recomendação anterior de não publicar conteúdo de instalação de MCP — este documento foi checado item a item contra fontes oficiais e não apresentou nenhuma divergência factual (ao contrário do Capítulo 20 do livro-fonte, que tinha caminho de configuração errado e um servidor MCP não confirmável).

Antes de começar

O que é o MCP e por que importa

Sobre segurança: o Claude não acessa os dados de negócio diretamente, só a estrutura do modelo (nomes de tabelas, medidas, relacionamentos, propriedades). Metadados, esquemas e resultados de consultas são enviados ao provedor de IA como contexto da conversa — evite incluir dados pessoais ou sigilosos nos prompts.

O que este guia instala

1. Visual Studio Code — editor gratuito, usado só para instalar uma extensão.
2. Extensão Power BI Modeling MCP — instala o servidor MCP no computador.
3. Claude Desktop — versão instalável do Claude, diferente do claude.ai.
4. Arquivo de configuração — diz ao Claude onde encontrar o servidor MCP.

Se já tem VS Code, pule para o passo 2. Se já tem Claude Desktop, pule para o passo 4.

---

Passo 1 — Instalar o Visual Studio Code

1. Acesse code.visualstudio.com.
2. Clique no botão azul "Download for Windows".
3. Execute o instalador baixado, aceite os termos.
4. Importante: na tela de opções adicionais, marque a caixa "Adicionar ao PATH (disponível após reinicialização)" — pode vir desmarcada por padrão, e é necessária para o servidor MCP funcionar depois.
5. Marque também "Registrar Code como editor para tipos de arquivo suportados", clique em "Instalar" e aguarde (~2 minutos).

Confirmação: o VS Code abre com tela de boas-vindas e barra lateral de ícones.

Passo 2 — Instalar a extensão Power BI Modeling MCP

1. No VS Code, abra o painel de Extensões (Ctrl+Shift+X).
2. Pesquise exatamente: Power BI Modeling MCP.
3. Confira o publicador: Microsoft (Analysis Services).
4. Clique em "Instalar".

Confirmação: o botão muda de "Instalar" para "Desinstalar".

Confirmado contra a Marketplace oficial: a extensão existe sob o identificador analysis-services.powerbi-modeling-mcp e é a implementação oficial da Microsoft (lançada no Ignite 2025, ainda em Public Preview — os nomes exatos das ferramentas expostas podem mudar até a versão estável).

Passo 3 — Instalar o Claude Desktop

1. Acesse claude.ai/download, clique em "Download for Windows".
2. Execute o instalador (~150 MB) e clique em "Instalar".
3. Faça login com a mesma conta do claude.ai.

O Claude Desktop e o claude.ai coexistem sem conflito — não é preciso desinstalar nada. Para uso frequente do MCP, o plano gratuito tende a esbarrar em limite de mensagens rapidamente; o plano Pro dá mais folga.

Passo 4 — Encontrar o executável do servidor MCP

1. Abra o Explorador de Arquivos (Windows + E).
2. Na barra de endereço, digite: %USERPROFILE%\.vscode\extensions e pressione Enter.
3. Procure a pasta que começa com analysis-services.powerbi-modeling-mcp-0.x.x-win32-x64 (o número de versão varia — use a pasta com esse prefixo).
4. Entre nela, depois na subpasta server.
5. Localize o arquivo powerbi-modeling-mcp.exe.

Atenção ao nome: é powerbi-modeling-mcp.exe (hífens), não powerbi_modeling_mcp.exe (underscores).

6. Clique uma vez para selecionar, botão direito → "Copiar como caminho".
7. Cole o caminho no Bloco de Notas e mantenha aberto — vai ser usado no Passo 6.

Exemplo de caminho (o seu será diferente):

"C:\Users\SeuNome\.vscode\extensions\analysis-services.powerbi-modeling-mcp-0.1.9-win32-x64\server\powerbi-modeling-mcp.exe"

Passo 5 — Abrir o arquivo de configuração do Claude Desktop

1. No Explorador de Arquivos, digite na barra de endereço: %APPDATA%\Claude e pressione Enter.
2. Procure o arquivo claude_desktop_config.json.
   • Se não existir: botão direito → Novo → Documento de Texto → renomeie para claude_desktop_config.json (com a extensão).
3. Botão direito no arquivo → "Abrir com" → Bloco de Notas.

Confirmado: este é o caminho real de configuração do Claude Desktop no Windows — diferente de outras fontes que circulam com caminhos incorretos (ex.: ~/.claude/mcp.json, que não existe).

Passo 6 — Criar o arquivo de configuração do MCP

Modelo do arquivo:

{
  "mcpServers": {
    "powerbi-modeling-mcp": {
      "command": "COLE_AQUI_O_CAMINHO_DO_EXECUTAVEL",
      "args": ["--start"],
      "type": "stdio"
    }
  }
}

1. Apague o conteúdo atual do Bloco de Notas (Ctrl+A, Delete).
2. Cole o modelo acima.
3. Substitua COLE_AQUI_O_CAMINHO_DO_EXECUTAVEL pelo caminho copiado no Passo 4.

Passo crítico — barras invertidas: no JSON, cada \ do caminho do Windows precisa virar \\. Use Localizar e Substituir (Ctrl+H): localizar \, substituir por \\, "Substituir tudo".

Exemplo correto e completo (seu caminho será diferente):

{
  "mcpServers": {
    "powerbi-modeling-mcp": {
      "command": "C:\\Users\\Paulo\\.vscode\\extensions\\analysis-services.powerbi-modeling-mcp-0.1.9-win32-x64\\server\\powerbi-modeling-mcp.exe",
      "args": ["--start"],
      "type": "stdio"
    }
  }
}

Valide o JSON em jsonlint.com antes de salvar — erros comuns são aspas faltando, vírgulas sobrando/faltando e chaves não fechadas. Esta estrutura de configuração (mcpServers → nome do servidor → type: stdio + command + args) bate com exemplos publicados independentemente por outros tutoriais sobre o mesmo servidor MCP.

Passo 7 — Salvar e reiniciar

1. No Bloco de Notas: Arquivo → Salvar (Ctrl+S), codificação UTF-8 se perguntado.
2. Confira o nome do arquivo — se aparecer claude_desktop_config.json.txt, renomeie removendo o .txt do final.
3. Reinicie o computador inteiro — não só o Claude Desktop. O servidor MCP só é reconhecido após reinicialização completa.

Passo 8 — Verificar a conexão e testar

1. Abra o Claude Desktop, faça login.
2. Procure o ícone de "martelo"/ferramentas no canto da caixa de mensagem.
3. Clique nele — deve aparecer uma lista de ferramentas com prefixo "powerbi".
4. Abra o Power BI Desktop com um arquivo .pbix já carregado.
5. Antes de qualquer pergunta, conecte com o comando (sempre em inglês): Connect to open Power BI report in desktop
6. Após a confirmação, teste: Liste todas as tabelas e medidas do modelo do Power BI que está aberto agora.

Se o Claude listar as tabelas e medidas corretas, a configuração está completa.

Se não aparecer o ícone MCP: volte ao Passo 6 e confira barras duplicadas, aspas e chaves balanceadas.

Faça backup antes de pedir alterações no modelo: o servidor está em Public Preview e pode produzir resultados inesperados — salve uma cópia do .pbix antes de pedir criação/edição de objetos.

---

Fluxo de trabalho diário (depois de configurado)

1. Abra o Power BI Desktop com o arquivo .pbix.
2. Abra o Claude Desktop.
3. Conecte: Connect to open Power BI report in desktop.
4. Descreva o que precisa, em português.
5. Revise o que o Claude sugeriu antes de aplicar.
6. Salve o arquivo no Power BI após as alterações.

Prompts de exemplo

Inspecionar o modelo:

• "Liste todas as medidas da tabela [fVendas] e me diga quais usam CALCULATE."
• "Existe alguma medida sendo usada em outra medida? Mostre as dependências."
• "Quais tabelas não têm relacionamento com nenhuma outra no modelo?"
• "Existem medidas com zero referências (não usadas em nenhuma outra medida nem visual)? Liste-as."

Criar medidas:

• "Crie uma medida de Ticket Médio dividindo Total de Vendas por Número de Pedidos. Use nomes exatamente como estão no modelo."
• "Crie uma medida de Receita YTD. Coloque na pasta 'Métricas/Time Intelligence'. Se não houver tabela calendário, me diga o que falta."
• "Crie uma medida de Crescimento Ano a Ano com SAMEPERIODLASTYEAR. A tabela de datas é [dCalendario], coluna [Data]."

Auditar e corrigir:

• "Verifique se as medidas seguem o padrão [Verbo + Objeto] em português. Liste as que não seguem e sugira nomes."
• "Aplique nomenclatura: colunas em Title Case, medidas com prefixo 'm_', dimensões com 'd_', fatos com 'f_'. Mostre um diff antes/depois."
• "Analise os tipos de dados e otimize para compressão/performance. Aplique onde for seguro e resuma o que mudou."

Análise de dados (via MCP):

• "Para dCalendario[Mês]=12 e dCalendario[Ano]=2024, gere um resumo executivo: Realizado, Meta, Atingimento, Gap, Qtde, Ticket Médio. 5 insights com números."
• "Valide esta medida e aponte problemas de contexto/filtro, depois corrija: [cole a medida]"

Dica: quanto mais contexto no prompt (nomes exatos de tabela/coluna, critério do que conta como "problema"), melhor a resposta.

Resolução de problemas comuns

O que foi instalado (resumo)

Nota de validação

Documento de autoria própria (OfficeTuning), checado item a item contra o README oficial do repositório microsoft/powerbi-modeling-mcp, a VS Code Marketplace e três tutoriais independentes sobre o mesmo servidor MCP. Nenhuma divergência factual encontrada — caminho de configuração, nome da extensão, nome do executável, estrutura do JSON e comando de conexão todos confirmados. Única ressalva: os nomes específicos de ferramenta citados como exemplo de "conexão bem-sucedida" podem já ter mudado, já que o servidor está em Public Preview — isso é uma característica do software, não um erro do guia. Este documento substitui integralmente a recomendação de "não publicar" feita anteriormente para o Capítulo 20 do livro-fonte.