{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-mcp-server/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["callout"]},"type":"markdown"},"seo":{"title":"Karzoun MCP Server","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":"karzoun-mcp-server","__idx":0},"children":["Karzoun MCP Server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Give AI assistants ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["structured access"]}," to your Karzoun workspace — customers, tags, products, users, webhooks, and more — through the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://modelcontextprotocol.io/"},"children":["Model Context Protocol"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@karzounchat/mcp-server"]}," package maps the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["public GraphQL API"]}," to MCP tools ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one-to-one"]},". When an agent calls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers"]},", it runs the same operation you would send from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://karzoun.chat/developer/playground"},"children":["Playground"]}," or your backend."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Package:"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.npmjs.com/package/@karzounchat/mcp-server"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@karzounchat/mcp-server"]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Source:"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/KarzounApps/mcp-server"},"children":["KarzounApps/mcp-server"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"tip","title":"Video overview"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coming soon:"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Karzoun MCP in 3 minutes"]}," — what MCP is, when to use stdio vs hosted, and a live Cursor demo. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Embed placeholder)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-your-setup","__idx":1},"children":["Choose your setup"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Local (stdio)"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hosted (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]},")"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Best for"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor, Claude Desktop, local dev"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Backend agents, automations, SaaS workers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Runs as"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx @karzounchat/mcp-server"]}," on your machine"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTP on Karzoun gateway"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token lives"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MCP config ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["env"]}," (your laptop)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your server only — never the browser"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup guide"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/cursor"},"children":["Cursor"]}," · ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/claude-desktop"},"children":["Claude Desktop"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/ai-connectors"},"children":["AI connectors"]}," · ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/hosted"},"children":["Hosted MCP"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart LR\n subgraph Local[\"Local IDE\"]\n C[Cursor / Claude]\n STDIO[stdio MCP server]\n C <--> STDIO\n end\n\n subgraph Cloud[\"Your backend\"]\n AG[Agent / worker]\n end\n\n subgraph Karzoun[\"Karzoun\"]\n MCP[\"/mcp endpoint\"]\n GQL[GraphQL API]\n MCP --> GQL\n end\n\n STDIO --> GQL\n AG --> MCP\n","diagramHtml":"

Karzoun

Your backend

Local IDE

Cursor / Claude

stdio MCP server

Agent / worker

/mcp endpoint

GraphQL API

"},"children":["flowchart LR\n subgraph Local[\"Local IDE\"]\n C[Cursor / Claude]\n STDIO[stdio MCP server]\n C <--> STDIO\n end\n\n subgraph Cloud[\"Your backend\"]\n AG[Agent / worker]\n end\n\n subgraph Karzoun[\"Karzoun\"]\n MCP[\"/mcp endpoint\"]\n GQL[GraphQL API]\n MCP --> GQL\n end\n\n STDIO --> GQL\n AG --> MCP\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App token"]}," — Create in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer → Apps"]}," (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/getting-started/authentication"},"children":["authentication guide"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GraphQL URL"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://{subdomain}.api.karzoun.chat/graphql"]}," (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/getting-started/quickstart"},"children":["quickstart"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions"]}," — Scope the app to the operations your agent needs"]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"warning","title":"Not a replacement for GraphQL"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MCP is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["convenience layer for AI clients"]},". Production integrations that do not need an LLM should call GraphQL or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/guides/webhooks"},"children":["webhooks"]}," directly."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"start-here","__idx":3},"children":["Start here"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Guide"},"children":["Guide"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/guides/how-it-works"},"children":["How it works"]}," — Tools, auth, and responses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pick a setup: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/cursor"},"children":["Cursor"]},", ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/ai-connectors"},"children":["AI connectors"]}," (Claude, Manus, ChatGPT…), or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/hosted"},"children":["Hosted"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/guides/agent-patterns"},"children":["Agent patterns"]}," — Prompts that work well"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/tools/_generated/catalog"},"children":["Tool catalog"]}," — All ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["75+"]}," operations"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration-reference","__idx":4},"children":["Configuration reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Variable"},"children":["Variable"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KARZOUN_API_URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GraphQL endpoint URL"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KARZOUN_APP_TOKEN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["App JWT from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appsAdd"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KARZOUN_MCP_TOOL_PREFIX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limit tools (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KARZOUN_MCP_MAX_RESPONSE_BYTES"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Response cap (default: 524288)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Older environment variable names from previous releases are still accepted as fallbacks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":5},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/setup/security"},"children":["Security"]}," — Token handling and permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp-server/guides/troubleshooting"},"children":["Troubleshooting"]}," — Common MCP errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers"},"children":["Developers hub"]}," — API, webhooks, playground"]}]}]},"headings":[{"value":"Karzoun MCP Server","id":"karzoun-mcp-server","depth":1},{"value":"Choose your setup","id":"choose-your-setup","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Start here","id":"start-here","depth":2},{"value":"Configuration reference","id":"configuration-reference","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"MCP","titleTranslationKey":"products.mcp","description":"Connect Cursor, Claude, and server-side agents to Karzoun via Model Context Protocol.","audience":"developer","status":"published","locales":["en","ar"],"seo":{"title":"Karzoun MCP Server"}},"lastModified":"2026-06-23T14:20:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}