POWER BI
Como conectar o Codex ao Power BI Desktop via MCP
Instale a extensão MCP da Microsoft, localize o executável e cadastre a conexão com o Power BI Desktop diretamente no aplicativo Codex.
Fala, aprendizes! 🧙
Você já se deparou com aqueles conteúdos incríveis mostrando o que dá para fazer com MCP e inteligência artificial, ficou com vontade de testar, mas na hora de colocar a mão na massa bateu aquela dúvida: “Tá, mas por onde eu começo?”
É justamente isso que vamos explorar hoje! Neste tutorial, vamos conectar o Codex ao Power BI Desktop utilizando MCP, passando pela configuração inicial até a confirmação da conexão com o modelo.
Para isso, vamos utilizar o servidor MCP oficial da Microsoft, que permite ao Codex interagir com o modelo semântico aberto no Power BI Desktop. Tudo passo a passo, para você entender como funciona e começar a explorar essa integração na prática
1. Pré-requisitos
- Power BI Desktop, com um arquivo aberto e o modelo carregado.
- Codex, com sua conta conectada.
- Visual Studio Code (VS Code) instalado. Vamos instalar a extensão da Microsoft na próxima etapa.
2. Instale a extensão no VS Code
Abra o VS Code e clique no ícone Extensões, na barra lateral esquerda. Você também pode usar o atalho Ctrl + Shift + X.
Na busca, digite Power BI. Selecione Power BI Authoring MCP Server, publicada pela Microsoft, e clique em Instalar. Confira o nome e o publicador para escolher a extensão correta.
Figura 1 — No painel Extensões, encontre Power BI Authoring MCP Server, da Microsoft, e clique em Instalar.
Aguarde a instalação terminar. Na página da extensão, confira o status Instalado. Os botões Desabilitar e Desinstalar também indicam que ela já está instalada. Se o VS Code solicitar, clique em Recarregar.
Figura 2 — Extensão instalada. Agora podemos localizar o executável que será usado pelo Codex.
3. Copie o caminho do executável do MCP
Abra o Explorador de Arquivos. Na barra de endereço, cole:
%USERPROFILE%\.vscode\extensions
Encontre a pasta da extensão powerbi-modeling-mcp. No exemplo, o nome começa com analysis-services.powerbi-modeling-mcp-, seguido da versão e da plataforma. O nome pode variar conforme a versão instalada.
Abra a pasta server e localize powerbi-modeling-mcp.exe. Clique com o botão direito no arquivo e escolha Copiar como caminho. Se a opção não aparecer, procure em Mostrar mais opções.
Guarde esse caminho em um bloco de notas: ele será usado no campo command da próxima etapa.
Figura 3 — Na pasta server, localize o executável powerbi-modeling-mcp.exe destacado em roxo.
4. Adicione o MCP no aplicativo Codex
No aplicativo Codex, abra Configurações e pesquise por MCPs. Selecione a opção encontrada.
Figura 4 — Acesse MCPs nas configurações do aplicativo Codex.
Clique em Adicionar → Adicionar servidor MCP.
Figura 5 — Selecione Adicionar servidor MCP.
No formulário Conectar a um MCP personalizado, preencha os campos abaixo.
Figura 6 — Formulário de cadastro do servidor MCP no Codex.
- Nome:
powerbi. - Tipo: STDIO.
- Comando para iniciar: cole o caminho completo do powerbi-modeling-mcp.exe, copiado na etapa 3, sem as aspas. Use o caminho do seu computador.
- Argumentos: digite somente
--readwrite.
Na versão 1.0.0 utilizada neste tutorial, --readwrite já inicia o servidor e permite leitura e escrita no modelo.
Deixe Variáveis do ambiente, Encaminhamento de variáveis do ambiente e Diretório de trabalho vazios. O texto ~/code, quando aparece apenas como sugestão no campo, não precisa ser preenchido.
Figura 7 — Cadastro preenchido com Nome powerbi, tipo STDIO, caminho do executável e argumento --readwrite.
Confira os campos e clique em Salvar.
5. Reinicie o Codex e conecte ao Power BI
Feche e abra novamente o Codex para carregar a configuração. Mantenha o arquivo do Power BI Desktop aberto.
Na conversa, envie:
Conecte-se ao Power BI aberto.
Caso tenha mais de um arquivo aberto no Power BI Desktop, informe o nome daquele que deseja utilizar.
Autorize as solicitações de execução das ferramentas, quando necessário, e aguarde a confirmação de que a conexão foi estabelecida com o modelo correto.
Figura 8 — Confirmação da conexão com o arquivo Tutorial_MCP aberto no Power BI Desktop.
Pronto! A conexão está configurada.
6. Referências
Até a próxima jornada!
Karine Batista