---
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-10-07
tags: ["mcp", "troubleshooting"]
---

# 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`). Todo tráfego passa por esse endpoint - inclusive no Claude Desktop, onde a ponte `mcp-remote` só repassa a chamada - então o limite vale sempre.

## 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"` - exceto no Claude Desktop, que usa `mcp-remote` (veja abaixo).
4. **No Claude Desktop, confirme o Node.js.** O `mcp-remote` roda via `npx`; sem Node.js instalado e no `PATH`, o servidor não sobe.
5. **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.