{"templateId":"GuidePage","sharedDataIds":{"sidebar":"sidebar-mcp-server/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["callout","guide-step"]},"type":"markdown"},"seo":{"title":"Cursor setup (stdio)","description":"Developer API, partner integration, MCP, SDK, and customer help center.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cursor-setup-stdio","__idx":0},"children":["Cursor setup (stdio)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run Karzoun MCP locally so Cursor's agent can call your workspace GraphQL API as tools."]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"tip","title":"Video walkthrough"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coming soon:"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Installing Karzoun MCP in Cursor"]}," — from app token to first ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]}," query. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Video embed placeholder)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/getting-started/authentication"},"children":["App token"]}," from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer → Apps"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GraphQL URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://{subdomain}.api.karzoun.chat/graphql"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-mcp","__idx":2},"children":["Configure MCP"]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":1,"title":"Open MCP settings"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cursor Settings → MCP → Add new global MCP server"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Or edit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.cursor/mcp.json"]}," directly."]}]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":2,"title":"Add the Karzoun server"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"karzoun\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@karzounchat/mcp-server\"],\n      \"env\": {\n        \"KARZOUN_API_URL\": \"https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql\",\n        \"KARZOUN_APP_TOKEN\": \"YOUR_APP_TOKEN\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_SUBDOMAIN"]}," and paste the JWT from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appsAdd"]}," (shown once)."]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"warning","title":"Keep tokens out of git"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not commit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]}," if it contains real tokens. Use env vars or Cursor's secret storage where available."]}]}]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":3,"title":"Optional: limit tools"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For faster startup and smaller context, expose only CRM tools:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"env\": {\n  \"KARZOUN_API_URL\": \"https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql\",\n  \"KARZOUN_APP_TOKEN\": \"YOUR_APP_TOKEN\",\n  \"KARZOUN_MCP_TOOL_PREFIX\": \"customers\"\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":4,"title":"Restart and verify"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cursor Settings → MCP"]}," — toggle the server off/on or click refresh"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Status should show ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["connected"]}," with a tool count (~75 without prefix)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In chat: ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"Use Karzoun to run currentUser\""]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Expected: JSON profile for the app's workspace user."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"in-app-setup-page","__idx":3},"children":["In-app setup page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Karzoun also provides a guided flow at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer → MCP setup"]}," in the web app (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/developer/mcp-setup"]},") with copy-ready config snippets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"project-level-config","__idx":4},"children":["Project-level config"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For team repos, add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]}," (same schema) so everyone uses the same server name — each developer still supplies their own token via local env if preferred."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For teams that prefer not to run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx"]},", use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/hosted"},"children":["hosted MCP"]}," or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/ai-connectors"},"children":["AI app connectors"]}," (Claude.ai, Manus, ChatGPT, remote Cursor)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/ai-connectors"},"children":["AI app connectors"]}," — Cloud AI apps (Claude, Manus, ChatGPT)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/guides/agent-patterns"},"children":["Agent patterns"]}," — Prompts that work"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/guides/how-it-works"},"children":["How it works"]}," — Tool ↔ GraphQL mapping"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/guides/troubleshooting"},"children":["Troubleshooting"]}," — If the server stays red"]}]}]},"headings":[{"value":"Cursor setup (stdio)","id":"cursor-setup-stdio","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Configure MCP","id":"configure-mcp","depth":2},{"value":"In-app setup page","id":"in-app-setup-page","depth":2},{"value":"Project-level config","id":"project-level-config","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Cursor setup","titleTranslationKey":"sidebar.mcp.cursor","audience":"developer","status":"published","locales":["en","ar"],"template":"GuidePage","seo":{"title":"Cursor setup (stdio)"}},"lastModified":"2026-06-23T14:20:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server/setup/cursor","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}