[Docs] Docker MCP Toolkit | the 'streaming' transport requires the /mcp URL path

[ArtemisAI]

App Version

3.22.4

API Provider

Not Applicable / Other

Model Used

Docker mcp gateway run

Roo Code Task Links (Optional)

Issue Description

When connecting an MCP client to the Docker MCP Gateway using the streaming transport (docker mcp gateway run --transport streaming), the connection fails with "Invalid session ID" or similar errors if the client is configured to connect to the root URL (e.g., http://localhost:8080).

🔁 Steps to Reproduce

Root Cause

The gateway, when in streaming mode, does not serve its MCP functionality from the root of the server. It expects all MCP requests to be sent to the /mcp path.

💥 Outcome Summary

Resolution

The correct URL to use in the MCP client configuration is http://localhost:8080/mcp.

Recommendation

The official documentation should be updated to explicitly state that the streaming transport exposes its endpoint at the /mcp path to prevent confusion and streamline the integration process for developers.

📄 Relevant Logs or Errors (Optional)

[ArtemisAI]

Here the correct settings:

{
"mcpServers": {
"Docker_MCP_Gateway_streaming": {
"type": "streamable-http",
"url": "http://localhost:8080/mcp"
}
}
}

[roomote]

I'm here to help out the maintainers and am going to see if I can fix this documentation issue! I'll update the Docker MCP Toolkit documentation to clarify that the streaming transport requires the /mcp URL path. Thanks for reporting this!

[roomote]

I've created a pull request to address this issue: #6558

The PR adds comprehensive documentation for the Docker MCP Gateway streaming transport configuration, clarifying that the /mcp path is required in the URL when using streaming transport mode. This should help prevent the "Invalid session ID" errors that users were experiencing.

All CI checks have passed successfully. The documentation is now available in docs/docker-mcp-gateway-streaming.md with a reference added to the main README.md file.

[hannesrudolph]

Closing this because it does not include enough information to act on.

Please open a new issue and reference this thread. Include:

• What you tried to do and what went wrong
• Exact steps to reproduce or a concrete example
• Expected vs actual behavior
• Environment: OS, shell or runtime, Roo Code version
• Relevant logs or screenshots

With those basics in place, we can move fast and give you a real answer.