DEV Community

SFA
SFA

Posted on

Como fazer a IA emitir sua nota fiscal (NF-e e NFS-e) usando MCP

#mcp #ai #automation #opensource

Todo mundo hoje tem um assistente de IA — ChatGPT, Claude, Cursor. Eles escrevem código, resumem contrato, respondem e-mail. Mas quando você pede "emite uma nota fiscal pra esse cliente", eles travam: a IA não tem acesso aos sistemas que realmente emitem a nota.

Resolvi esse buraco com um projeto open-source chamado nota-fiscal-mcp. Ele é um servidor MCP (Model Context Protocol) que dá ao seu agente de IA o poder de emitir, consultar e cancelar NF-e e NFS-e de verdade.

Na prática, a conversa fica assim:

Você:   emita uma NFS-e de R$ 500 de consultoria em TI para o cliente ACME
Claude: ✅ NFS-e emitida — nota nº 3070, autorizada. Aqui está o PDF e o XML.
Enter fullscreen mode Exit fullscreen mode

Sem abrir sistema, sem preencher formulário, sem decorar código de serviço.

O que é MCP, rapidamente

MCP é um padrão aberto que conecta assistentes de IA a ferramentas e sistemas externos. Em vez de a IA só "falar", ela passa a agir — chamar funções que você expõe. O nota-fiscal-mcp expõe seis funções:

Ferramenta O que faz
emitir_nfse / emitir_nfe Emite a nota
consultar_nfse / consultar_nfe Consulta status, XML e PDF
cancelar_nfse / cancelar_nfe Cancela uma nota autorizada

Como a parte fiscal funciona (sem virar um pesadelo)

Emitir nota no Brasil é complexo: certificado digital, comunicação com a SEFAZ, regras que mudam por município. O nota-fiscal-mcp não reinventa isso — ele conversa com um provedor que já resolve tudo (hoje a Focus NFe, que tem ambiente de testes). Você usa a sua conta e o seu token; nada passa por servidores de terceiros.

Instalando no Claude Desktop

Abra o claude_desktop_config.json e adicione:

{
  "mcpServers": {
    "nota-fiscal": {
      "command": "npx",
      "args": ["-y", "nota-fiscal-mcp"],
      "env": {
        "FOCUS_NFE_TOKEN": "seu_token_aqui",
        "FOCUS_NFE_AMBIENTE": "homologacao"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Reinicie o Claude Desktop e pronto: as seis ferramentas aparecem para o agente.

Quer testar sem token nenhum? Rode em modo simulação com "env": { "PROVIDER": "mock" } e exercite tudo de ponta a ponta.

Por que eu fiz isso

Trabalho com ERP e integração fiscal há anos, e sempre vi a mesma dor: emitir nota é burocrático e preso a telas. Com os agentes de IA ganhando a capacidade de executar tarefas, fazia todo sentido tirar a nota fiscal da tela e colocá-la na conversa.

É open-source (MIT) e está no npm e no registro oficial de MCP. Contribuições, issues e ideias são bem-vindas:

👉 https://github.com/FAVIOSENGER/nota-fiscal-mcp

Se você trabalha com emissão de notas e usa IA no dia a dia, instala lá e me conta o que achou.

Top comments (0)