BC 29: Data Query Tools no MCP Server — queries AL ad-hoc sem API pré-definida
15881
wp-singular,post-template-default,single,single-post,postid-15881,single-format-standard,wp-theme-bridge,bridge-core-1.0.6,ajax_fade,page_not_loaded,,qode-theme-ver-18.2,qode-theme-bridge,qode_header_in_grid,wpb-js-composer js-comp-ver-7.9,vc_responsive

BC 29: Data Query Tools no MCP Server — queries AL ad-hoc sem API pré-definida

05 Out BC 29: Data Query Tools no MCP Server — queries AL ad-hoc sem API pré-definida

Posted at 00:04h in Técnico by

O BC 29 (2026 Release Wave 2) trouxe para o MCP Server do Business Central um recurso que muda o jogo para quem desenvolve em AL: as Data Query Tools (preview) — tools de sistema que permitem ao agente compilar e executar queries AL ad-hoc, cobrindo perguntas que nenhuma API pré-definida responde.

O problema que resolve

Até o BC 28.5, para um agente de IA consultar dados do BC via MCP, você precisava expor APIs ou API pages para cada combinação de campos/joins que a pergunta pudesse exigir. Com as Data Query Tools, o próprio agente descobre o modelo e escreve a query: você não cria API para cada caso — cria a configuração certa e habilita a feature.

As 4 tools de sistema

  • bc_data_find_tables — encontra tabelas do BC por nome ou similaridade semântica; retorna IDs e nomes.
  • bc_data_get_table_relations — retorna as relações de saída/entrada de uma tabela (o mapa de joins).
  • bc_data_get_table_schema — retorna os campos da tabela em texto compacto (pipe-delimited).
  • bc_data_query — compila e valida uma query AL; por padrão devolve só o schema; com returnData=true devolve as linhas.
Painel
Painel System Tools na configuração do MCP Server (BC 29): as 4 tools de data query

Como ativar

Em Copilot & agent capabilities, a configuração do MCP Server ganhou uma nova aba “Server Features” — é lá que se habilita Data Query Tools (Preview). As APIs/API pages adicionadas em “Available APIs” continuam expostas de forma independente (a feature não as afeta). Requisito: licença de Copilot para o usuário/agente que consulta.

Segurança por design

As tools são read-only: o agente não cria, altera nem apaga dados. A query é compilada e validada antes de rodar — query inválida não executa. Para ambientes produtivos, combine com o controle de permissões do agente (o BC 29 também simplificou isso) e monitore pelo painel de tarefas.

Exemplo de fluxo

Pergunta: “quais os 5 clientes com maior receita no trimestre?”. O agente: (1) bc_data_find_tables("customer", "sales") → acha as tabelas; (2) bc_data_get_table_relations → descobre o join; (3) bc_data_get_table_schema → pega os campos; (4) bc_data_query com returnData=true → executa a query AL e devolve as linhas. De ponta a ponta, sem uma única API custom pré-criada.

Fontes: Microsoft Learn — Update 29.0 (whatsnew-update-29-0), MCP Server Overview and Setup; Dynamics 365 Lab (yzhums.com/76419); Business Central Launch Event 2026 RW2.