Karzoun Docs

Cursor runs a small local program that calls your workspace API. You need an API key and your GraphQL URL, https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql.

Configure MCP

Open MCP settings

Cursor Settings → MCP → Add new global MCP serverOr edit ~/.cursor/mcp.json / project .cursor/mcp.json.

Add the Karzoun server

{
  "mcpServers": {
    "karzoun-customer-support": {
      "command": "npx",
      "args": ["-y", "@karzounchat/mcp-server"],
      "env": {
        "KARZOUN_API_URL": "https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql",
        "KARZOUN_API_KEY": "kz_live_YOUR_API_KEY",
        "KARZOUN_MCP_PACK": "customer-support"
      }
    }
  }
}

Replace YOUR_SUBDOMAIN and paste the API key from Developer → API keys (shown once).

Do not commit mcp.json if it contains a real key. Prefer an environment variable or Cursor’s secret storage.

Pick a pack

KARZOUN_MCP_PACK limits which public GraphQL tools the agent sees:

Pack	Good for
`customer-support`	Inbox, contacts, companies, tags (recommended start)
`marketing`	Broadcasts, segments, forms, products
`whatsapp`	Templates, messaging, flows
`automations`	Flows and nodes
`full`	Entire public API (large — advanced)

Full table: Hosted MCP → Packs.

Restart and verify

Cursor Settings → MCP — refresh the server
Status should show connected with tools for your pack
In chat: “Use Karzoun to list my first 5 tags”

In-app setup page

Open Developer → MCP setup (/developer/mcp-setup) for tenant-specific URLs and copy-ready configs (Cursor, VS Code, Claude Desktop).

Prefer cloud AI apps?

Use HTTP / hosted MCP or AI app connectors for Claude, ChatGPT, Manus, Gemini, Grok, and remote Cursor.

Next steps

Last modified on August 8, 2026

Overview

Setup

Guides

Tools

Cursor setup (stdio)

Configure MCP

In-app setup page

Prefer cloud AI apps?

Next steps

​Configure MCP

​In-app setup page

​Prefer cloud AI apps?

​Next steps

Configure MCP

In-app setup page

Prefer cloud AI apps?

Next steps