---
title: "Limites e solução de problemas"
description: "Limites do tier gratuito no endpoint hosted e como diagnosticar quando as ferramentas do MCP não aparecem."
source_url: https://nfe.io/docs/mcp/referencia/limites-e-troubleshooting
last_updated: 2026-08-25
---

# 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](/mcp/comecar/adicionar-chave)** e **[Autenticação](/mcp/referencia/autenticacao)**.

## 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.