Servidor MCP fiscal: fazendo uma IA emitir nota fiscal de verdade

O Model Context Protocol (MCP) é um padrão aberto para dar ferramentas a um assistente de IA. Em vez de o modelo apenas escrever texto sobre nota fiscal, ele passa a poder chamar funções: consultar um CNPJ, descobrir o NCM de um produto, verificar se a SEFAZ está no ar, emitir a nota.

Aplicado ao domínio fiscal brasileiro, isso muda o tipo de trabalho que dá para delegar. E também introduz um risco novo que vale entender antes de sair conectando.

O que é, sem jargão

Um servidor MCP expõe uma lista de ferramentas, cada uma com nome, descrição e o formato dos argumentos que aceita. O cliente (Claude, ChatGPT, Cursor, Copilot) lê essa lista e decide quando usar cada uma. Você não escreve código de integração: você informa uma URL e uma credencial.

A diferença em relação a "a IA escreveu meu código de integração" é grande. No segundo caso, você ainda precisa revisar, compilar e rodar. No MCP, a ação acontece na hora, dentro da conversa.

Como fica na prática

Uma conversa real com o servidor MCP do AceleraAPI conectado se parece com isto:

Você: emita uma NF-e de 2 camisetas a R$ 49,90 para o CNPJ 11.222.333/0001-81

E o assistente, antes de emitir, encadeia as verificações que um desenvolvedor experiente faria:

1. status_sefaz — o autorizador da UF está operacional?
2. consultar_cnpj — o destinatário existe e está ativo?
3. classificar_produto — qual o NCM correto para camiseta?
4. pede confirmação ao usuário, informando o valor total;
5. emitir_documento — e devolve número, chave e protocolo.

O ganho não é a emissão em si — isso uma chamada de API já fazia. É a cadeia de verificação acontecer sem ninguém escrever o passo a passo.

O risco novo, e como o protocolo trata

Emitir documento fiscal em produção tem efeito tributário e não pode ser desfeito — apenas cancelado, dentro do prazo legal. Um assistente que emite nota sem confirmação é um problema, não um recurso.

O MCP tem um mecanismo para isso: cada ferramenta declara anotações sobre o que ela faz. As duas que importam aqui:

No nosso servidor, emitir_documento e cancelar_documento são declaradas como destrutivas e não idempotentes. Quem exibe a confirmação é o cliente MCP, não nós — o que é melhor, porque a confirmação aparece na interface que a pessoa está usando.

Conectando

O servidor do AceleraAPI é HTTP — não há pacote para instalar nem processo local para manter. No arquivo de configuração do cliente:

{
  "mcpServers": {
    "aceleraapi": {
      "type": "http",
      "url": "https://aceleraapi.com.br/mcp",
      "headers": { "Authorization": "Bearer ace_SEU_TOKEN" }
    }
  }
}

Salve, reinicie o cliente, e as ferramentas aparecem. Para conferir antes que a credencial funciona:

curl -X POST https://aceleraapi.com.br/mcp \
  -H "Authorization: Bearer ace_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A lista completa de ferramentas e as instruções por cliente estão em /mcp.

O que muda no custo e na auditoria

Nada. As chamadas do assistente passam pela mesma API, com o mesmo token, o mesmo limite de requisições e o mesmo preço por requisição bem-sucedida. Aparecem no seu relatório de consumo com rota e status, o que significa que dá para auditar exatamente o que o assistente fez — algo que vale mais do que parece na primeira vez que alguém pergunta "quem emitiu essa nota?".

Vale usar em produção?

Para consulta e diagnóstico, sim, sem ressalva: descobrir NCM, conferir CNPJ, ver se a SEFAZ caiu. É trabalho repetitivo e reversível.

Para emissão, a recomendação honesta é começar em homologação. Não por limitação técnica, mas porque vale ver com os próprios olhos como o assistente monta o payload antes de deixá-lo fazer isso com efeito tributário. Homologação é grátis e não consome requisição.

Perguntas frequentes

Funciona no ChatGPT e no Cursor, ou só no Claude?

Em qualquer cliente que fale MCP por HTTP. O protocolo é aberto e o transporte é o padrão — não há nada específico de um fornecedor no nosso lado.

A IA pode inventar dados na nota?

Pode errar, como erraria um humano apressado — e é por isso que a confirmação existe. Leia o resumo antes de confirmar, especialmente valores e CNPJ do destinatário.

Preciso de MCP para usar IA com a API?

Não. Outra via é dar o contexto da API inteira ao assistente e pedir o código: o llms-full.txt existe para isso. MCP é para a IA operar; o llms-full.txt é para ela programar.