MICROSOFT FABRIC
Como conectar um Data Agent do Microsoft Fabric ao Claude
Um roteiro direto para conectar um Data Agent ao Claude via MCP, configurar a autenticação e validar uma consulta.
Fala, aprendizes! 🧙
Já imaginou aproveitar seus dados já tratados em um modelo semântico do Microsoft Fabric, direto no Claude? Com um Data Agent, você pode consultar esses dados usando perguntas em linguagem natural.
Neste tutorial, vamos conectar esse agente ao Claude via MCP, com você acompanhando o caminho desde a publicação do agente até a primeira consulta.
O procedimento parte de um agente já configurado. A disponibilidade das opções depende das configurações e permissões do seu ambiente.
1. Pré-requisitos
Antes de iniciar, confira:
- Microsoft Fabric: capacidade paga F2 ou superior, ou Power BI Premium por capacidade P1 ou superior com Fabric habilitado. Tenha um Data Agent já criado, com fontes configuradas, acesso aos dados e permissão para publicar o agente. Consulte os pré-requisitos oficiais do Fabric.
- Microsoft Entra: acesso ao diretório do mesmo ambiente e permissão para registrar aplicativos e configurar suas credenciais.
- Claude: os conectores personalizados via MCP estão disponíveis a partir do plano Free, além de Pro, Max, Team e Enterprise. No Free, o limite é de um conector personalizado. Confira a disponibilidade oficial dos conectores.
- Permissões: disponibilidade da permissão delegada de execução do Data Agent e aprovação administrativa, quando exigida pela organização.
2. Publique o agente e copie a URL MCP
No Fabric, abra o Data Agent e clique em Publicar. Se ele já estiver publicado, avance para as configurações.
Em Configurações → Protocolo de Contexto do Modelo, copie a URL do servidor MCP pelo botão de copiar. Use o endereço completo do seu próprio agente. Cole-o em um bloco de notas local, identificado como URL MCP, e guarde-o temporariamente para preencher o Claude na etapa 5.
Figura 1 — Configurações MCP do agente, com informações do ambiente ocultadas. Captura do tutorial.
3. Registre um aplicativo no Microsoft Entra
Abra o Centro de administração do Microsoft Entra e entre com a conta do seu ambiente. No menu lateral, acesse Entra ID → Registros de aplicativo → Novo registro. Escolha um nome descritivo, como Integracao-Fabric-Claude. Para um cenário restrito à organização, selecione contas do mesmo diretório.
Clique em Registrar. Em seguida, abra o aplicativo em Registros de aplicativo → seu aplicativo → Visão geral.
Localize ID do aplicativo (cliente) e clique no ícone de copiar ao lado do valor. Cole esse valor no mesmo bloco de notas local, identificado como Client ID, e guarde-o até a etapa 5. Esse é o Client ID que será colado no primeiro campo de Usar seu próprio cliente OAuth, no Claude (etapa 5). Não copie o ID do objeto nem o ID do diretório (locatário).
Figura 2 — Registro do aplicativo, com a identificação do diretório ocultada. Captura do tutorial.
Figura 3 — Copie o ID do aplicativo (cliente) destacado na Visão geral. Os valores foram ocultados.
4. Configure a permissão de execução
No aplicativo, abra Permissões de APIs → Adicionar uma permissão → APIs que a minha organização usa. Pesquise Power BI Service, selecione o resultado e escolha Permissões delegadas.
Pesquise DataAgent, marque apenas DataAgent.Execute.All para este fluxo e clique em Adicionar permissões. Confira se ela aparece na lista como Delegado.
Confira se a política da organização exige aprovação administrativa. A permissão do aplicativo não substitui o acesso que o usuário precisa ter no Fabric.
Figura 4 — Seleção da permissão delegada DataAgent.Execute.All. Captura do tutorial.
5. Inicie o conector no Claude
No Claude Desktop, abra o menu do perfil → Configurações → Personalização → Conectores. Clique em Adicionar → Adicionar conector personalizado.
- Preencha Nome com um nome descritivo para a integração.
- Em URL do servidor MCP, cole a URL MCP guardada no bloco de notas na etapa 2.
- Clique em Continuar. Em Autenticação, mantenha Entrar agora e, em Cliente OAuth, selecione Usar seu próprio cliente OAuth.
- Copie o Client ID guardado no bloco de notas na etapa 3 e cole no primeiro campo do cliente OAuth no Claude.
Figura 5 — Preencha Nome e cole a URL MCP no segundo campo. Em seguida, clique em Continuar.
Mantenha esse formulário aberto e ainda não clique em Adicionar. Antes de concluir, configure a URI de retorno e prepare o segredo no Entra, conforme a próxima etapa.
6. Prepare a autenticação OAuth
6.1. Cadastre a URI de retorno
No Microsoft Entra, abra Entra ID → Registros de aplicativo → o aplicativo criado na etapa 3. No menu lateral desse aplicativo, entre em Autenticação — no documento, a opção aparece como Authentication (Preview).
Na aba Configuração do URI de redirecionamento, clique em Adicionar o URI de redirecionamento, ao lado do símbolo +. Se o seu portal mostrar Adicionar uma plataforma, use esse comando para abrir a seleção de plataformas.
Figura 6 — Abra Autenticação e clique no comando para adicionar a URI de redirecionamento.
No painel de plataformas, encontre Aplicativos Web → Web e clique em Selecionar nesse cartão.
Figura 7 — Selecione a plataforma Web para o retorno do login.
No primeiro campo, URI de redirecionamento, cole exatamente:
https://claude.ai/api/mcp/auth_callback
Neste fluxo, deixe URL de logoff do canal frontal em branco e mantenha Tokens de acesso e Tokens de ID desmarcados. Confira o endereço e clique em Configurar no rodapé. Aguarde a confirmação e verifique se a URI aparece na lista da plataforma Web.
Figura 8 — Cole a URI no primeiro campo e salve pelo botão Configurar.
Esse endereço é o retorno de autenticação do Claude. Confira a URI indicada na documentação vigente antes de configurar.
Essa URI recebe o retorno do login; ela não é a URL MCP do agente.
6.2. Prepare o segredo do cliente
Para encontrar Certificados e segredos, abra o Microsoft Entra e siga Entra ID → Registros de aplicativo → seu aplicativo. No menu lateral esquerdo do aplicativo, dentro de Gerenciar, clique em Certificados e segredos (ícone de chave). Dentro dessa página, selecione a aba Segredos do cliente.
Figura 9 — No menu lateral do aplicativo, abra Gerenciar → Certificados e segredos, destacado em vermelho. Os dados identificáveis foram ocultados.
Se o fluxo exigir segredo do cliente:
- No aplicativo do Entra, abra Certificados e segredos → Segredos do cliente → Novo segredo do cliente.
- Preencha uma descrição genérica, escolha a validade permitida pela organização e clique em Adicionar.
- Na linha criada, copie imediatamente a coluna Valor, pelo ícone de copiar. Esse conteúdo é o Client Secret; a coluna ID do segredo não serve para autenticar.
- Na etapa 7, cole o valor no segundo campo de Usar seu próprio cliente OAuth, quando o servidor exigir o segredo.
O Valor só fica disponível para cópia após a criação. Se ele não estiver mais acessível, crie um novo segredo conforme a política do ambiente. Não inclua a credencial no artigo, em capturas ou em mensagens.
Figura 10 — Use o botão de copiar ao lado de Valor, destacado em vermelho; não copie o ID secreto. Os dados foram ocultados.
6.3. Confira antes de conectar
| O que copiar | Onde copiar | Onde colar no Claude |
|---|---|---|
| URL do servidor MCP | Fabric → configurações do Data Agent → Protocolo de Contexto do Modelo | URL do servidor MCP |
| ID do aplicativo (cliente) | Entra → Registros de aplicativo → seu aplicativo → Visão geral | Primeiro campo de Usar seu próprio cliente OAuth |
| Valor do segredo | Entra → seu aplicativo → Certificados e segredos → Segredos do cliente → Valor | Segundo campo de Usar seu próprio cliente OAuth, quando exigido |
Use o ID e o segredo do mesmo aplicativo registrado. A URI de redirecionamento fica na configuração de autenticação do Entra; ela não deve ser colada no campo de URL MCP.
7. Conclua o conector e vincule a conta
Volte ao formulário do conector deixado aberto na etapa 5.
- Confira o nome e a URL do servidor MCP copiada do Fabric.
- Mantenha Entrar agora e Usar seu próprio cliente OAuth.
- No primeiro campo (ID do cliente OAuth / Client ID), cole o ID do aplicativo (cliente) copiado da Visão geral no Entra. Na captura abaixo, é o campo superior com tarja roxa.
- No segundo campo (Segredo do cliente OAuth / Client Secret), cole o conteúdo da coluna Valor em Certificados e segredos, quando exigido. Na captura, é o campo inferior com tarja roxa.
- Clique em Adicionar e aguarde a verificação. Se aparecer Vincular, clique e entre com a conta Microsoft que tem acesso ao agente. Confira as permissões solicitadas e conclua o consentimento autorizado.
- Ao ver Conectado no navegador, retorne ao Claude Desktop. Confira se o conector apresenta Desvincular e se a ferramenta do agente está disponível. Mantenha a aprovação de uso da ferramenta ativa.
Figura 11 — Cliente OAuth no Claude, com os valores de autenticação ocultados. Captura do tutorial.
8. Faça uma consulta simples e confira o resultado
Na conversa do Claude, peça primeiro para conectar ao conector que você configurou. Informe o nome dele e aguarde o Claude carregar o conector e confirmar que a ferramenta do Data Agent está disponível.
Depois de confirmar a conexão, faça uma pergunta sobre os dados acessíveis ao agente.
Revise a solicitação de uso da ferramenta: confira o conector, a ferramenta e a pergunta enviada. Clique em Permitir uma vez para aprovar essa execução. Depois, compare a resposta com a fonte original.
Figura 12 — Confira a solicitação e clique em Permitir uma vez. Somente o nome do Data Agent foi ocultado.
A conexão só está validada quando a ferramenta executa a consulta e o resultado é conferido. Preencher o formulário não basta.
9. Referências
- Data Agent como servidor MCP — Microsoft Learn
- Conectores personalizados — Claude
- Autenticação de conectores MCP — Anthropic
Até a próxima jornada!
Karine Batista