16 nov 2026 • 11 min de leitura
Artigo atualizado 16 nov 2026

O Jettax IA conecta a sua carteira de notas fiscais e auditorias ao assistente de IA que você já usa, como Claude, ChatGPT ou Cursor. Assim, você faz perguntas em linguagem natural e recebe as respostas com os dados do Jettax 360. Neste guia, você vai ver o que muda entre o MCP Essencial e o MCP Premium, como conectar o assistente com o token de API, como liberar o acesso para os clientes do escritório e o que fazer quando aparecer cada mensagem de erro.

Neste artigo, você vai aprender o que é o assistente de IA da Jettax (MCP), o que cada plano oferece, como conectar o seu assistente, como liberar o acesso para os seus clientes e o que fazer quando aparecer alguma mensagem de erro.

Índice

  1. O que é o Jettax MCP
  2. Planos: MCP Essencial e MCP Premium
  3. Contratação e ativação
  4. Como conectar o seu assistente de IA
  5. Como ligar o MCP Premium por empresa
  6. Acesso do cliente do escritório
  7. Perguntas de exemplo
  8. Mensagens do sistema e limites
  9. Segurança e privacidade
  10. Perguntas frequentes
  11. Glossário

1. O que é o Jettax MCP

O Jettax MCP permite que você pergunte, em linguagem natural, sobre as notas fiscais e as auditorias da sua carteira usando o assistente de IA que você já usa, como Claude, ChatGPT, Claude Code, Cursor e outros.

A Jettax não oferece um chat próprio: ela disponibiliza um conector no padrão MCP (Model Context Protocol), e o seu assistente consulta esse conector para responder.

O que você consegue fazer:

  • Fechar o mês da carteira: faturamento por empresa, quem cresceu e quem caiu, pendências de auditoria por família.
  • Ver rankings de clientes e fornecedores de uma empresa, evolução mês a mês e comparação entre períodos.
  • Fazer um check-up de IBS/CBS nas notas emitidas.
  • No MCP Premium, por empresa: margem por produto, cotação de fornecedores, venda cruzada e relatório gerencial trimestral.

O que o MCP não faz:

  • Não altera nada no Jettax 360 (é somente leitura).
  • Não lista notas uma a uma em grande volume.
  • Não responde sobre períodos além do histórico do seu plano.

Quem pode usar:

PerfilComo acessaO que enxerga
Administrador do escritórioToken de API do escritórioA carteira inteira do escritório
Cliente do escritório (usuário da empresa)Token de acesso gerado pelo escritório no cadastro do clienteSomente a própria empresa, e apenas se ela estiver no MCP Premium
Funcionário do escritórioAinda não disponívelNada, por enquanto

As respostas chegam no formato brasileiro: datas em dd/mm/aaaa, competências em mm/aaaa e valores em R$ 1.234,56, no horário de Brasília.

2. Planos: MCP Essencial e MCP Premium

O MCP Essencial cobre a carteira inteira com totais e rankings. O MCP Premium inclui tudo do Essencial e adiciona a análise por produto, liberada empresa a empresa pelo escritório.

RecursoMCP EssencialMCP Premium
Empresas cobertasTodas as empresas do escritórioTodas no nível Essencial e, no nível Premium, as que o escritório ativar
Histórico disponível3 meses, contando o mês corrente12 meses para as empresas no Premium; 3 meses para as demais
Totais, rankings de clientes e fornecedores, comparação de períodos, pendências de auditoriaSimSim
Produtos, margem por produto, cotação de fornecedores, venda cruzadaNãoSim, nas empresas ativadas
Roteiros prontos6 roteiros do Essencial6 do Essencial e 4 do Premium
Acesso do cliente do escritórioNãoSim, nas empresas ativadas
Como aparece no cadastro do cliente“MCP Essencial”, com a marca “Incluída”Switch “MCP Premium”

Sobre o histórico: se você perguntar sobre um período mais antigo que o permitido pelo plano, o assistente informa a data a partir da qual há dados, em vez de mostrar zero. No Premium, para somar a carteira em um período anterior a 3 meses, todas as empresas envolvidas precisam estar no Premium; caso contrário, o total sairia menor que o real.

