MCP fiscal

O que é MCP fiscal, em palavras simples?

MCP é a sigla de Model Context Protocol, um protocolo que padroniza a forma como assistentes e agentes de inteligência artificial se conectam a ferramentas e dados externos. Em vez de cada integração ser feita de um jeito diferente, o MCP define uma linguagem comum para o agente descobrir o que pode fazer e pedir a execução.

Quando esse protocolo é aplicado a um sistema de emissão de notas, chamamos de MCP fiscal. Na prática, é uma porta de entrada pela qual um agente de IA consegue, por exemplo, perguntar quais NF-e foram rejeitadas hoje ou pedir o PDF de uma NFS-e específica, sem que alguém precise abrir telas ou escrever código para isso.

Para que serve o MCP fiscal?

O MCP fiscal serve para que tarefas fiscais repetitivas ou de consulta possam ser feitas por meio de conversa ou de automações inteligentes. Um analista pode pedir ao assistente um resumo das notas emitidas no mês, e o agente busca os dados direto no emissor.

Também ajuda equipes de suporte e operação a investigar problemas mais rápido, como identificar o motivo de rejeição de um documento, conferir o status de um CT-e ou verificar se um MDF-e já foi encerrado. Ações que alteram documentos, como emitir ou cancelar, podem ser liberadas apenas quando houver autorização explícita.

Como funciona o MCP fiscal?

O provedor fiscal disponibiliza um servidor MCP que expõe um conjunto de ferramentas, como consultar documento, listar notas por filtro, baixar XML ou cancelar nota. O agente de IA se conecta a esse servidor, recebe a lista de ferramentas disponíveis e decide qual chamar de acordo com o pedido do usuário.

A comunicação entre o agente e o servidor normalmente usa mensagens no formato JSON-RPC. O servidor recebe o pedido, verifica se aquela credencial tem permissão, executa a operação no emissor fiscal e devolve o resultado, que o agente transforma em uma resposta compreensível.

Qual a diferença entre MCP fiscal e API fiscal?

A API fiscal é feita para sistemas: um ERP ou plataforma de vendas envia requisições programadas, com campos definidos, para emitir e consultar documentos. Exige que um desenvolvedor escreva o código da integração.

O MCP fiscal é feito para agentes de IA: ele descreve as ferramentas de modo que o próprio agente entenda o que cada uma faz e quando usá-la. Os dois podem conviver. É comum o sistema principal emitir notas pela API, enquanto o MCP é usado para consultas, análises e ações pontuais conduzidas por um assistente.

O MCP fiscal é seguro?

A segurança depende de como o servidor MCP é configurado. Boas implementações exigem autenticação, limitam o que cada credencial pode fazer e separam permissões de leitura das permissões de escrita, como emitir ou cancelar.

Outro ponto essencial é o registro de cada ação executada pelo agente, formando uma trilha de auditoria. Assim, a empresa consegue saber quem autorizou, qual ferramenta foi chamada e qual foi o resultado, o que é importante em operações com valor fiscal.

Exemplos de MCP fiscal

• Um gestor financeiro pede ao assistente de IA: 'Liste as NFS-e rejeitadas nesta semana e explique o motivo de cada uma'. O agente consulta o emissor via MCP fiscal e devolve a lista com os motivos de rejeição.
• Uma equipe de suporte de um marketplace usa um agente conectado ao MCP fiscal para localizar a NF-e de um pedido pelo número e enviar o PDF e o XML ao cliente.
• Uma empresa de logística configura o MCP fiscal com permissão apenas de leitura, para que o agente verifique quais MDF-e ainda estão abertos, sem poder encerrá-los ou cancelá-los.
• Um contador pede ao assistente um resumo da quantidade de NFC-e emitidas por CNPJ no mês, e o agente monta o relatório a partir dos dados consultados.