Skip to main content
Zed has native MCP support via its Agent Panel. The shape is slightly different from other clients — Zed uses context_servers (not mcpServers) inside its main settings.json.
Already done Install? Skip to step 2.

1. Mint an API key + install the binary

pip install kataven-mcp, then mint a key at hub.kataven.ai/settingsAPI Keys tab. Full walkthrough: Install.

2. Open Zed’s settings

Easiest path — let Zed open the file: Cmd+Shift+P (Ctrl+Shift+P on Linux/Windows) → zed: open settings Or edit directly: ~/.config/zed/settings.json (Zed creates it on first open if missing).

3. Add the context_servers block

Add this at the top level of the JSON object (merge with any existing context_servers entries):
Save. Zed picks up the change without a restart.

4. Verify

Open Zed’s Agent Panel (right sidebar). Open the panel’s settings — kataven should appear with a green dot (“Server is active”). Tools become callable in the panel’s chat:
List all my Kataven agents.
The model picks kataven_list_agents from its available tool list.

5. Verify in the dashboard

See also