3. Contratação e ativação

A ativação é feita pelo time de CS da Jettax no contrato do escritório. Não há nada para instalar. Para contratar, fale com o CS pelo e-mail cs@jettax.com.br.

  1. O CS ativa o módulo MCP Essencial ou MCP Premium no seu contrato.
  2. Em até 5 minutos a Jettax começa a carregar os documentos da janela do plano: 3 meses de todas as empresas e 12 meses das que estiverem marcadas no Premium.
  3. A carga inicial leva de alguns minutos a algumas horas, conforme o tamanho da carteira. Durante esse período as perguntas já são respondidas com o que foi carregado, e o assistente informa o volume considerado em cada resposta.
  4. Você pega o seu token em Escritório > Configurações e conecta o assistente (veja a próxima seção).

Se o módulo for desligado: o acesso é recusado na hora, com a mensagem de módulo não contratado, e os dados carregados para o MCP são apagados.

4. Como conectar o seu assistente de IA

Você vai precisar de duas informações:

  • URL do conector: https://mcp.jettax360.com.br/mcp
  • Token de API: no Jettax 360, menu Escritório > Configurações, card “API Token Jettax”. É o token do usuário administrador do escritório.

Importante: trate o token como uma senha. Não compartilhe com pessoas fora do escritório.

Claude (claude.ai ou Claude Desktop) e ChatGPT

  1. Nas configurações do assistente, adicione um conector remoto com a URL acima. No Claude, o caminho é Configurações > Conectores > Adicionar conector personalizado.
  2. O assistente abre a tela de autorização da Jettax. Cole o token e clique em Autorizar. A tela mostra o nome do assistente e o que ele poderá consultar.
  3. Volte ao assistente e faça a sua pergunta.

O token não fica salvo na tela de autorização. A autorização vale por 1 hora e renova automaticamente por até 30 dias de uso.

Claude Code, Cursor, Windsurf e outros

Nessas ferramentas, o token vai direto no cabeçalho da conexão. Exemplo para o Claude Code:

claude mcp add --transport http jettax https://mcp.jettax360.com.br/mcp --header "Authorization: Bearer SEU_TOKEN"

Substitua SEU_TOKEN pelo seu token de API.

Sua primeira pergunta

Experimente: “O que você sabe sobre a minha carteira?” ou “Como foi o mês passado na carteira?”. O assistente começa consultando o contexto, que traz o escritório, as empresas, o plano, o histórico disponível e sugestões de perguntas para o mês e o trimestre fechados.

Roteiros prontos

Nos assistentes que mostram prompts do conector (como Claude Desktop e Cursor), o menu lista os roteiros prontos, por exemplo “Fechamento do mês da carteira”. Escolha um, informe a competência ou a empresa, e o assistente executa os passos certos. No Essencial, aparecem apenas os roteiros do Essencial.

Apareceu “Token não reconhecido”?

  • Confira se você copiou o token inteiro do card “API Token Jettax”.
  • Confirme que o usuário dono do token está ativo.
  • Verifique se é o token do administrador do escritório, e não de um funcionário ou de um usuário de empresa.

5. Como ligar o MCP Premium por empresa

Com o módulo MCP Premium contratado, o escritório escolhe quais empresas entram no nível Premium. O switch fica no cadastro do cliente, seção Módulos.

Ligar

  1. Abra o cliente, ligue o switch “MCP Premium” e salve. A data de ativação aparece ao lado do nome.
  2. Em até 10 minutos começa a carga de 12 meses da empresa, com produtos e itens.
  3. Enquanto a carga roda, a empresa fica “em preparação”: totais, rankings e pendências já respondem, mas margem, produtos e cotação mostram uma mensagem com o andamento (por exemplo, “4 de 12 meses prontos”). Isso evita uma margem calculada com metade dos meses.
  4. Quando todos os meses estiverem prontos, a empresa passa a responder no Premium. Meses sem nota também contam como carregados.

Desligar

Ao desligar o switch, a empresa sai do Premium na hora. Os dados detalhados ficam guardados por 30 dias: se você religar nesse prazo, a empresa volta pronta, sem nova carga. Depois disso, uma nova ativação recarrega tudo.

Em lote

As planilhas de clientes têm a coluna “Habilitar MCP Premium” (1 para ligar, 0 para desligar) na exportação, na importação e na atualização em lote. No modelo de importação, é a coluna J.

O switch não liga?

  • O switch só fica disponível com o módulo MCP Premium no contrato. Sem ele, aparece desabilitado com a mensagem “É necessário contratar o módulo MCP para ativar este item”.
  • Com o MCP Essencial, no lugar do switch aparece “MCP Essencial” com a marca “Incluída”, porque todas as empresas já estão nesse nível.
  • Se o módulo acabou de ser contratado e o switch continua travado, abra um chamado com o nosso suporte.

Acompanhamento de uso

Não há limite automático de empresas no Premium. O time de CS acompanha o uso por um relatório mensal, com a quantidade de empresas que estiveram no Premium, o pico de empresas ao mesmo tempo e o número de trocas.

6. Acesso do cliente do escritório

Com o MCP Premium, o escritório pode dar ao seu cliente (a empresa) um token próprio. Com ele, o cliente conecta o assistente de IA dele e consulta somente a própria empresa, em modo leitura, com as mesmas perguntas do Premium. As consultas de carteira não aparecem para esse usuário.

Como gerar o token do cliente

  1. No cadastro do cliente, com o switch MCP Premium ligado, clique na engrenagem ao lado de “MCP Premium”. A engrenagem só aparece para cliente já salvo.
  2. Abre a janela “Acesso do cliente ao MCP Premium”, com o status atual (“Cliente ainda sem acesso” ou “Acesso do cliente ativo”, com data e autor da última geração).
  3. Clique em “Gerar token”. O token aparece uma única vez, com botão de copiar, junto de uma mensagem pronta para enviar ao cliente com o token, a URL e o passo a passo de conexão. A janela só fecha depois que você confirmar que copiou.
  4. Envie a mensagem ao cliente por e-mail ou WhatsApp.

Observações:

  • O token passa a funcionar depois que o cadastro é salvo com o MCP Premium ligado e a carga da empresa termina.
  • Somente o administrador do escritório pode gerar ou revogar o token.
  • A empresa precisa estar ativa.
  • Cada empresa tem no máximo um token ativo. O token de API de um usuário de empresa no Jettax 360 não dá acesso ao MCP; é preciso usar o token gerado nesta janela.

Gerar de novo ou revogar

  • Gerar de novo: invalida o token anterior na hora. O cliente precisa receber o novo token e autorizar o assistente novamente.
  • Revogar acesso: corta o acesso do cliente imediatamente. A empresa continua no MCP Premium para o escritório.

O que o cliente vê

Ao conectar, o cliente vê a mesma tela de autorização da Jettax, onde cola o token recebido. Depois disso, o assistente lista apenas a empresa dele. Se a empresa sair do Premium ou ainda estiver em preparação, o cliente recebe uma mensagem pedindo para falar com o escritório ou aguardar.

7. Perguntas de exemplo

Estas perguntas são as mesmas usadas nos roteiros prontos do conector. Você pode usá-las exatamente como estão, trocando o mês ou o nome da empresa.

MCP Essencial: carteira (somente escritório)

RoteiroPerguntaO que a resposta traz
Fechamento do mês da carteiraComo foi setembro na carteira: faturamento, quem cresceu, quem caiu e onde estão as pendências?Faturamento de venda por empresa, maiores altas e quedas contra o mês anterior, pendências por família com o valor impactado
Radar de crescimento e quedaQuais empresas da carteira mais cresceram e mais caíram no 3º trimestre em relação ao 2º?Variação de valor e de quantidade de notas por empresa, com aviso de período parcial ou captura ativa
Check-up IBS/CBS da carteiraQuais empresas do regime normal emitiram sem IBS/CBS em setembro?Empresas sem destaque do IBS/CBS e os valores destacados pelas demais, com a ressalva da fase de transição
Pendências de auditoria da carteiraQuais empresas têm mais pendências de auditoria em setembro e de que tipo?Ranking de empresas por valor impactado e distribuição por família de alerta

