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

# MCP setup

> اربط Claude أو ChatGPT أو Perplexity أو أي عميل متوافق مع MCP بحساب Scanova الخاص بك.

<Note>
  كُتب هذا الشرح بالاستناد إلى مكوّن تكامل MCP في لوحة التحكم (`McpBody`) وإعداداته، بالإضافة إلى مصدر خادم `trycon/scanova-mcp` العام والحقيقي — وليس عبر تجربة نقر حية. واجه حساب الاختبار المُخصص لهذه المراجعة تحديًا لمصادقة متعددة العوامل بمفتاح مرور دون رمز احتياطي متاح، مما أعاق تسجيل دخول آلي بالمتصفح قبل أن يتسنى التقاط لقطة شاشة للوحة. كل عنوان URL، وقائمة تبويبات العملاء، وخطوة أدناه مأخوذة حرفيًا من النص المعروض الفعلي للمكوّن، لذا ينبغي أن تطابق اللوحة الحية تمامًا — أبلغ عن أي اختلاف إن وُجد.
</Note>

هناك طريقتان للاتصال، حسب ما إذا كانت أداة الذكاء الاصطناعي لديك تدعم اتصال OAuth الأصلي أم لا.

## المتطلب المسبق

يحتاج حسابك إلى تكامل MCP مفتوحًا — راجع [متطلبات الوصول](/ar/mcp/overview#متطلبات-الوصول). إذا كانت بطاقة **Integrations → Model Context Protocol** تعرض **Upgrade** بدلًا من **Connect**، فإن بقية هذه الصفحة لن تنطبق بعد.

## الخطوة 1: فتح تكامل MCP

من لوحة التحكم، انتقل إلى **Integrations** وانقر على بطاقة **Model Context Protocol**. يفتح هذا لوحة إعداد تعرض عنوان URL لخادم Scanova MCP الخاص بك:

```
https://mcp.scanova.io/mcp
```

مع شارة **OAuth** وزر نسخ. هذا هو عنوان URL الوحيد الذي يتصل به كل عميل أدناه — إنه نقطة نهاية حقيقية وحية (تم التحقق منها مقابل مصدر الخادم المنشور نفسه واستجابات معلوماته على `/health`/`/`)، وليست عنصرًا نائبًا.

## الخيار أ: العملاء المدعومون أصلًا بـ OAuth (Claude وChatGPT وPerplexity)

تحتوي اللوحة على تبويب لكل عميل، لكل منها خطواته المرقّمة الخاصة وزوج **Client ID** / **Client Secret** معروض ضمنيًا (انسخهما من اللوحة نفسها — لم يُعاد إنتاجهما هنا). هذه معرّفات موصل عامة لذلك المنتج المحدد من منتجات الذكاء الاصطناعي، وليست سرًا شخصيًا؛ ستظل تُكمل تسجيل دخول حقيقيًا عبر OAuth وتوافق على الوصول لـ Scanova بعد ذلك.

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="فتح إعدادات Connectors">
        في Claude، افتح **Settings → Connectors**.
      </Step>

      <Step title="إضافة موصل مخصص">
        انقر على **+ Add custom connector**.
      </Step>

      <Step title="لصق عنوان URL للخادم">
        الصق `https://mcp.scanova.io/mcp` من اللوحة.
      </Step>

      <Step title="لصق بيانات اعتماد OAuth">
        الصق **Client ID** و**Client Secret** المعروضين في تبويب Claude في اللوحة.
      </Step>

      <Step title="الاتصال والتفويض">
        انقر على **Add**، ثم **Connect**، ووافق على الوصول. سجّل الدخول إلى Scanova عند مطالبتك بذلك.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="تفعيل وضع المطوّر">
        في ChatGPT، افتح **Settings → Apps → Advanced settings** وفعّل **Developer mode**.
      </Step>

      <Step title="إنشاء تطبيق">
        أنشئ تطبيقًا والصق `https://mcp.scanova.io/mcp` كعنوان URL للخادم.
      </Step>

      <Step title="لصق بيانات اعتماد OAuth">
        انقر على **Advanced OAuth settings** والصق **Client ID** و**Client Secret** المعروضين في تبويب ChatGPT في اللوحة.
      </Step>

      <Step title="التفويض">
        فوّض Scanova عند مطالبتك بذلك، ثم فعّلها من قائمة الأدوات في محادثتك.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Perplexity">
    <Steps>
      <Step title="إضافة موصل مخصص">
        في Perplexity، افتح **Customise → Connectors** وانقر على **+ Add Custom Connector**.
      </Step>

      <Step title="تسميته ولصق عنوان URL للخادم">
        أضف اسمًا والصق `https://mcp.scanova.io/mcp` كعنوان URL للخادم.
      </Step>

      <Step title="لصق بيانات اعتماد OAuth">
        انقر على مفتاح **Advanced** والصق **Client ID** و**Client Secret** المعروضين في تبويب Perplexity في اللوحة.
      </Step>

      <Step title="الإضافة والتفويض">
        انقر على **Add**، وفوّض Scanova عند مطالبتك بذلك، وابدأ استخدامه في محادثات Perplexity الخاصة بك.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## الخيار ب: عملاء ملفات الإعداد (Cursor وVS Code وClaude Desktop أو أي عميل آخر)

بالنسبة لعملاء MCP الذين لا يملكون واجهة موصل OAuth أصلية — بل يأخذون ملف إعداد JSON بدلًا من ذلك — وسّع **Use a token instead** أسفل اللوحة. يُنشئ هذا مفتاح [Management API](/ar/api-reference/management-api/overview) من Scanova بقيمة `environment=mcp`، وهو نوع الرمز المميز نفسه الموثّق في [Creating an API token](/ar/api-reference/management-api/tokens/create). انقر على **Generate token**، ثم انسخ القيمة المعروضة (مُخفاة في اللوحة؛ زر النسخ يكشف القيمة الكاملة إلى الحافظة الخاصة بك).

أضفه إلى ملف إعداد MCP الخاص بعميلك كقيمة ترويسة `Authorization` — وهذا هو التنسيق الدقيق الموثّق في ملف README الخاص بالخادم نفسه:

<CodeGroup>
  ```json Cursor (~/.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json VS Code (~/.vscode/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```
</CodeGroup>

<Warning>
  ضع قيمة الرمز المميز الخام في ترويسة `Authorization` — دون بادئة `Bearer`. يقرأ الخادم أي شيء موجود في تلك الترويسة (كما يقبل `X-API-Key` أو `Scanova-API-Key`) ويمرره كما هو إلى Management API الخاصة بـ Scanova، التي ترفض أي شيء آخر غير المفتاح الخام.
</Warning>

أعد تشغيل بيئة التطوير المتكاملة/العميل الخاص بك بعد حفظ الإعداد.

## إلغاء الوصول

**عملاء الرمز المميز:** ارجع إلى قسم **Use a token instead** الموسَّع في اللوحة، وانقر على أيقونة سلة المهملات بجانب الرمز المميز وأكِّد. يعطّل هذا فورًا كل عميل MCP يستخدم ذلك الرمز المميز.

**عملاء OAuth (Claude/ChatGPT/Perplexity):** أزل الموصل من قائمة الموصلات/الإعدادات الخاصة بأداة الذكاء الاصطناعي تلك — فهي تستخدم رمز وصول OAuth قياسيًا صادرًا لذلك العميل المحدد، بمعزل عن البديل بالرمز المميز أعلاه.

## استكشاف الأخطاء وإصلاحها

* **"Invalid token" / فشل استدعاءات الأداة برمز 401** — أُلغي الرمز المميز أو انتهت صلاحيته. أنشئ رمزًا جديدًا وحدّث إعداد عميلك.
* **الأداة غير موجودة بعد إضافة الخادم** — أعد تشغيل بيئة التطوير المتكاملة أو العميل الخاص بك؛ فمعظم عملاء MCP يجلبون قائمة الأدوات مرة واحدة فقط، عند بدء التشغيل أو الاتصال.
* **أخطاء الاتصال** — تحقق مرتين من أن عنوان URL هو بالضبط `https://mcp.scanova.io/mcp` (وليس `/health` أو النطاق الأساسي المجرّد) وأن شبكتك يمكنها الوصول إليه.

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

راجع [Available tools](/ar/mcp/available-tools) للاطلاع على كل ما يمكن لمساعد الذكاء الاصطناعي الخاص بك فعله الآن.

## ذات صلة

* [MCP overview](/ar/mcp/overview) — ما يفعله الخادم، ومتطلبات الوصول، وحصة `INTEGRATION_MCP`.
* [Available tools](/ar/mcp/available-tools) — القائمة الكاملة والمُتحقَّق منها لكل أداة متاحة بمجرد الاتصال.
* [Create an API token](/ar/api-reference/management-api/tokens/create) — نوع المفتاح نفسه الذي يُنشئه بديل الرمز المميز هنا، بقيمة `environment=mcp`.
* [Management API overview](/ar/api-reference/management-api/overview) — بنية المصادقة ذات المضيفين التي يُصادق بها بديل الرمز المميز.