Skip to content
MCP/
Cursor setup
Last updated

Cursor setup (stdio)

Run Karzoun MCP locally so Cursor's agent can call your workspace GraphQL API as tools.

Video walkthrough

Coming soon: Installing Karzoun MCP in Cursor — from app token to first tags query. (Video embed placeholder)

Before you start

  • App token from Developer → Apps
  • GraphQL URL: https://{subdomain}.api.karzoun.chat/graphql

Configure MCP

  • 1

    Open MCP settings

    Cursor Settings → MCP → Add new global MCP server

    Or edit ~/.cursor/mcp.json directly.

  • 2

    Add the Karzoun server

    {
  "mcpServers": {
    "karzoun": {
      "command": "npx",
      "args": ["-y", "@karzounchat/mcp-server"],
      "env": {
        "KARZOUN_API_URL": "https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql",
        "KARZOUN_APP_TOKEN": "YOUR_APP_TOKEN"
      }
    }
  }
}

    Replace YOUR_SUBDOMAIN and paste the JWT from appsAdd (shown once).

    Keep tokens out of git

    Do not commit mcp.json if it contains real tokens. Use env vars or Cursor's secret storage where available.

  • 3

    Optional: limit tools

    For faster startup and smaller context, expose only CRM tools:

    "env": {
  "KARZOUN_API_URL": "https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql",
  "KARZOUN_APP_TOKEN": "YOUR_APP_TOKEN",
  "KARZOUN_MCP_TOOL_PREFIX": "customers"
}
  • 4

    Restart and verify

    1. Cursor Settings → MCP — toggle the server off/on or click refresh
    2. Status should show connected with a tool count (~75 without prefix)
    3. In chat: "Use Karzoun to run currentUser"

    Expected: JSON profile for the app's workspace user.

    • In-app setup page

    Karzoun also provides a guided flow at Developer → MCP setup in the web app (/developer/mcp-setup) with copy-ready config snippets.

    Project-level config

    For team repos, add .cursor/mcp.json (same schema) so everyone uses the same server name — each developer still supplies their own token via local env if preferred.

    For teams that prefer not to run npx, use hosted MCP or AI app connectors (Claude.ai, Manus, ChatGPT, remote Cursor).

    Next steps

    Previous page
    Next page