Karzoun Docs

Claude Desktop uses the same @karzounchat/mcp-server package as Cursor, with a different config file location.

Config file

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Configuration

{
  "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"
      }
    }
  }
}

Create an API key in Developer → API keys (authentication). Set KARZOUN_MCP_PACK to a focused pack (customer-support, whatsapp, …) or full for every public tool. See packs.

Verify

Quit and reopen Claude Desktop
Look for the hammer / tools indicator — Karzoun tools should appear
Ask: “Using Karzoun tools, list my first 5 tags”

In-app setup

Developer → MCP setup in Karzoun copies the same JSON for your tenant URL and selected pack.

Cloud Claude (claude.ai)?

Use a remote HTTP connector, not this desktop file: AI app connectors.

Troubleshooting

Same fixes as Cursor troubleshooting — env vars, token scopes, and npx connectivity. For IDE steps, see Cursor or VS Code.

Last modified on August 11, 2026