Description:
The "Get Started" documentation for MCP Servers mentions both stdio and streamable HTTP as primary transport mechanisms for the protocol. However, the documentation does not explicitly distinguish which of these is supported by the WSO2 API Platform’s hosted environment.
Location:
https://wso2.com/bijira/docs/mcp-servers/get-started-with-mcp/
Technical Detail:
stdio transport is architecturally designed for local communication between a host (e.g., a local IDE or CLI) and a server running as a sub process on the same machine.
streamable HTTP (SSE) is the industry standard for remote/networked MCP connections.
Since WSO2 provides a cloud hosted/managed Gateway solution, supporting stdio as a transport for a remote client to connect to the WSO2 gateway is technically impossible. Listing stdio in the "Get Started" guide without clarifying that the WSO2 Platform implementation specifically uses HTTP/SSE creates theoretical ambiguity.
Impact:
Developers new to MCP might attempt to configure their clients using stdio transport for a WSO2 hosted server, leading to configuration errors. As an enterprise-grade platform, the documentation should clearly define the platform’s boundary supporting the protocol specification while adhering to the constraints of a networked gateway.
Suggested Fix:
Add a clarifying note in the "Remote MCP Servers with API Platform" section stating that while the MCP protocol supports stdio, the WSO2 API Platform exclusively utilizes the streamable HTTP (SSE) transport for its hosted MCP server implementations.
Description:
The "Get Started" documentation for MCP Servers mentions both stdio and streamable HTTP as primary transport mechanisms for the protocol. However, the documentation does not explicitly distinguish which of these is supported by the WSO2 API Platform’s hosted environment.
Location:
https://wso2.com/bijira/docs/mcp-servers/get-started-with-mcp/
Technical Detail:
stdio transport is architecturally designed for local communication between a host (e.g., a local IDE or CLI) and a server running as a sub process on the same machine.
streamable HTTP (SSE) is the industry standard for remote/networked MCP connections.
Since WSO2 provides a cloud hosted/managed Gateway solution, supporting stdio as a transport for a remote client to connect to the WSO2 gateway is technically impossible. Listing stdio in the "Get Started" guide without clarifying that the WSO2 Platform implementation specifically uses HTTP/SSE creates theoretical ambiguity.
Impact:
Developers new to MCP might attempt to configure their clients using stdio transport for a WSO2 hosted server, leading to configuration errors. As an enterprise-grade platform, the documentation should clearly define the platform’s boundary supporting the protocol specification while adhering to the constraints of a networked gateway.
Suggested Fix:
Add a clarifying note in the "Remote MCP Servers with API Platform" section stating that while the MCP protocol supports stdio, the WSO2 API Platform exclusively utilizes the streamable HTTP (SSE) transport for its hosted MCP server implementations.