GxObjGen v1.11.5 — gateway 8780 sem falha silenciosa
Correção da issue #15 — obrigado, @bpessoni, pelo relato com evidências na medida!
O problema
O gateway multi-KB (porta 8780) é um script Python que a extensão lança ao abrir o IDE — e Python no PATH era um pré-requisito não documentado. Sem Python, o gateway não subia e nada aparecia no IDE (o motivo ia só para o log interno); como a doc inteira cravava 8780, o "connection refused" parecia MCP quebrado. O servidor por-KB (porta determinística, faixa 8787–8986, estável entre reaberturas) sempre esteve vivo — era a porta que o Output do IDE mostrava.
O que mudou
- Status do gateway SEMPRE no Output do IDE (seção "GxObjGen MCP"):
ATIVO/iniciado/NAO INICIADO: <motivo>(ex.: "Python nao encontrado no PATH") — com o workaround por-KB na própria mensagem. - A mensagem por-KB (a que aparece ao abrir a KB) ganhou uma linha com o estado real do gateway.
install.ps1checa Python ao final: verde (gateway ok, registre a 8780) ou amarelo (conecte pela porta por-KB; para habilitar o gateway:winget install Python.Python.3.12).- Doc alinhada: README com as duas formas de conectar (gateway 8780 requer Python × porta por-KB sem dependência), GETTING-STARTED com o troubleshooting exato do sintoma ("connection refused na 8780 mas o IDE mostrou outra porta" → não reinstale), CLAUDE.md idem.
Validação
Deploy real: gateway ATIVO detectado e reportado no boot; regressão completa 24/24 PASS; as duas branches da detecção de Python do install.ps1 exercitadas.
Ação
- Atualize:
git pull(repo de instalação) ou baixe o asset abaixo e rodeinstall.ps1(GeneXus fechado). /mcpno Claude Code p/ reconectar.
— Equipe CQ1