Skip to content

Custom MCP Servers Timeout on Zed Startup #38252

@khollingworth

Description

@khollingworth

Summary

Custom MCP Servers Timeout on Zed Startup

Description

I run the following MCP servers.

Image

On startup map-server-ref,
{
/// The name of your MCP server
"mcp-server-ref": {
/// The command which runs the MCP server
"command": "/usr/local/bin/npx",
/// The arguments to pass to the MCP server
"args": ["ref-tools-mcp@latest"],
/// The environment variables to set
"env": {"REF_API_KEY":"ref-116b4149ad3b1126df54"}
}
}

and map-server-browser,
{
/// The name of your MCP server
"mcp-server-browser": {
/// The command which runs the MCP server
"command": "/usr/local/bin/npx",
/// The arguments to pass to the MCP server
"args": ["@browsermcp/mcp@latest"],
/// The environment variables to set
"env": {}
}
}

fail to load as they time out. They are both npx and the only npx in the list. The others are installed as MCP Extensions. If I switch the failed mcp servers off and back on, they then load correctly without timeout.

Steps to reproduce:

  1. Add the MCP extensions as per the screenshot
  2. Add the two npx mcp servers using the config above.
  3. restart Zed and see they fail due to timeout
  4. toggle the failed mcp servers off then on

Expected Behavior:
All MCP servers load and don't timeout on start up
Actual Behavior:
The npx based mcp servers timeout and fail to load

Zed Version and System Specs

Zed: v0.203.5 (Zed)
OS: macOS 26.0.0
Memory: 64 GiB
Architecture: aarch64

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:aiImprovement related to Agent Panel, Edit Prediction, Copilot, or other AI featuresarea:ai/mcpModel Context Protocolfrequency:commonBugs that happen for at least a third of the users across all platforms and kinds of usagepriority:P2Average run-of-the-mill bugsstate:needs reproNeeds reproduction steps / someone to reproduce

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions