Documentação do conector

O conector da LeadingBI permite que um assistente de inteligência artificial compatível com o protocolo MCP (Model Context Protocol), como o Claude, consulte em linguagem natural os dados empresariais disponíveis na conta do usuário na LeadingBI. Basta perguntar, por exemplo, "qual foi o resultado da empresa em setembro?" ou "há férias vencendo?": o assistente escolhe as consultas adequadas, obtém os dados e apresenta a resposta com a base utilizada.

Endereço do conector: https://mcp-server.leadingbi.app.br/mcp

O que é e para quem se destina

O conector é um servidor MCP remoto, mantido pela LeadingBI, que dá ao assistente de IA acesso somente de leitura aos dados contábeis, fiscais e de departamento pessoal das empresas às quais o usuário tem acesso. Nada é criado, alterado ou apagado por meio dele.

Destina-se a:

escritórios de contabilidade e seus profissionais (contadores, analistas contábeis, fiscais e de departamento pessoal), para consultas e conferências do dia a dia;
empresas clientes, para acompanhar resultados, faturamento e pessoal sem precisar conhecer os relatórios técnicos;
administradores de TI que avaliam o conector antes de liberá-lo na organização (há uma seção específica no fim desta página).

As consultas respeitam sempre as permissões do usuário: somente as empresas e os módulos liberados para a sua conta ficam acessíveis.

O que é possível consultar

As consultas estão organizadas por área. Os nomes abaixo são os exibidos pelo aplicativo de IA na lista de ferramentas do conector. Em geral, não é preciso escolhê-las: o assistente seleciona a consulta adequada a partir da pergunta.

Cadastro

Consulta	Conteúdo
Cadastro · Empresas	Dados cadastrais das empresas da carteira (código, razão social, nome, CNPJ), com busca por nome ou por CNPJ.
Cadastro · Centros de custo	Centros de custo cadastrados na empresa.
Cadastro · Contas acessíveis	Contas (organizações) que o seu Token de Acesso alcança. Com elas, as demais consultas podem trazer os dados de cada conta, uma por vez, e o assistente consolida o resultado.

Contábil

Consulta	Conteúdo
Contábil · Balancete sintético	Totais do balancete por nível do plano de contas (níveis 1 a 3), para um ou vários meses e para uma ou todas as empresas. É a base do balanço patrimonial e das comparações entre períodos e entre empresas.
Contábil · Balancete analítico	Saldo inicial, débitos, créditos e saldo final de cada conta em um mês, com a classificação contábil.
Contábil · DRE com valores	Demonstração do Resultado do Exercício por nível, em um ou vários meses.
Contábil · Estrutura da DRE	Linhas e agrupamentos da DRE da empresa, sem valores.
Contábil · Razão (lançamentos)	Lançamentos individuais que compõem os saldos, com data, histórico, valor e contas de débito e crédito.
Contábil · Plano de contas	Contas do plano de contas, com os níveis da hierarquia contábil.

Fiscal

Consulta	Conteúdo
Fiscal · Clientes e fornecedores	Cadastro de clientes e fornecedores das empresas, com busca por nome, CNPJ ou CPF.
Fiscal · Tabela de CFOP	Descrição oficial de cada CFOP (Código Fiscal de Operações e Prestações).

Departamento Pessoal

Consulta	Conteúdo
Departamento Pessoal · Colaboradores	Cadastro dos colaboradores, com cargo, admissão e situação atual, e busca por nome ou CPF.
Departamento Pessoal · Quadro de pessoal	Colaboradores ativos, contratações e desligamentos por mês, inclusive para toda a carteira.
Departamento Pessoal · Folha de pagamento	Proventos, descontos e valores informativos de cada colaborador por competência.
Departamento Pessoal · Encargos (INSS, FGTS, IRRF)	Encargos apurados sobre a folha, por colaborador e competência.
Departamento Pessoal · IRRF da folha	Imposto de Renda Retido na Fonte apurado sobre a folha.
Departamento Pessoal · Provisões de férias e 13º	Provisões de férias (com o terço constitucional) e de 13º salário.
Departamento Pessoal · Férias	Períodos aquisitivos, períodos de gozo e valores das férias.
Departamento Pessoal · Saldo de férias	Dias de férias disponíveis e prazo limite para a concessão.
Departamento Pessoal · Afastamentos	Períodos de afastamento (licenças, atestados e situações semelhantes), sem o motivo.
Departamento Pessoal · Contratos de experiência	Vencimentos do primeiro período e da prorrogação dos contratos de experiência.
Departamento Pessoal · Alterações salariais	Histórico de alterações salariais dos colaboradores.
Departamento Pessoal · Rescisões	Desligamentos e verbas rescisórias, com a data de demissão.
Departamento Pessoal · Eventos da folha (catálogo)	Rubricas de provento, desconto e informativas utilizadas na folha.
Departamento Pessoal · Situações do colaborador (catálogo)	Situações possíveis de um colaborador e o efeito de cada uma sobre férias, 13º salário e tempo de serviço.
Departamento Pessoal · Motivos de demissão (catálogo)	Motivos de desligamento (pedido de demissão, dispensa, acordo entre as partes etc.).
Departamento Pessoal · Tipos de contrato (catálogo)	Tipos de contrato e de vínculo empregatício (CLT, estágio, temporário etc.).

