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