Pular para o conteúdo
Fiscal

nota-fiscal-mcp (Focus NFe)

Servidor MCP da comunidade para emissão de NF-e e NFS-e no Brasil usando a API da Focus NFe.

Ainda não testado

Link conferido em 03/11/2026, sem instalar.

Atenção: O agente emite, consulta e cancela NF-e e NFS-e pela Focus NFe. Em produção, a nota tem efeito fiscal real. Comece em homologação ou no modo simulação.

Mantido por FAVIOSENGER, não pelo Estuda com IA. Nunca cole chave de API, token ou senha no chat.

O que faz

A descrição do repositório informa um servidor MCP, em TypeScript, para emitir NF-e e NFS-e via Focus NFe. É um projeto de comunidade, sem vínculo declarado com a Focus NFe.

Para quem

Pessoas desenvolvedoras que já usam a Focus NFe e querem emitir notas a partir de um agente.

Como usar

Segundo o README do repositório, o pacote roda direto pelo npx, sem clonar. No Claude Desktop, adicione ao claude_desktop_config.json (troque o token na configuração, nunca no chat):

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

O README também descreve um modo simulação, sem token, com "env": { "PROVIDER": "mock" }, para testar as 6 ferramentas sem emitir nada.

Pedido de exemplo (do README):

Emita uma NFS-e de R$ 500 de consultoria em TI para o cliente ACME.

Em homologação, essa nota não tem valor fiscal.

Descrição e passo a passo baseados no que a página oficial ou o repositório informava na data de verificação. Não instalamos este MCP ainda. Confira a documentação antes de usar e comece em ambiente de testes.

Veja também