Skip to main content
Zed connects to servers through the context_servers key in your settings. Tools are used from the Agent panel when a compatible model is selected.
Zed’s MCP format evolves between releases. For the authoritative schema, see Model Context Protocol in the Zed documentation.

​
Setup

1

Open Zed settings

Run zed: open settings from the command palette, or edit your user settings.json (for example ~/.config/zed/settings.json on Linux, or the path shown in Zed’s settings UI on macOS and Windows).
2

Add OpenCX under context_servers

Add an opencx entry (merge with any existing context_servers object):
{
  "context_servers": {
    "opencx": {
      "command": "npx",
      "args": ["-y", "@opencx/mcp"],
      "env": {
        "OPENCX_API_KEY": "your-api-key-here"
      }
    }
  }
}
Replace your-api-key-here with your OpenCX API key.
3

Confirm in the Agent panel

Open the Agent panel settings view and check that opencx shows a healthy status indicator. Then ask the agent: “List my recent chat sessions.”

​
Project-level config

You can also define MCP servers in .zed/settings.json inside a project so the team shares the same server list. Do not commit real API keys; document how each developer sets OPENCX_API_KEY locally.

​
Tool approval

Zed may prompt before running MCP tools. Adjust tool permissions in Zed settings if you want stricter or more permissive defaults for trusted servers.

Get Started

API key setup and all client configs

Cursor

Another editor-native MCP workflow

Prompt Library

Ready-to-use prompts by domain

Troubleshooting

Common issues and fixes