MCP Essencial: por empresa (escritório e cliente)

RoteiroPerguntaO que a resposta traz
Maiores clientes e fornecedoresQuem são os 10 maiores clientes e fornecedores da Padaria Central em setembro, e quanto cada um representa?Dois rankings com a participação de cada um e alerta de concentração acima de 20%
Faturamento mês a mêsComo evoluiu o faturamento de venda da Padaria Central mês a mês?Série mensal de venda com a variação e as devoluções ao lado

MCP Premium: por empresa ativada (escritório e cliente)

RoteiroPerguntaO que a resposta traz
Margem por produtoQuais produtos da Padaria Central dão mais lucro, e quais vendem perto ou abaixo do custo?Produtos que mais contribuem, os de margem baixa ou negativa e a cobertura de custo. O custo é o de reposição pelas compras, não o CMV contábil
Cotação de fornecedoresPara os itens que a Padaria Central mais compra, quem vende mais barato?Fornecedor mais barato e mais caro por item, diferença em reais e percentual, itens de fornecedor único
Venda cruzada para um clienteO que a Padaria Central pode oferecer para o cliente Mercado Bom Preço que ele ainda não compra?Produtos sugeridos, o motivo (o que clientes parecidos compram) e o potencial
Relatório gerencial trimestralMonte o relatório gerencial do 3º trimestre da Padaria Central.Faturamento e tendência, clientes e concentração, compras e fornecedores, margem por produto, oportunidades de compra e pendências fiscais

Outras perguntas que funcionam

  • Quantas notas a carteira recebeu em agosto, por modelo?
  • Qual foi o total de compras da Padaria Central no último trimestre, por fornecedor?
  • Quais empresas estão sem captura de notas nos últimos 30 dias?
  • Quanto a Padaria Central pagou de frete de entrada em setembro? (No Premium, com o frete rateado por produto no custo.)
  • Compare as vendas de julho e agosto da Padaria Central com o mesmo número de dias.
  • Quais alertas de auditoria do tipo HN38 estão pendentes na carteira?
  • O que significa o CFOP 5102?

O que não funciona, e o que você verá

  • Pedir produto ou margem no Essencial: o assistente explica que o recurso faz parte do Premium e indica o contato do CS.
  • Pedir margem de uma empresa fora do Premium: o assistente informa que a empresa não está no Premium e que totais e rankings continuam disponíveis.
  • Pedir um período anterior ao histórico do plano: o assistente informa a data a partir da qual há dados.
  • Pedir para alterar, emitir ou cancelar algo: não é possível, o MCP apenas consulta.

8. Mensagens do sistema e limites

Quando uma consulta não pode ser atendida, o assistente recebe um código, uma mensagem e uma sugestão, e repassa para você. Veja o que fazer em cada caso:

