MCP setup

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

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

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

يحتاج حسابك إلى تكامل MCP مفتوحًا — راجع متطلبات الوصول. إذا كانت بطاقة 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 بعد ذلك.

Claude
ChatGPT
Perplexity

فتح إعدادات Connectors

في Claude، افتح Settings → Connectors.

إضافة موصل مخصص

انقر على + Add custom connector.

لصق عنوان URL للخادم

الصق https://mcp.scanova.io/mcp من اللوحة.

لصق بيانات اعتماد OAuth

الصق Client ID وClient Secret المعروضين في تبويب Claude في اللوحة.

الاتصال والتفويض

انقر على Add، ثم Connect، ووافق على الوصول. سجّل الدخول إلى Scanova عند مطالبتك بذلك.

تفعيل وضع المطوّر

في ChatGPT، افتح Settings → Apps → Advanced settings وفعّل Developer mode.

إنشاء تطبيق

أنشئ تطبيقًا والصق https://mcp.scanova.io/mcp كعنوان URL للخادم.

لصق بيانات اعتماد OAuth

انقر على Advanced OAuth settings والصق Client ID وClient Secret المعروضين في تبويب ChatGPT في اللوحة.

التفويض

فوّض Scanova عند مطالبتك بذلك، ثم فعّلها من قائمة الأدوات في محادثتك.

إضافة موصل مخصص

في Perplexity، افتح Customise → Connectors وانقر على + Add Custom Connector.

تسميته ولصق عنوان URL للخادم

أضف اسمًا والصق https://mcp.scanova.io/mcp كعنوان URL للخادم.

لصق بيانات اعتماد OAuth

انقر على مفتاح Advanced والصق Client ID وClient Secret المعروضين في تبويب Perplexity في اللوحة.

الإضافة والتفويض

انقر على Add، وفوّض Scanova عند مطالبتك بذلك، وابدأ استخدامه في محادثات Perplexity الخاصة بك.

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

بالنسبة لعملاء MCP الذين لا يملكون واجهة موصل OAuth أصلية — بل يأخذون ملف إعداد JSON بدلًا من ذلك — وسّع Use a token instead أسفل اللوحة. يُنشئ هذا مفتاح Management API من Scanova بقيمة environment=mcp، وهو نوع الرمز المميز نفسه الموثّق في Creating an API token. انقر على Generate token، ثم انسخ القيمة المعروضة (مُخفاة في اللوحة؛ زر النسخ يكشف القيمة الكاملة إلى الحافظة الخاصة بك). أضفه إلى ملف إعداد MCP الخاص بعميلك كقيمة ترويسة Authorization — وهذا هو التنسيق الدقيق الموثّق في ملف README الخاص بالخادم نفسه:

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

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

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

إلغاء الوصول

عملاء الرمز المميز: ارجع إلى قسم Use a token instead الموسَّع في اللوحة، وانقر على أيقونة سلة المهملات بجانب الرمز المميز وأكِّد. يعطّل هذا فورًا كل عميل MCP يستخدم ذلك الرمز المميز. عملاء OAuth (Claude/ChatGPT/Perplexity): أزل الموصل من قائمة الموصلات/الإعدادات الخاصة بأداة الذكاء الاصطناعي تلك — فهي تستخدم رمز وصول OAuth قياسيًا صادرًا لذلك العميل المحدد، بمعزل عن البديل بالرمز المميز أعلاه.

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

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

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

راجع Available tools للاطلاع على كل ما يمكن لمساعد الذكاء الاصطناعي الخاص بك فعله الآن.

البدء

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

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

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

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

إلغاء الوصول

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

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

ذات صلة

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

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

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

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

​إلغاء الوصول

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

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

​ذات صلة

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

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

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

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

إلغاء الوصول

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

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

ذات صلة