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.

ChatGPT’s connector flow accepts custom MCP servers via Apps (renamed from “Connectors” in December 2025; both terms still appear in OpenAI’s UI). Once added on web, the connector works on ChatGPT web, Desktop, and mobile automatically. Important: ChatGPT 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 a developer building your own ChatGPT-style agent, the OpenAI Agents SDK programmatic path supports stdio directly — no tunnel needed.

​
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. Enable Developer Mode

(Workspace owner / admin only.)
  1. ChatGPT Workspace settings (gear icon, top-right).
  2. Permissions & Roles tab.
  3. Toggle Developer Mode for connectors.

​
3. Create the connector

  1. ChatGPT Settings (your profile icon, bottom-left) → Connectors (or Apps) → Create.
  2. Fill in:
    • Name: Kataven
    • Description: Manage Kataven voice agents, calls, and campaigns.
    • MCP Server URL: the public HTTPS URL from step 1 (e.g. https://abc123.ngrok.app/sse).
    • Authentication: None (the API key lives in your tunnel’s env, not in ChatGPT).
  3. Create.

​
4. Use it

Open a new chat. Click the + next to the message composer → More → pick Kataven. Ask:
List all my Kataven agents.
ChatGPT routes the question through the connector and calls kataven_list_agents.

​
5. 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. For day-to-day use, pin a paid ngrok subdomain or switch to Cloudflare Tunnel — both covered in Tunneling § Stable URLs.
  • Anyone with the public URL can hit kataven-mcp during the session, gated only by your sk_live_ key. Treat the tunnel like a CI deploy URL — turn it off when not in use.

​
See also