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.

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 before continuing here. If you’re using Claude Desktop (the local app), it speaks stdio directly — see Claude Desktop setup. No tunnel needed.
Plan required: Claude Pro / Max / Team / Enterprise. Free Claude can use directory connectors (Gmail, Slack, etc.) but not custom MCP connectors.

1. Run the tunnel

Follow 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 (or Claude.ai → your profile → SettingsConnectors).
  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 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

Operational notes

  • Free ngrok URLs change between sessions and idle out. Pin a paid ngrok subdomain or use Cloudflare Tunnel — see 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