From 4d317ff3883b711c1cbf8c8971e68ea9edf9cd4f Mon Sep 17 00:00:00 2001 From: Eleftheria Stein-Kousathana Date: Wed, 15 Oct 2025 16:22:30 +0200 Subject: [PATCH 1/2] Document STDIO on k8s limitation --- docs/toolhive/guides-k8s/run-mcp-k8s.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/toolhive/guides-k8s/run-mcp-k8s.mdx b/docs/toolhive/guides-k8s/run-mcp-k8s.mdx index adadec5e..68a56691 100644 --- a/docs/toolhive/guides-k8s/run-mcp-k8s.mdx +++ b/docs/toolhive/guides-k8s/run-mcp-k8s.mdx @@ -65,6 +65,14 @@ flowchart LR Proxy -->|Attaches/STDIO| MCP ``` +:::info[STDIO Transport Limitation] + +MCP servers using STDIO transport support only a single client connection at a +time. If you need to support multiple users or concurrent client connections, +use SSE (Server-Sent Events) or Streamable HTTP transport instead. + +::: + ### Streamable HTTP and SSE transport flow For MCP servers using Server-Sent Events (SSE) or Stremable HTTP transport, the From e353a3e1060e234d94f8f2737ae2ffee946ca3ed Mon Sep 17 00:00:00 2001 From: Eleftheria Stein-Kousathana Date: Wed, 15 Oct 2025 16:24:31 +0200 Subject: [PATCH 2/2] Update docs/toolhive/guides-k8s/run-mcp-k8s.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/toolhive/guides-k8s/run-mcp-k8s.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/toolhive/guides-k8s/run-mcp-k8s.mdx b/docs/toolhive/guides-k8s/run-mcp-k8s.mdx index 68a56691..c92d92cf 100644 --- a/docs/toolhive/guides-k8s/run-mcp-k8s.mdx +++ b/docs/toolhive/guides-k8s/run-mcp-k8s.mdx @@ -75,7 +75,7 @@ use SSE (Server-Sent Events) or Streamable HTTP transport instead. ### Streamable HTTP and SSE transport flow -For MCP servers using Server-Sent Events (SSE) or Stremable HTTP transport, the +For MCP servers using Server-Sent Events (SSE) or Streamable HTTP transport, the proxy creates both a pod and a headless service. This allows direct HTTP/SSE or HTTP/Streamable HTTP communication between the proxy and MCP server while maintaining network isolation and service discovery.