> ## 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 Claude.ai (web)

> Add Kataven as a Custom Connector on claude.ai. Requires Pro/Max/Team/Enterprise plan and a public HTTPS endpoint — full tunnel recipe inside.

[Claude.ai](https://claude.ai) (the web app, separate from Claude Desktop) supports MCP via **Custom Connectors**. Adding one requires a paid plan and a remote MCP URL.

**Important:** Claude.ai web only accepts **HTTPS remote MCP endpoints**, not local stdio. The Kataven MCP server runs locally over stdio, so you need a tunnel — [follow the tunnel recipe](/sdks/mcp/tunneling) before continuing here.

If you're using **Claude Desktop** (the local app), it speaks stdio directly — see [Claude Desktop setup](/sdks/mcp/clients/claude-desktop). No tunnel needed.

<Note>
  **Plan required:** Claude **Pro / Max / Team / Enterprise**. Free Claude can use directory connectors (Gmail, Slack, etc.) but not custom MCP connectors.
</Note>

## 1. Run the tunnel

Follow [Tunneling](/sdks/mcp/tunneling) end-to-end. You should end up with a public HTTPS URL like `https://abc123.ngrok.app/sse`.

## 2. Add the custom connector

1. Open [claude.ai/settings/connectors](https://claude.ai/settings/connectors) (or Claude.ai → your profile → **Settings** → **Connectors**).
2. Scroll to the bottom of the Connectors page → **Add custom connector**.
3. Fill in:
   * **Name:** `Kataven`
   * **MCP Server URL:** the public HTTPS URL from step 1 (e.g. `https://abc123.ngrok.app/sse`).
4. Save.

## 3. Use it

Start a new chat (no restart needed). Ask:

> List all my Kataven agents.

Claude calls `kataven_list_agents` through the connector. You'll see a tools-used summary in Claude's response.

## 4. 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)         |

## Operational notes

* **Free ngrok URLs change between sessions** and idle out. Pin a paid ngrok subdomain or use Cloudflare Tunnel — see [Tunneling § Stable URLs](/sdks/mcp/tunneling#stable-urls).
* **Custom connectors don't sync across plan upgrades.** If you downgrade from Pro to Free temporarily, custom connectors get hidden until you re-upgrade.

## See also

* [Claude Desktop setup](/sdks/mcp/clients/claude-desktop) — same protocol, no tunnel needed.
* [Anthropic — Custom Connectors docs](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).
* [Tunneling](/sdks/mcp/tunneling).
* [Troubleshooting](/sdks/mcp/troubleshooting).