Who this page is for
| You are… | Use this page if… |
|---|---|
| A non-developer founder, ops lead, or marketer running Kataven | You want to ask Claude / ChatGPT to do things (“pause the running campaign”, “show me numbers without an agent”) instead of clicking around the dashboard |
| An ops engineer automating Kataven from a chat surface | You want one config blob you can paste into every team member’s AI app |
| A solo developer using Claude Desktop, Cursor, or Zed | You’d rather chat than install Python and write SDK calls |
Two ways MCP clients connect
kataven-mcp runs locally on your machine over stdio (a local pipe). Most AI apps connect to it directly. A few — ChatGPT, Claude.ai web, n8n — only accept remote MCP URLs over HTTPS, so you need a one-line tunnel to expose your local server publicly.
| AI app | Connection | Difficulty | Guide |
|---|---|---|---|
| Claude Desktop | Direct stdio | 🟢 paste JSON, restart | Setup → |
| Cursor | Direct stdio | 🟢 paste JSON, restart | Setup → |
| Windsurf | Direct stdio | 🟢 UI button + JSON | Setup → |
| Zed | Direct stdio | 🟢 settings.json edit | Setup → |
| VS Code (Copilot agent) | Direct stdio | 🟢 Command Palette | Setup → |
| JetBrains AI Assistant | Direct stdio | 🟢 UI form | Setup → |
| Warp Terminal | Direct stdio | 🟢 UI button | Setup → |
| Goose | Direct stdio | 🟢 goose configure | Setup → |
| Raycast AI | Direct stdio | 🟢 install MCP extension | Setup → |
| ChatGPT (Desktop + web + mobile) | Remote HTTPS only | 🟡 needs tunnel | Setup → |
| Claude.ai web (Pro+) | Remote HTTPS only | 🟡 needs tunnel | Setup → |
| n8n | Remote SSE only | 🟡 needs tunnel | Setup → |
The universal pattern
Every client follows the same three steps:Install the MCP server
brew install python first; on Windows install official Python 3.10+. Full walkthrough: Install →.Mint an API key
hub.kataven.ai/settings → API Keys tab → Create API key. Copy the
sk_live_… value once.kataven_list_agents, kataven_create_agent, kataven_originate_call, …) appear in its tool picker.
What the AI can do
Real prompts that work oncekataven-mcp is wired up:
“Show me every agent and which phone number it’s pinned to. Anything pointing nowhere?”
“Create a ‘Tier 2 Support’ agent with a friendlier tone than the existing ‘Support’ agent. Attach the general-faqs playbook.”
“Place a test call from +12025550123 to my cell +14155550100 using the Front Desk agent. Show me the live transcript link.”
“Pause every running campaign — we’re deploying a fix.”Full list of exposed tools: see Install § What gets exposed.
Important reading before you go further
- Tunneling — required if you’re using ChatGPT, Claude.ai web, or n8n.
- Security — your
sk_live_is full account scope; treat it like a CI deploy key. - Troubleshooting — what to do when tools don’t appear.
- Programmatic — OpenAI Agents SDK, LangGraph, Agno, AutoGen.
Other ways to manage Kataven from AI
- Manage with Claude Code / Manage with Codex — terminal coding agents (no MCP needed; they use the SDK directly).
- Manage with AI overview — full decision matrix across every AI tool.