Troubleshooting hub

MCP error fixes

Fix Model Context Protocol filesystem, path normalization, server launch, and connection errors.

5source-linked fixes

Start with the exact error, then confirm the operating system, client, and version. Do not apply a workaround solely because the product name matches.

Choose by lifecycle stage: use the MCP connection and handshake guide, then validate configuration when the failure is local.

MCPConfirmed workaround

MCP Filesystem disconnects when an allowed directory is missing

Error accessing directory ... ENOENT: no such file or directory, stat ...

Fix MCP Filesystem ENOENT and Server disconnected errors caused by one missing, renamed, or offline allowed directory.

Open fix →

MCPConfirmed workaround

MCP Filesystem rejects a mapped drive but allows its UNC path

Access denied - path outside allowed directories: Y:\k8s not in \\server\share\git

Fix MCP Filesystem Access denied when a Windows mapped-drive path such as Y:\ is compared with an allowed UNC path.

Open fix →

MCPOpen issue

MCP SSE stream disconnects with TypeError: terminated

SSE stream disconnected: TypeError: terminated

Diagnose MCP Streamable HTTP or SSE connections that repeatedly disconnect with TypeError: terminated.

Open fix →

MCPPartial workaround

MCP fails to open an SSE stream with Not Found

StreamableHTTPError: Streamable HTTP error: Failed to open SSE stream: Not Found

Fix MCP Streamable HTTP clients that send GET to an MCP endpoint and fail with StreamableHTTPError: Failed to open SSE stream: Not Found.

Open fix →

MCPPartial workaround

MCP Filesystem rejects a Windows drive-letter case mismatch

Error: Access denied - path outside allowed directories: c:\Users\... not in C:\Users\...

Fix MCP Filesystem Access denied: path outside allowed directories when Windows drive-letter case or path normalization differs.

Open fix →