As consultas aceitam uma empresa específica ou todas as empresas da carteira do usuário. Também é possível pedir classificações, como "as dez empresas com maior saldo de caixa" ou "os cinco colaboradores com mais dias de férias acumulados", e quantidades, como "quantos colaboradores ativos a empresa tem".

Análises prontas

Algumas tarefas reúnem várias consultas e um cálculo. Para elas, o conector oferece análises que já buscam os dados, fazem a conta e informam a base utilizada:

Análise	O que entrega	Exemplo de pedido
Contábil · Diagnóstico de fechamento (análise)	Se o mês está fechado, no conjunto de matriz e filiais (ativo igual ao passivo com o patrimônio líquido e resultado lançado no mês), a situação de cada mês do exercício e os pontos de atenção de cada estabelecimento (débitos e créditos, saldos iniciais, contas com saldo invertido, contas a classificar, tributos acumulados, depreciação, folha e provisões).	"A contabilidade de setembro está fechada?"
Contábil · Receita bruta mensal (análise)	Receita bruta, devoluções, cancelamentos e descontos incondicionais de cada mês, com as contas utilizadas.	"Quanto a empresa faturou em setembro?"
Fiscal · Fator R do Simples Nacional (análise)	Fator R estimado, anexo resultante (III ou V), alíquota efetiva estimada e folha mínima necessária para o período seguinte.	"Qual é o Fator R da empresa no mês 10?"
Fiscal · Limites do Simples Nacional (análise)	Receita acumulada no ano em relação ao sublimite e ao limite do Simples Nacional, com projeção até dezembro.	"A empresa vai ultrapassar o limite do Simples?"
Departamento Pessoal · Pendências (análise)	Férias vencidas e a vencer, contratos de experiência a vencer, afastamentos em curso e prazos de pagamento de rescisões.	"O que há para resolver no departamento pessoal?"
Especialista · Guia de análise	Conceitos, regras e métodos contábeis, fiscais e trabalhistas, inclusive indicadores econômico-financeiros, para explicar termos e orientar as análises. Não traz dados das empresas.	"O que é Fator R?"

Pré-requisitos

Um usuário ativo no painel da LeadingBI, com acesso aos módulos e às empresas que se deseja consultar.
Um Token de Acesso gerado no painel (veja a próxima seção).
Um aplicativo de IA compatível com conectores MCP remotos e com autorização OAuth, como o Claude (site claude.ai, aplicativos para computador e celular, e Claude Code). Em planos corporativos, a inclusão de conectores personalizados pode depender de autorização do administrador da organização no aplicativo de IA.

Como gerar o Token de Acesso

O Token de Acesso é a credencial que autoriza o conector a consultar os dados em nome do usuário. No painel, ele é gerado na tela Tokens de API.

Acesse o painel da LeadingBI com o seu usuário e a sua senha.
Se o seu usuário tiver acesso a mais de uma conta, selecione, no seletor do topo da tela, a conta cujos dados serão consultados.
Clique no botão Tokens de API, no topo da tela.
Preencha os campos:
- Nome do token: um nome que identifique o uso, por exemplo "MCP - Claude";
- Finalidade: selecione MCP;
- Expira em: escolha a validade do token (1, 3, 6 ou 12 meses).
Clique em Gerar token e copie o valor com o botão Copiar. O token é exibido uma única vez; guarde-o em local seguro, como um gerenciador de senhas, até concluir a conexão.

