> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# إعداد Cursor (stdio)

> شغّل كرزون MCP محليًا ليتمكن وكيل Cursor من استدعاء واجهة GraphQL لمساحة عملك كأدوات.

شغّل كرزون MCP محليًا ليتمكن وكيل Cursor من استدعاء واجهة GraphQL لمساحة عملك كأدوات.

<Tip title="شرح بالفيديو">
  **قريبًا:** *تثبيت كرزون MCP في Cursor* — من رمز التطبيق إلى أول استعلام `tags`. *(مكان مخصص لتضمين الفيديو)*
</Tip>

## قبل البدء

* [رمز التطبيق](/ar/developers/getting-started/authentication) من **المطوّر ← التطبيقات**
* عنوان GraphQL: `https://{subdomain}.api.karzoun.chat/graphql`

## إعداد MCP

<Steps>
  <Step title="افتح إعدادات MCP">
    **إعدادات Cursor ← MCP ← Add new global MCP server**

    أو عدّل `~/.cursor/mcp.json` مباشرة.
  </Step>

  <Step title="أضف خادم كرزون">
    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "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"
          }
        }
      }
    }
    ```

    استبدل `YOUR_SUBDOMAIN` والصق JWT من `appsAdd` (يُعرض مرة واحدة).

    <Warning title="أبقِ الرموز خارج Git">
      لا ترفع `mcp.json` إلى Git إذا كان يحتوي رموزًا حقيقية. استخدم متغيرات البيئة أو تخزين الأسرار في Cursor حيث يتوفر.
    </Warning>
  </Step>

  <Step title="اختياري: تقييد الأدوات">
    لتسريع التشغيل وتقليل السياق، اعرض أدوات CRM فقط:

    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    "env": {
      "KARZOUN_API_URL": "https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql",
      "KARZOUN_APP_TOKEN": "YOUR_APP_TOKEN",
      "KARZOUN_MCP_TOOL_PREFIX": "customers"
    }
    ```
  </Step>

  <Step title="أعد التشغيل وتحقق">
    1. **إعدادات Cursor ← MCP** — أوقف/شغّل الخادم أو انقر تحديث
    2. يجب أن تظهر الحالة **connected** مع عدد أدوات (\~75 بدون بادئة)
    3. في المحادثة: *"Use Karzoun to run currentUser"*

    المتوقع: ملف JSON لملف مستخدم مساحة العمل المرتبط بالتطبيق.
  </Step>
</Steps>

## صفحة الإعداد داخل التطبيق

يوفّر كرزون أيضًا تدفقًا موجّهًا في **المطوّر ← إعداد MCP** في تطبيق الويب (`/developer/mcp-setup`) مع مقاطع إعداد جاهزة للنسخ.

## إعداد على مستوى المشروع

لمستودعات الفريق، أضف `.cursor/mcp.json` (بنفس المخطط) حتى يستخدم الجميع نفس اسم الخادم — ويظل كل مطوّر يزوّد رمزه الخاص عبر البيئة المحلية إن رغب.

للفرق التي تفضّل عدم تشغيل `npx`، استخدم [MCP المستضاف](/ar/mcp-server/setup/hosted) أو [موصّلات تطبيقات الذكاء الاصطناعي](/ar/mcp-server/setup/ai-connectors) (Claude.ai، Manus، ChatGPT، Cursor عن بُعد).

## الخطوات التالية

* [موصّلات تطبيقات الذكاء الاصطناعي](/ar/mcp-server/setup/ai-connectors) — تطبيقات الذكاء الاصطناعي السحابية (Claude، Manus، ChatGPT)
* [أنماط الوكلاء](/ar/mcp-server/guides/agent-patterns) — أوامر تعمل
* [كيف يعمل](/ar/mcp-server/guides/how-it-works) — ربط الأداة ↔ GraphQL
* [استكشاف الأخطاء](/ar/mcp-server/guides/troubleshooting) — إذا بقي الخادم باللون الأحمر


## Related topics

- [إعداد Claude Desktop (stdio)](/ar/mcp-server/setup/claude-desktop.md)
- [MCP](/ar/mcp-server/index.md)
- [أمان MCP](/ar/mcp-server/setup/security.md)
- [استكشاف الأخطاء](/ar/mcp-server/guides/troubleshooting.md)
- [ربط تطبيقات الذكاء الاصطناعي بـ MCP المستضاف](/ar/mcp-server/setup/ai-connectors.md)