> ## 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 Windsurf (Codeium)

> Wire the Kataven MCP server into Windsurf's Cascade panel. Voice-agent management from inside the IDE.

Windsurf's Cascade panel speaks MCP over local stdio — `kataven-mcp` plugs in directly.

<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. Add the server (three equivalent paths)

Pick whichever feels right:

**Cascade panel UI**

1. Open the **Cascade** panel.
2. Click the **MCP** icon in the top-right corner of Cascade.
3. Click **+ Add Server**.
4. Paste the universal JSON entry below and save.

**Settings page**

1. Windsurf **Settings** → **Cascade** → **MCP Servers**.
2. Click **View raw config** to open `mcp_config.json` directly.

**Direct file edit**

| OS            | Path                                              |
| ------------- | ------------------------------------------------- |
| macOS / Linux | `~/.codeium/windsurf/mcp_config.json`             |
| Windows       | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` |

Paste the universal entry:

```json theme={null}
{
  "mcpServers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}
```

## 3. Reload (no full restart needed)

Windsurf reloads MCP servers when you save the config. The Cascade panel's MCP servers list shows `kataven` with a green dot when ready.

## 4. Verify

In a Cascade conversation:

> List all my Kataven agents.

Cascade picks `kataven_list_agents` from its tool catalog and runs it.

## 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

* [Cursor setup](/sdks/mcp/clients/cursor) — sibling IDE, same protocol.
* [Troubleshooting](/sdks/mcp/troubleshooting).