Cuidados importantes:

O token vale somente para a conta em que foi gerado. Para consultar outra conta, selecione-a no painel, gere um token nela e conecte-se com esse token.
Não há escolha de empresas no momento da conexão: o token dá acesso a todas as empresas e módulos que o usuário já pode consultar naquela conta.
Ao fim da validade escolhida, o token deixa de funcionar e as consultas passam a informar que a conexão não é mais válida. Nesse caso, gere um novo token e refaça a conexão.
Nunca compartilhe o token nem o cole na conversa com o assistente: ele deve ser informado apenas na página de conexão da LeadingBI.

Como conectar

Claude (claude.ai e aplicativos para computador e celular)

Abra Configurações → Conectores.
Clique em Adicionar conector personalizado.
Informe um nome (por exemplo, "LeadingBI") e o endereço https://mcp-server.leadingbi.app.br/mcp, e confirme.
Clique em Conectar. Uma página da LeadingBI é aberta, solicitando o Token de Acesso.
Cole o token gerado no painel e clique em Conectar. Ao concluir, o aplicativo informa que o conector está conectado.
Em cada conversa, verifique se o conector está ativado no menu de ferramentas e faça a pergunta normalmente.

Claude Code

Registre o conector no terminal:

claude mcp add --transport http leading-bi https://mcp-server.leadingbi.app.br/mcp

Em uma sessão do Claude Code, digite /mcp, selecione leading-bi e escolha a opção de autenticação. O navegador abre a página da LeadingBI, na qual o Token de Acesso deve ser colado.
Concluída a autenticação, as consultas ficam disponíveis nas conversas do Claude Code.

Outros aplicativos compatíveis com MCP

Qualquer aplicativo que aceite servidores MCP remotos (transporte HTTP) com autorização OAuth 2.1 pode utilizar o conector. Informe o endereço https://mcp-server.leadingbi.app.br/mcp na configuração de conectores do aplicativo; o registro do aplicativo é automático e, na etapa de autorização, a página da LeadingBI solicita o Token de Acesso.

Como desconectar e revogar o acesso

Desconectar o aplicativo: no Claude, em Configurações → Conectores, abra o conector da LeadingBI e escolha desconectar ou remover. No Claude Code, execute claude mcp remove leading-bi.
Revogar o Token de Acesso: no painel da LeadingBI, abra Tokens de API e clique em revogar na linha do token. A partir desse momento, nenhuma consulta é atendida com ele, em qualquer aplicativo.
Quando o aplicativo comunica a desconexão, a cópia do token guardada pelo conector é apagada imediatamente. Quando não comunica, a conexão expira após 90 dias sem uso, e a cópia é apagada na limpeza periódica seguinte.

Em caso de suspeita de vazamento do token, revogue-o no painel e gere um novo.

Limites e cuidados

Somente leitura. O conector apenas consulta dados; nenhuma informação é criada, alterada ou apagada.
Cálculos fiscais são estimativas. Fator R, limites do Simples Nacional e receita bruta são calculados com os dados da contabilidade e da folha. O valor oficial é sempre o declarado ao fisco, e as decisões cabem ao cliente com o seu contador.
Os dados refletem o que está registrado. As respostas dependem da escrituração contábil e do processamento da folha. Um mês sem lançamentos é um mês sem dados, e não um valor igual a zero.
Informações não disponíveis: notas fiscais; livros fiscais e apurações de ICMS, ISS, PIS/COFINS, IPI, IRPJ e CSLL; declarações e guias oficiais (PGDAS-D, DAS, DCTFWeb, DARF, SPED, EFD-Reinf, eSocial); atividade econômica (CNAE) e regime tributário; extratos e conciliação bancária; certidões, parcelamentos e situação fiscal; contribuição patronal sobre a folha.
Privacidade de colaboradores. O motivo de afastamentos não é entregue pelo conector. Dados pessoais, como CPF e salário, só devem ser solicitados quando necessários.
Volume de dados. A consulta de lançamentos do razão aceita períodos de até 90 dias por vez; consultas muito amplas podem exceder o tempo limite e devem ser restringidas por empresa, período ou conta. Há também um limite de consultas por intervalo de tempo.
Confira os números importantes. Assistentes de IA podem interpretar mal um pedido. As respostas informam a empresa, o período e a base utilizados, o que permite a conferência.

