Skip to content

Debug workflow normalizer failure - MCP gateway port 80 binding issue - #13403

Closed
pelikhan with Claude wants to merge 1 commit into
mainfrom
claude/debug-workflow-normalizer-failure
Closed

pelikhan with Claude wants to merge 1 commit into
mainfrom
claude/debug-workflow-normalizer-failure

Conversation

@Claude

@Claude Claude AI commented Feb 3, 2026 •

Copy link
Copy Markdown
Contributor

The Workflow Normalizer failed because the MCP gateway container couldn't bind to port 80. The container started successfully and configured all MCP servers, but the HTTP server never opened the port after 120 health check attempts over 2 minutes.

Investigation Summary

Failure mode:

  • Gateway process alive (PID 11511) throughout 2-minute health check period
  • All MCP servers (github, safeoutputs) and 26 tools configured successfully
  • Port 80 never opened for connections (HTTP code 000, curl exit code 7)
  • No error output to stdout/stderr despite specification requiring it

Root cause:
Port 80 requires CAP_NET_BIND_SERVICE capability. The gateway container running with --network host lacks privileges to bind privileged ports (<1024).

Recommended Fixes

  1. Use non-privileged port (8765, 8080, 3000) - eliminates capability requirements
  2. Add container capability - Include --cap-add=CAP_NET_BIND_SERVICE in docker run command
  3. Investigate gateway binary - Check for regression in ghcr.io/github/gh-aw-mcpg:v0.0.94

Diagnostic Evidence

From workflow run logs:

2026/02/03 03:23:59 Registered 22 tools from github: [github___get_commit github___get_file_contents ...]
Port 80 does not appear to be listening
ERROR: Gateway failed to become ready

Container status showed gateway process running but health endpoint unreachable:

curl http://localhost:80/health  # Connection refused (000)
netstat -tlnp | grep ":80"       # No process listening

This is an investigation PR documenting findings for maintainers. No code changes made - issue requires upstream fix to MCP gateway configuration or image.

Original prompt

This section details on the original issue you should resolve

<issue_title>[agentics] Workflow Normalizer failed</issue_title>
<issue_description>### Workflow Failure

Workflow: Workflow Normalizer
Branch: main
Run URL: https://github.com/github/gh-aw/actions/runs/21615593100

Action Required

Debug this workflow failure using the agentic-workflows agent:

/agent agentic-workflows

When prompted, instruct the agent to debug this workflow failure.

Generated from Workflow Normalizer

  • expires on Feb 10, 2026, 3:26 AM UTC

Comments on the Issue (you are @claude[agent] in this section)

@Claude Claude AI assigned Claude and pelikhan Feb 3, 2026
@Claude Claude AI changed the title [WIP] Debug workflow normalizer failure Debug workflow normalizer failure - MCP gateway port 80 binding issue Feb 3, 2026
@Claude
Claude AI requested a review from pelikhan February 3, 2026 03:32
@pelikhan pelikhan closed this Feb 3, 2026
@pelikhan
pelikhan deleted the claude/debug-workflow-normalizer-failure branch August 18, 2026 23:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[agentics] Workflow Normalizer failed

2 participants