You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Docker MCP gateway connects but LLM cannot recognize/invoke the MCP server on macOS #26357
When configuring a Docker MCP gateway server in opencode.json, the connection to the Docker MCP gateway is established successfully (no ENOENT or connection errors), but the LLM in opencode-desktop cannot see or invoke the MCP tools/resources provided by the gateway. The configured tools never appear in the LLM's tool-call context, effectively making the MCP server invisible to the model.
Steps to reproduce
Install opencode-desktop on macOS (Apple Silicon M2)
Configure a Docker-based MCP gateway in opencode.json:
The log/status shows the MCP gateway as connected — no startup errors
Ask the LLM to use a tool that should be provided by this MCP server
Observe that the LLM has no knowledge of the MCP tools — it responds as if the MCP server doesn't exist
Expected behavior
Once the Docker MCP gateway connects successfully, the LLM should be able to discover and invoke the tools/resources exposed by that MCP server, just as it can with non-Docker local MCP servers.
Actual behavior
The MCP gateway appears to connect (no errors in logs)
But the LLM never receives the tool/resource definitions from this MCP server
The LLM has no awareness of the MCP-provided capabilities
Other (non-Docker) MCP servers in the same config work correctly
The issue seems specific to Docker-based MCP gateways on macOS. The connection handshake succeeds (transport-level), but the tool/resource discovery phase (typically via tools/list or similar) doesn't seem to propagate to the LLM context. This may be related to how the Desktop app on macOS handles stdio communication with processes that themselves act as gateways/proxies to other MCP servers (nested MCP architecture).
The same Docker MCP gateway works when tested directly from the terminal (via docker mcp gateway run), confirming it's not a Docker setup issue.
Activity
bin-r00t commentedon May 8, 2026
opencode-desktop (1.14.41)
opencode tui (1.14.41)
github-actions commentedon Jul 9, 2026
To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.