Solução de problemas

Mensagens exibidas na página de conexão:

Mensagem	O que fazer
"Token inválido ou expirado."	Confira se o token foi copiado por inteiro e se não expirou nem foi revogado. Se necessário, gere um novo no painel.
"Muitas tentativas."	Aguarde o tempo indicado e tente novamente.
"Não foi possível validar o token agora."	Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte.
Página "Link expirado"	A página de conexão vale por 10 minutos e só pode ser usada uma vez. Inicie a conexão novamente pelo aplicativo de IA.

Mensagens repassadas pelo assistente durante as consultas:

Mensagem	O que fazer
"Sua conexão não é mais válida, pois o Token de Acesso foi revogado ou expirou."	Gere um novo Token de Acesso no painel, desconecte o conector no aplicativo e conecte-o novamente com o novo token.
"Acesso não permitido a esta informação."	O módulo pode não estar habilitado para a conta, ou o usuário pode não ter acesso à empresa. Solicite o acesso ao administrador da conta.
"Nenhum registro foi encontrado para os parâmetros informados."	Confira o código da empresa, a competência ou o período informados.
"O módulo consultado não está configurado corretamente para a sua conta."	Entre em contato com o administrador da conta para regularizar a configuração.
"O limite de consultas permitido foi atingido."	Aguarde o tempo indicado e repita o pedido.
"A consulta excedeu o tempo limite de resposta."	Restrinja o pedido por empresa, período ou conta e tente novamente.
"Não foi possível obter os dados neste momento, em razão de uma falha temporária ou de uma consulta pesada demais."	Tente novamente em alguns instantes ou restrinja o pedido.
"Não foi possível estabelecer comunicação com o serviço de dados neste momento."	Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte.
O aplicativo pede para conectar novamente	A conexão expirou após um período sem uso. Refaça a conexão com um Token de Acesso válido.
O assistente não utiliza o conector	Verifique se o conector está ativado na conversa e mencione, no pedido, a empresa e o período desejados.

Segurança e privacidade

O Token de Acesso nunca é entregue ao assistente de IA. Ele é guardado criptografado pelo conector, e o aplicativo recebe credenciais próprias da conexão, que podem ser revogadas a qualquer momento.
A conversa com o assistente não chega ao conector: ele recebe apenas o nome da consulta e os parâmetros escolhidos pelo assistente.
Os dados consultados não são armazenados pelo conector; são entregues ao aplicativo de IA escolhido pelo usuário.
Toda a comunicação usa HTTPS, e as permissões de empresa e de módulo são verificadas a cada consulta.

Os detalhes estão na Política de privacidade.

Informações para administradores de TI

Item	Detalhe
Endereço do servidor MCP	`https://mcp-server.leadingbi.app.br/mcp` (transporte HTTP do MCP)
Autorização	OAuth 2.1 com registro dinâmico de cliente e PKCE (S256), com servidor de autorização próprio
Metadados OAuth	`/.well-known/oauth-authorization-server` e `/.well-known/oauth-protected-resource/mcp`
Autenticação do usuário	Token de Acesso gerado no painel da LeadingBI, com validade de 1 a 12 meses, informado na página de conexão
Token de acesso da conexão	Validade de 1 hora
Token de renovação da conexão	Validade de 90 dias, renovado a cada uso; a conexão expira após 90 dias sem uso
Permissões	Somente leitura; empresas e módulos verificados a cada consulta conforme as permissões do usuário
Dados armazenados	Cadastro do aplicativo cliente, cópia criptografada do Token de Acesso, tokens da conexão apenas como resumo criptográfico (SHA-256) e registro de uso mantido por 180 dias
Dados não armazenados	Conversas e dados de negócio consultados
Revogação	Desconexão no aplicativo (revogação imediata da conexão) ou revogação do Token de Acesso no painel
Contato de segurança	suporte@leadingbd.com.br, também publicado no endereço padrão de divulgação de segurança (RFC 9116): `/.well-known/security.txt`

Suporte

Dúvidas, problemas de conexão e relatos de segurança: suporte@leadingbd.com.br. Informe a conta, o aplicativo de IA utilizado, a data e o horário aproximados e a mensagem exibida. Nunca envie o Token de Acesso por e-mail.

LeadingBI: https://www.leadingbi.com.br/