Ir para o conteúdo

Perguntar ao Smart Data de dentro da sua ferramenta de IA

O Smart Data tem um servidor MCP. Ligando-o à sua ferramenta de IA, você pergunta sobre as cerca de 9.600 empresas da base no próprio chat — sem abrir o portal, sem exportar planilha.

O que dá para perguntar

  • “A margem líquida da Braskem é boa para o ramo dela?” — a resposta vem com os quartis do grupo e o percentil da empresa.
  • “Quais as maiores empresas do setor alimentício?” — ele descobre que “alimentício” não é um setor e escolhe o segmento certo.
  • “Quantas empresas de siderurgia a base tem?”
  • “Compare a liquidez corrente da Petrobras com o setor de energia.”
  • “Quais indicadores eu posso consultar?”

A comparação com o grupo é o que esta base tem de próprio: a maioria destas empresas não é de capital aberto, então o par de comparação não existe em nenhuma outra fonte.

1. Gere o seu token

Verificando a sua conta…

2. Ligue a sua ferramenta

  1. 1

    Abra o terminal

    Onde o Claude Code estiver instalado — não precisa estar dentro deste projeto.

  2. 2

    Cole o comando abaixo

    Trocando SEU_TOKEN pelo token da etapa 1, e pressione Enter. O token vai num cabeçalho, que é a forma correta — não fica registado em log de servidor nem de proxy.

    terminal
    claude mcp add --transport http smart-data https://smartdataq.lovable.app/api/mcp --header "Authorization: Bearer SEU_TOKEN"
  3. 3

    Reinicie o Claude Code

    Feche e abra de novo (ou comece uma sessão nova) para ele carregar o servidor “smart-data”.

3. Confirme que ligou

  1. 1

    Reinicie ou recarregue a ferramenta

    Um cliente de CLI carrega os servidores ao arrancar; um cliente com interface pede confirmação ao adicionar o conector.

  2. 2

    Pergunte algo que só a base responde

    Se ele chamar uma ferramenta e voltar com quartis e percentil, está ligado.

    A margem líquida da Braskem é boa para o ramo dela?

As cinco ferramentas

FerramentaO que responde
listar_seriesOs 52 indicadores, as 25 linhas da DRE e as 23 contas do balanço que se podem pedir pelo nome.
listar_recortesA árvore de setores, segmentos e ramos, com quantas empresas há em cada. Necessária porque termos como “alimentício” não são setores da base — caem em vários segmentos e ramos.
ranking_empresasAs maiores e as menores de um recorte num indicador, com a mediana do grupo. Usa o mesmo corte de valores extremos da página de Ranking.
buscar_empresaEmpresas por parte do nome ou por CNPJ, com setor, segmento e ramo.
comparar_com_paresUma empresa contra a distribuição do grupo dela: mínimo, quartis, mediana, máximo e o percentil onde ela cai.

O que a base não diz

  • 2025 está parcial. Muitas empresas ainda não publicaram o exercício completo, então tendência que termine em 2025 pede ressalva.
  • A cobertura é de quem publica balanço. Sociedades anônimas, grandes limitadas e subsidiárias. Empresa que não publica não está aqui — mas o ramo dela provavelmente está, e é o ramo que serve de comparação.
  • Zero às vezes é arredondamento. Em alguns indicadores significa “menos de meio milhão”, não “sem dado”.

Estas ressalvas viajam dentro de cada resposta do servidor, e o cliente é instruído a repassá-las — você não precisa de as memorizar.