Skip to main content

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.

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/settings → API 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): 
{
  "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 changedOpen in Hub UI
Agentshub.kataven.ai/agents
Phone numbershub.kataven.ai/phone-numbers
Live or recent callshub.kataven.ai/conversations
Campaignshub.kataven.ai/campaigns

​
See also