Como conectar o Claude ao Power BI Desktop via MCP

Fala, aprendizes! 🧙

No post anterior, conectamos o Codex ao Power BI Desktop usando MCP. Agora chegou a vez do Claude! Vamos aproveitar o mesmo servidor da Microsoft e configurar a conexão no Claude Desktop, passo a passo.

E tem uma boa notícia: se você acompanhou o tutorial anterior e já instalou a extensão, não precisa começar tudo do zero! Pode seguir para a etapa 3 para copiar o caminho do executável e, na etapa 4, configurar o Claude Desktop. Depois, vamos validar a conexão com o Power BI.

1. Pré-requisitos

• Power BI Desktop, com um arquivo aberto e o modelo carregado.
• Claude Desktop para Windows, instalado e com sua conta conectada.
• Visual Studio Code (VS Code) instalado, para instalar a extensão da Microsoft.

2. Instale a extensão no VS Code

Abra o VS Code e clique em Extensões, na barra lateral esquerda. Você também pode usar o atalho Ctrl + Shift + X.

Pesquise Power BI, selecione Power BI Authoring MCP Server, publicada pela Microsoft, e clique em Instalar.

Figura 1 — Encontre a extensão da Microsoft e clique em Instalar.

Aguarde a instalação terminar e confira o status Instalado. Se o VS Code solicitar, clique em Recarregar.

Figura 2 — Extensão instalada.

3. Copie o caminho do executável do MCP

No Explorador de Arquivos, cole na barra de endereço:

%USERPROFILE%\.vscode\extensions

Encontre a pasta cujo nome começa com analysis-services.powerbi-modeling-mcp-, seguido da versão e da plataforma. Abra a pasta server.

Localize powerbi-modeling-mcp.exe, clique com o botão direito e escolha Copiar como caminho. Se necessário, procure em Mostrar mais opções.

Figura 3 — Copie o caminho do executável destacado. O nome da pasta depende da versão instalada.

Guarde o caminho: vamos usá-lo no campo command da próxima etapa.

4. Configure o MCP no Claude Desktop

Abra as Configurações do aplicativo Claude Desktop. Acesse Desenvolvedor (Developer) e clique em Editar configuração (Edit Config).

Figura 4 — Em Desenvolvedor, clique em Editar configuração.

O arquivo de configuração no Windows é:

%APPDATA%\Claude\claude_desktop_config.json

Figura 5 — Localize o arquivo claude_desktop_config.json destacado em roxo.

Abra o arquivo no Bloco de Notas ou no VS Code. Se já houver configurações, faça uma cópia antes de editar e preserve as entradas existentes.

Figura 6 — Antes: arquivo com as configurações existentes, ainda sem o MCP powerbi.

Se o arquivo estiver vazio, use esta estrutura:

{
  "mcpServers": {
    "powerbi": {
      "command": "COLE_AQUI_O_CAMINHO_DO_SEU_EXECUTAVEL",
      "args": ["--readwrite"]
    }
  }
}

Substitua COLE_AQUI_O_CAMINHO_DO_SEU_EXECUTAVEL pelo caminho completo que você copiou da sua própria instalação na etapa 3. A pasta da extensão inclui a versão instalada e pode mudar após uma atualização. Não copie o caminho dos prints: use o caminho do executável no seu computador. Em JSON, cada barra invertida do caminho deve ser escrita duas vezes: \\. Por exemplo, C:\Users fica C:\\Users. Mantenha as aspas que delimitam o valor e remova as aspas extras trazidas por Copiar como caminho.

Se já existir mcpServers, adicione apenas a entrada powerbi dentro dele, separada das demais por vírgula. Não crie outro bloco mcpServers.

O argumento --readwrite, usado com a versão 1.0.0 neste tutorial, inicia o servidor com leitura e escrita. Salve o arquivo como claude_desktop_config.json, sem acrescentar .txt ao nome.

Figura 7 — Depois: bloco mcpServers adicionado com o servidor powerbi, preservando as configurações anteriores.

5. Reinicie o Claude e conecte ao Power BI

Encerre completamente o Claude Desktop e abra novamente para carregar a configuração. Se ele continuar na bandeja do Windows, use Sair no ícone do aplicativo.

Para conferir se a configuração foi carregada, volte a Configurações → Desenvolvedor. Em Servidores MCP locais, selecione powerbi e verifique se o status aparece como Em execução, como na imagem abaixo.

Figura 8 — Servidor powerbi em execução na aba Desenvolvedor do Claude Desktop.

Com o servidor em execução, volte à conversa para conectar ao arquivo aberto no Power BI.

Em uma nova conversa, envie:

Conecte-se ao Power BI aberto.

Se houver mais de um arquivo aberto, informe o nome daquele que deseja utilizar. Confira e autorize as solicitações de execução das ferramentas, quando necessário.

No primeiro uso, o servidor pode solicitar a aceitação do contrato de licença da Microsoft. Leia os termos apresentados e, se concordar, autorize o Claude a aceitá-los.

Aguarde a confirmação da conexão e confira se o nome do arquivo corresponde ao modelo que você abriu.

Figura 9 — Confirmação da conexão do Claude com o arquivo Tutorial_MCP aberto no Power BI Desktop.

Pronto! O Claude está conectado ao seu Power BI Desktop. Caso atualize a extensão, confira se o caminho em command continua apontando para o executável correto.

6. Referências

• Conexão de servidores MCP locais no Claude Desktop — documentação MCP
• Power BI Authoring MCP Server — Microsoft
• Como conectar o Codex ao Power BI Desktop via MCP — Maga do BI

Até a próxima jornada!

Karine Batista