7 Bugs do Gateway MCP: Vazamentos de Sessão, SSE Morta e OAuth no Modo Gateway

Após os demos do caminho feliz, um usuário do Reddit encontrou sete bugs específicos ao colocar um gateway MCP entre clientes e servidores reais. As correções não foram engenharia de prompt — foram limites explícitos de sessão, timeouts por ferramenta, idempotência, logs de ação estruturados, rastreamentos no nível do gateway e testes contra chamadas concorrentes de ferramentas. O resultado foi uma grande redução no tempo total de ferramentas paralelas, mas a maior vitória foi saber onde o erro residia.

Os sete bugs que realmente importavam

• Vazamento de estado de sessão entre clientes — estado compartilhado entre sessões causou contaminação de dados.
• Conexões SSE morrendo silenciosamente — nenhum erro foi exibido quando uma conexão de evento enviada pelo servidor caiu.
• Fluxos OAuth funcionando em testes locais, mas quebrando em modo gateway — URIs de redirecionamento ou validação de token falharam atrás do proxy.
• Sondagens de descoberta retornando metadados de servidor desatualizados — capacidades em cache não refletiam atualizações do servidor.
• Escritas no SQLite bloqueando chamadas paralelas de ferramentas — bloqueios de banco de dados serializaram solicitações concorrentes.
• Lógica de repetição duplicando efeitos colaterais de ferramentas — repetições reexecutaram mutações como escritas ou chamadas de API.
• Latência de ferramenta escondida dentro do gateway em vez da chamada de modelo — monitoramento atribuiu tempo à camada errada.

A correção: infra robusta, não prompts melhores

A abordagem do autor para cada bug:

• Limites explícitos de sessão — estado separado por cliente, sem objetos compartilhados.
• Política de timeout por ferramenta — timeouts individuais para evitar que uma ferramenta lenta segure as outras.
• Idempotência quando possível — chaves de deduplicação ou comportamento transacional para tornar repetições seguras.
• Logs de ação estruturados — logs detalhados e analisáveis de cada ação do gateway para depuração.
• Rastreamentos no nível do gateway — rastreamento distribuído para atribuir latência corretamente entre camadas.
• Testes contra chamadas concorrentes de ferramentas — testes de integração que disparam solicitações paralelas para revelar condições de corrida.

Esses são padrões específicos e práticos para qualquer pessoa que execute um gateway MCP em produção. A percepção chave da postagem: os problemas difíceis são isolamento de estado, falhas silenciosas e observabilidade — não prompts de modelo.