> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kataven.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Kataven MCP to Zed

> Add Kataven as a context server in Zed. Manage voice agents from Zed's Agent Panel using its native MCP support.

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`.

<Note>
  Already done [Install](/sdks/mcp/install)? Skip to step 2.
</Note>

## 1. Mint an API key + install the binary

`pip install kataven-mcp`, then mint a key at [hub.kataven.ai/settings](https://hub.kataven.ai/settings) → **API Keys** tab. Full walkthrough: [Install](/sdks/mcp/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):

```json theme={null}
{
  "context_servers": {
    "kataven": {
      "source": "custom",
      "command": "kataven-mcp",
      "args": [],
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}
```

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

| What changed         | Open in Hub UI                                                       |
| -------------------- | -------------------------------------------------------------------- |
| Agents               | [hub.kataven.ai/agents](https://hub.kataven.ai/agents)               |
| Phone numbers        | [hub.kataven.ai/phone-numbers](https://hub.kataven.ai/phone-numbers) |
| Live or recent calls | [hub.kataven.ai/conversations](https://hub.kataven.ai/conversations) |
| Campaigns            | [hub.kataven.ai/campaigns](https://hub.kataven.ai/campaigns)         |

## See also

* [Zed's MCP docs](https://zed.dev/docs/ai/mcp) — official protocol notes.
* [Troubleshooting](/sdks/mcp/troubleshooting).