Em qualquer Software House ou ERP SaaS, o maior ralo de tempo do time de suporte N2/N3 não é desenvolver novas telas — é abrir ticket de cliente perguntando "por que a nota 4821 foi rejeitada?", procurar o JSON enviado, cruzar o código cStat com a tabela da SEFAZ e explicar qual campo o usuário preencheu errado.
Com o modo somente leitura (x-mcp-readonly: true) do @notaas/mcp, você consegue montar um pipeline de auto-triage fiscal: toda vez que um webhook invoice.rejected chega no seu backend, um agente de IA inspeciona a nota, consulta a cobertura/regras da cidade e devolve uma explicação em português claro com a correção exata para o operador do ERP — sem permissão para emitir, cancelar ou alterar nada em produção.
Como funciona o pipeline de Auto-Triage em Modo Read-Only
⚡ Arquitetura do Auto-Triage Fiscal Seguro:
- 1. Webhook de Rejeição (
HMAC-SHA256): Seu backend recebe o eventonfe.rejectedounfse.rejectedassinado pela Notaas.- 2. Agente com
x-mcp-readonly: true: O worker aciona um agente conectado ahttps://platform.notaas.com.br/api/mcpcom o headerx-mcp-readonly: true, liberando apenas as 21 tools de leitura e diagnóstico (consulta de documento, logs, cobertura municipal e triagem de erros).- 3. Diagnóstico Estruturado: O agente cruza o código de retorno (ex.: Rejeição 930
cBenef, Rejeição 694 DIFAL, Erro E637 Anexo VIII ou Rejeição 539) com o payload enviado e devolve: causa raiz, campo exato do ERP a ajustar e ação recomendada.- 4. Entrega no ERP / Slack / Ticket: O operador vê o diagnóstico pronto na tela do pedido em menos de 3 segundos, sem precisar abrir chamado para a engenharia.
Exemplos reais do que o Auto-Triage resolve instantaneamente
- Rejeição 694 (DIFAL): Identifica que o emitente é
CRT = 3, a venda é interestadual (idDest = 2) para consumidor final não contribuinte (indIEDest = 9) e indica o preenchimento do grupoICMSUFDest(EC 87/2015). - Rejeição 930 (
cBenef): Aponta que o CST20/40na UF do emitente exige o Código de Benefício Fiscal (cBenef). - Erro E363 / E637 (Anexo VIII): Cruza o item LC 116 com nossa tabela oficial de
NBS × cIndOp × cClassTrib(a mesma que alimenta nosso Validador Gratuito de XML IBS/CBS) e informa exatamente a tríade válida. - Rejeições CNC (
E0084/E0116): Orienta o cliente a conferir a Inscrição Municipal exata cadastrada no Portal Nacional (nfse.gov.br), conforme nosso guia de erros do CNC.
Por que x-mcp-readonly: true é essencial para compliance
Dar acesso irrestrito de escrita a um agente de suporte é um risco desnecessário. Com x-mcp-readonly: true aplicado no cabeçalho HTTP da conexão MCP da Notaas, a própria API recusa qualquer tentativa de chamada de mutação (emit_*, cancel_*, org_create_*), garantindo separação estrita de privilégios (least privilege) em ambiente de produção.
Para consultar rapidamente os códigos mais comuns da SEFAZ e do SNNFSE, confira também nosso Dicionário Unificado de Rejeições SEFAZ e NFS-e.

