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 Desktop speaks MCP over local stdio — kataven-mcp plugs in directly, no tunnel needed.
Already done Install? Skip to step 3. Otherwise: pip install kataven-mcp, then mint an API key.

​
1. Open Claude Desktop’s MCP config

Easiest path — let Claude Desktop open the file for you: Settings (gear icon) → Developer → Edit Config This opens the file in your default editor and creates it if it’s missing. If you’d rather edit directly:
OSConfig path
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

​
2. Paste the universal entry

{
  "mcpServers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}
If claude_desktop_config.json already had other MCP servers, merge — keep one outer mcpServers object with multiple keys inside it.

​
3. Fully quit and relaunch

Cmd+Q on Mac (not just close-window — Claude keeps running in the dock). Ctrl+Q on Linux. On Windows, right-click the system-tray icon → Exit, then relaunch.

​
4. Verify

Open a new chat. The 🔧 hammer icon below the message composer shows tools available — you should see kataven_list_agents, kataven_create_agent, etc. Try:
List all my Kataven agents.
Claude calls kataven_list_agents and replies with the list. If you see “No tools available from kataven” or the server doesn’t appear at all, see Troubleshooting.

​
5. Verify in the dashboard

After Claude makes changes, sanity-check at the corresponding Hub UI route:
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