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
- O que é o Jettax MCP
- Planos: MCP Essencial e MCP Premium
- Contratação e ativação
- Como conectar o seu assistente de IA
- Como ligar o MCP Premium por empresa
- Acesso do cliente do escritório
- Perguntas de exemplo
- Mensagens do sistema e limites
- Segurança e privacidade
- Perguntas frequentes
- 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:
| Perfil | Como acessa | O que enxerga |
|---|---|---|
| Administrador do escritório | Token de API do escritório | A carteira inteira do escritório |
| Cliente do escritório (usuário da empresa) | Token de acesso gerado pelo escritório no cadastro do cliente | Somente a própria empresa, e apenas se ela estiver no MCP Premium |
| Funcionário do escritório | Ainda não disponível | Nada, 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.
| Recurso | MCP Essencial | MCP Premium |
|---|---|---|
| Empresas cobertas | Todas as empresas do escritório | Todas no nível Essencial e, no nível Premium, as que o escritório ativar |
| Histórico disponível | 3 meses, contando o mês corrente | 12 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 auditoria | Sim | Sim |
| Produtos, margem por produto, cotação de fornecedores, venda cruzada | Não | Sim, nas empresas ativadas |
| Roteiros prontos | 6 roteiros do Essencial | 6 do Essencial e 4 do Premium |
| Acesso do cliente do escritório | Não | Sim, 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.
- O CS ativa o módulo MCP Essencial ou MCP Premium no seu contrato.
- 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.
- 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.
- 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
- Nas configurações do assistente, adicione um conector remoto com a URL acima. No Claude, o caminho é Configurações > Conectores > Adicionar conector personalizado.
- 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.
- 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
- Abra o cliente, ligue o switch “MCP Premium” e salve. A data de ativação aparece ao lado do nome.
- Em até 10 minutos começa a carga de 12 meses da empresa, com produtos e itens.
- 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.
- 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
- 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.
- 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).
- 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.
- 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)
| Roteiro | Pergunta | O que a resposta traz |
|---|---|---|
| Fechamento do mês da carteira | Como 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 queda | Quais 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 carteira | Quais 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 carteira | Quais 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)
| Roteiro | Pergunta | O que a resposta traz |
|---|---|---|
| Maiores clientes e fornecedores | Quem 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ês | Como 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)
| Roteiro | Pergunta | O que a resposta traz |
|---|---|---|
| Margem por produto | Quais 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 fornecedores | Para 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 cliente | O 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 trimestral | Monte 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:
| Mensagem | Quando acontece | O que fazer |
|---|---|---|
| Token não reconhecido | Token errado, de usuário inativo, de funcionário, ou token de API de usuário de empresa | Escritó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 contrato | Fale 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 Essencial | Use 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 Premium | Ligue 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 andamento | Aguarde 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 empresa | Use 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 plano | Refaç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 Premium | Restrinja a pergunta às empresas no Premium ou ao período de 3 meses |
| EMPRESA_NAO_ENCONTRADA / EMPRESA_AMBIGUA | O nome informado não corresponde a nenhuma empresa, ou corresponde a várias | Informe a razão social, o nome fantasia ou o CNPJ |
| DADOS_INDISPONIVEIS | A fonte de dados ainda não foi carregada para o escritório | Aguarde 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.

Perguntas frequentes
Posso usar no celular?
Sim, nos aplicativos do Claude e do ChatGPT, depois de conectar uma vez pelo site ou pelo aplicativo de desktop.
Quantas pessoas do escritório podem usar?
Por enquanto, quem tem o token do administrador. O acesso de funcionários com usuário próprio ainda não está liberado.
Meu cliente pode perguntar sobre a empresa dele?
Sim, com o módulo MCP Premium, a empresa ativada no Premium e um token gerado pelo escritório no cadastro do cliente. Ele enxerga apenas a própria empresa.
Liguei o MCP Premium e a margem não responde.
A carga dos 12 meses ainda está em andamento. A mensagem informa quantos meses já estão prontos. Totais e rankings da empresa já funcionam.
O número veio menor do que eu esperava.
Peça ao assistente o volume considerado e as empresas sem captura. Notas ainda não capturadas na Sefaz não entram no cálculo.
Consigo ver dados do ano passado?
No MCP Premium, 12 meses da empresa ativada. No Essencial, 3 meses.
A margem por produto é a margem contábil?
Não. O custo é o de reposição, calculado pelas compras do mesmo item, com o frete de entrada rateado. É uma margem comercial, pensada para decisões de preço e compra.
Desliguei uma empresa do Premium por engano.
Religue em até 30 dias e ela volta pronta, sem nova carga.
Perdi o token do cliente.
Gere um novo no cadastro do cliente. O anterior deixa de funcionar e o cliente precisa autorizar o assistente novamente.
O assistente pode alterar algo no Jettax 360?
Não. O conector é somente leitura.
Posso conectar mais de um assistente com o mesmo token?
Sim. O token identifica o usuário, não o aplicativo.
O que o CS da Jettax vê do meu uso?
Um relatório mensal com quantas empresas estiveram no Premium, o pico simultâneo e as trocas. O CS não vê as suas perguntas.
Preciso de uma conta no Claude ou no ChatGPT?
Sim. A Jettax fornece o conector; o assistente é o que você já usa. Conectores remotos exigem os planos pagos desses assistentes.