From 34730c19fdb77999ddc06801324774d5061d943b Mon Sep 17 00:00:00 2001
From: Basil Hosmer <basil@anthropic.com>
Date: Tue, 7 Oct 2025 17:55:24 -0400
Subject: [PATCH] Add troubleshooting for wrong transport/endpoint combination

Add documentation explaining that SSE transport requires /sse endpoint
and Streamable HTTP requires /mcp endpoint. This is a common mistake
when using MCP Inspector.
---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index 7ffec88..07b4fa9 100644
--- a/README.md
+++ b/README.md
@@ -455,6 +455,13 @@ The script:
 - **Solution**:
   - Use the full URL with http:// prefix: `http://localhost:3232/mcp`
   - Ensure **both** auth and MCP servers are running (`npm run dev`)
+
+### "Wrong endpoint for SSE transport" or SSE connection fails to `/mcp`
+- **Cause**: Using SSE transport with Streamable HTTP endpoint
+- **Solution**:
+  - For **SSE transport** (legacy): Use `http://localhost:3232/sse`
+  - For **Streamable HTTP** (recommended): Use `http://localhost:3232/mcp`
+  - In MCP Inspector: Match transport type with the correct endpoint
   
 ### "Cannot connect to Docker daemon"
 - **Cause**: Docker/OrbStack not running