Histórico de mudanças

situacao_credito_por_cliente ficou mais rápida, sobretudo no varejo, onde podia passar do tempo máximo de uma consulta: o último pedido reprovado no crédito passa a ser apurado uma vez para todos os clientes, e não cliente a cliente. O resultado não muda (mesmas linhas e colunas).

logistica_otd_por_rota ainda listava 'limite' entre os filtros obrigatórios, mas o parâmetro saiu na 3.0.0 (a consulta devolve todas as rotas). Agora lista só dt_ini e dt_fim.

logistica_notas_nao_embarcadas (QUEBRA: parâmetros novos dias_uteis_min, janela_dias e incluir_ruido; dias_min, dias_max e limite saíram): sem a janela fixa de 15 dias e sem corte pela nota mais recente. Uma linha por nota, da mais parada para a mais recente, em dias úteis, com posicao, total_notas e considerado_desde para declarar o recorte. Separa as notas que nunca passam pelo WMS ou já saíram (pronta-entrega, série 1, remessa, nota avulsa, bonificação, devolvida, entregue no RouteEasy). Exportável.

logistica_notas_paradas_por_cd_faixa: as notas paradas por estabelecimento emissor e faixa de dias úteis, com subtotais e o ruído por classe. Exportável.

devolucoes_por_motivo_agregada: devolução por motivo, sem vendedor, supervisor, canal ou cliente, com a linha de TOTAL do período por último. Bate no centavo com a tela de devoluções do GESTOR. Exportável.

logistica_otd_por_rota: todas as rotas, sem limite, ordenadas pela TAXA (pior primeiro), com estabelecimento emissor, pendentes, OTD só sobre entregas avaliadas e um sinal de amostra pequena. A nota passa a ser ligada por número + cliente. O parâmetro limite saiu (se enviado, é ignorado). Exportável.

meta_venda_por_cidade_bairro: a meta de venda inteira por cidade e bairro, por mês e canal, com regional e vendedor; a soma bate no centavo com a meta oficial do canal. Exportável.

x1_meta_territorio avisa, na descrição e na resposta, que é insumo do X1 (sem bairros, com teto de linhas) e aponta para meta_venda_por_cidade_bairro.

Consultas de meta com vários meses (meta_oficial_por_canal_periodo, meta_por_vendedor_periodo, meta_realizado_por_regional_macro e meta_por_macro_regional): uma lista dava erro e o texto '8,9' ou '1..8' devolvia só o primeiro mês, sem aviso. Agora aceitam 8, [8, 9], '8,9' e '1..8'; lista vazia, aninhada ou com mais de 1.000 itens volta como 'Parâmetro inválido', sem ir ao banco.

Esta documentação em /docs, gerada pelo próprio servidor a partir das ferramentas, do catálogo e dos limites publicados, e este histórico em /historico. Abertas, sem token: não mostram dado nem segredo. O endereço raiz (/) leva para a documentação.

O servidor informa a versão e o endereço desta documentação na resposta ao initialize (serverInfo).

A descrição de banco_perguntar_exploratorio diz exatamente quem pode usar: os acessos liberados pela T.I. (conectores OAuth e token interno).

Consultas de escopo individual ganharam o tipo de escopo (vendedor, equipe ou cliente), usado pelo copiloto interno para recortar o dado de cada perfil. No MCP nada muda: quem conecta aqui tem acesso de leitura pleno às consultas do catálogo.

metas_realizado_por_nivel: a descrição do parâmetro dizia que o realizado era da equipe; o SQL calcula o de um vendedor.

banco_perguntar_exploratorio: quando nenhuma consulta do catálogo responde, o servidor monta a consulta a partir da pergunta em português, valida e roda. Resultado marcado como exploratório, até 50 linhas, sem o SQL. Só para os acessos liberados pela T.I.; tokens de parceiro não usam.

Consultas historico_compra_por_cliente e situacao_credito_por_cliente (exportáveis): histórico de compra e situação de crédito de cada cliente de um canal.

Erros previstos (parâmetro inválido, consulta inexistente) agora chegam ao modelo com o motivo; antes chegavam só como "Error executing tool".

Consultas carteira_por_cliente (exportável), compradores_fora_da_carteira (exportável), penetracao_cidade_canal, cnaes_da_carteira_por_canal, penetracao_cidade_cnaes e historico_supervisor_vendedor.

Avisos novos em vendedores_historico_atacado e prospects_penetracao_regiao (esta soma todos os canais).

x1_nota, x1_ranking e x1_meta_territorio informam truncado quando há mais linhas do que o limite pedido.

Falha de conexão com o banco volta como {ok: false} com mensagem genérica, sem usuário nem endereço do servidor.

banco_exportar_consulta: exporta uma consulta exportável inteira em CSV (separador ;, decimal com ponto, rodapé com número de linhas, SHA-256 e total).

banco_executar_consulta aceita offset para paginar resultados grandes.

A marca truncado agora é verdadeira também nas consultas com LIMIT próprio.

Consultas faturamento_atacado_cliente_cidade_mes (exportável), faturamento_varejo_cliente_cidade_mes (exportável), vendedores_historico_atacado, meta_por_macro_regional e meta_realizado_por_macro_regional.

19 consultas do catálogo corrigidas e validadas no banco (SQL e nome do vendedor).

Ferramentas de registro do ecossistema: estado_do_ecossistema, listar_agentes, obter_agente, listar_obras, buscar_decisoes, abrir_achado e registrar_ato. O registro segue na plataforma, fora do MCP.

O catálogo de consultas não chegava ao servidor publicado; as ferramentas banco_* falhavam na chamada. O servidor agora avisa no arranque quantas consultas carregou.

Mais de um token Bearer aceito ao mesmo tempo, cada um com rótulo e revogável sozinho: cada parceiro recebe o seu.

Login OAuth para o conector do Claude (registro dinâmico + PKCE): a credencial fica na conta de quem conectou, com renovação automática.

x1_recortes: os 8 recortes do X1 (média dos 20% melhores por canal), sem recalcular a nota oficial.

24 consultas novas trazidas do GESTOR (125 no catálogo).

banco_listar_consultas mostra o escopo de cada consulta.

A trava de um comando por consulta tratava errado o ';' dentro de texto e recusava consultas válidas.

O transporte HTTP exige token Bearer em toda chamada e não sobe sem ele. /healthz fica aberto para monitoramento.

x1_regua_vigente, x1_nota, x1_ranking e x1_meta_territorio: régua, nota, ranking e meta por território do X1, lidos do GESTOR, só leitura.

banco_listar_consultas, banco_descrever_consulta e banco_executar_consulta: catálogo de consultas sobre o banco comercial, executadas com usuário só leitura.

Executor revisado: só SELECT/WITH, um comando por consulta, teto de linhas e leitura em streaming.

Servidor MCP da plataforma com as ferramentas de registro do ecossistema de agentes.