Pular para o conteúdo principal

Limites e solução de problemas

Limites do tier gratuito (hosted)

O endpoint hosted mcp.nfe.io aplica rate limit e cache de borda nas consultas gratuitas para proteger a infraestrutura compartilhada. Os limites vigentes são publicados em tempo real no GET / de mcp.nfe.io (bloco limits). O uso local via npx não tem rate limit.

As ferramentas não apareceram

  1. Reinicie o cliente. A maioria só carrega servidores MCP na inicialização.
  2. Valide o JSON da config. Uma vírgula sobrando quebra o arquivo em silêncio.
  3. Confira a URL: https://mcp.nfe.io/mcp (com o /mcp no final) e "type": "http".
  4. Veja os logs MCP do cliente:
    • Claude Desktop (macOS): ~/Library/Logs/Claude/mcp*.log
    • Claude Code: rode com --debug

Uma ferramenta pede chave

Se uma ferramenta responde pedindo a credencial, ela é do tier pago e você está sem chave (ou com a chave errada para aquela operação). Veja Adicionar sua chave e Autenticação.

Uma consulta pública falhou

As ferramentas de IBGE e Banco Central dependem de serviços públicos que não têm SLA. Se o Banco Central estiver indisponível, o agente recebe uma mensagem instrutiva (não um travamento), tente de novo em seguida.

PTAX retornou vazio

A PTAX só existe em dia útil com fixação. Fim de semana ou feriado retorna vazio, e o agente pede para verificar se a data é dia útil.

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.