MensagemQuando aconteceO que fazer
Token não reconhecidoToken errado, de usuário inativo, de funcionário, ou token de API de usuário de empresaEscritório: confira o token em Escritório > Configurações. Cliente: use o token de acesso enviado pelo escritório. Confirme também se o usuário está ativo
MODULO_NAO_CONTRATADO
“O escritório não tem o módulo MCP da Jettax contratado”
O escritório não tem o MCP Essencial nem o MCP Premium ativo no contratoFale com o CS em cs@jettax.com.br. Se o módulo foi ativado há pouco, aguarde até 5 minutos
NIVEL_INSUFICIENTE (plano)
“… faz parte do MCP Premium, e o escritório tem o módulo MCP Essencial”
Pedido de produto, margem ou cotação em escritório com MCP EssencialUse as perguntas do Essencial ou fale com o CS para contratar o MCP Premium
NIVEL_INSUFICIENTE (empresa)
“A empresa X não está no MCP Premium”
Pedido de produto ou margem de uma empresa fora do PremiumLigue o switch MCP Premium no cadastro da empresa e salve
EM_PREPARACAO
“Os dados de produto ainda estão sendo preparados (4 de 12 meses prontos)”
Empresa recém-incluída no Premium, com a carga em andamentoAguarde a conclusão. Totais e rankings da empresa já respondem. Se passar de 2 horas, abra um chamado
PERFIL_SEM_ACESSO
“O acesso de funcionário do escritório ainda não está disponível” ou “A tool X é do escritório contábil”
Funcionário do escritório, usuário de empresa fora do Premium, ou consulta de carteira feita por usuário de empresaUse o token do administrador. Para cliente, confirme que a empresa está no Premium
LIMITE_EXCEDIDO (histórico)
“O histórico do plano é de 3 meses: há dados a partir de 08/2026”
Período que começa antes da janela do planoRefaça a pergunta dentro do período disponível, ou contrate o MCP Premium para ter 12 meses
LIMITE_EXCEDIDO (mistura)
“Fora do MCP Premium o histórico é de 3 meses…”
Soma da carteira em período anterior a 3 meses, incluindo empresas fora do PremiumRestrinja a pergunta às empresas no Premium ou ao período de 3 meses
EMPRESA_NAO_ENCONTRADA / EMPRESA_AMBIGUAO nome informado não corresponde a nenhuma empresa, ou corresponde a váriasInforme a razão social, o nome fantasia ou o CNPJ
DADOS_INDISPONIVEISA fonte de dados ainda não foi carregada para o escritórioAguarde a conclusão da carga inicial

Limites de uso

São 60 chamadas por minuto por usuário e 600 por escritório. Cada pergunta costuma gerar de 2 a 6 chamadas, então o limite só aparece em uso automatizado. Se for atingido, o assistente aguarda e tenta de novo.

Janelas de histórico

3 meses no Essencial e 12 meses no Premium, contando o mês corrente. A cada conversa, o assistente recebe as datas exatas disponíveis.

Bloco de contexto das respostas

Cada resposta traz o período aplicado, o volume considerado e as empresas sem captura. Assim o assistente consegue dizer, por exemplo, “3 empresas estão sem captura neste mês”, sem confundir falta de dado com falta de movimento. Dica: se um número parecer baixo, peça ao assistente esse detalhe.

9. Segurança e privacidade

O MCP é somente leitura e cada token enxerga um recorte fixo: o escritório inteiro ou uma única empresa. Nada do que o assistente faz altera o Jettax 360.

  • Permissões conferidas a cada consulta: o administrador vê a carteira, o usuário de empresa vê apenas a própria empresa e o funcionário é bloqueado. Empresas de outros escritórios nunca são exibidas.
  • Contrato conferido a cada consulta: sem módulo ativo, nada é respondido, mesmo com token válido.
  • Tokens: o token do escritório e o do cliente são credenciais e nunca aparecem nas respostas.
  • Tela de autorização: o token digitado não fica salvo. O assistente recebe uma autorização própria, válida por 1 hora e renovável por até 30 dias. Revogar o token do cliente ou inativar o usuário derruba o acesso na hora.
  • Dados de pessoa física: o CPF de contrapartes sai mascarado por padrão. Senhas, tokens, certificados digitais e suas senhas, credenciais de prefeitura e de integrações nunca são exibidos.
  • Textos livres das notas: descrições de produto e informações adicionais são tratadas como dados de terceiros. O assistente é instruído a não seguir instruções que apareçam dentro delas.
  • Volume por resposta: as consultas devolvem totais, rankings, comparações e listas paginadas. Não existe exportação em massa pelo MCP.
  • Onde os dados ficam: o MCP lê uma base resumida mantida pela Jettax, dentro da janela de histórico do plano. O seu assistente de IA recebe as perguntas e as respostas, como em qualquer uso. O tratamento da conversa pelo fornecedor do assistente (Anthropic, OpenAI e outros) segue os termos desse fornecedor, e não os da Jettax.
Banner Jettax IA

Perguntas frequentes