> ## 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 overview

> اربط Claude وChatGPT وCursor وأدوات الذكاء الاصطناعي الأخرى المتوافقة مع MCP بحساب Scanova الخاص بك.

**بروتوكول سياق النموذج (Model Context Protocol - MCP)** هو بروتوكول مفتوح لربط مساعدي الذكاء الاصطناعي (Claude وChatGPT وCursor وVS Code Copilot وغيرها) بأدوات وبيانات خارجية عبر واجهة JSON-RPC موحّدة. بدلًا من النسخ واللصق في لوحة تحكم، تتحدث إلى Scanova بلغة طبيعية من داخل أداة الذكاء الاصطناعي التي تستخدمها بالفعل — "اعرض رموز QR النشطة لديّ"، أو "أنشئ رمز QR لصفحة الهبوط الجديدة لدينا"، أو "أرني تحليلات المسح للأسبوع الماضي".

تُشغّل Scanova خادم MCP حقيقيًا ومخصصًا لهذا الغرض — وليس مجرد غلاف API مُلصق على نقطة نهاية موجودة. الخادم مفتوح المصدر: [github.com/trycon/scanova-mcp](https://github.com/trycon/scanova-mcp).

<Note>
  **كيف جرى التحقق من هذه الصفحة.** تدفق الإعداد الموصوف هنا (وفي [Setup](/ar/mcp/setup)) مأخوذ مباشرة من مكوّن تكامل MCP في لوحة التحكم والإعدادات الداعمة له، وليس تخمينًا. قائمة الأدوات في [Available tools](/ar/mcp/available-tools) مأخوذة من معالج `tools/list` الفعلي في مصدر `trycon/scanova-mcp` العام — وليس من ملف README الخاص بذلك المستودع، وهو قديم (يروّج لسبع أدوات فقط؛ بينما يعرض الخادم المنشور فعليًا 42 أداة). تعذّر التقاط لقطات شاشة حية للوحة الإعداد في هذه الجولة — طلب حساب الاختبار المُخصص لهذه المراجعة مصادقة متعددة العوامل بمفتاح مرور دون رمز احتياطي متاح، مما أعاق تسجيل دخول آلي. كل ما يلي لا يزال مُتحققًا منه مقابل مصدر حقيقي وحالي — فقط ليس عبر تجربة نقر حية.
</Note>

## ما يمكنك فعله به

بمجرد الاتصال، يمكن لمساعد الذكاء الاصطناعي الخاص بك التصرف في حساب Scanova عبر Management API نفسها التي تستخدمها لوحة التحكم ذاتها. بشكل عام، يغطي ذلك:

* **رموز QR** — الإنشاء، والسرد، والتحديث، والاسترجاع، والتفعيل/التعطيل، والحذف، والتنزيل (بصيغة PNG/JPG/PDF/SVG/EPS أو PDF جاهز للطباعة)، وإعادة تصميم المظهر البصري لرمز QR موجود.
* **التحليلات** — عدادات استخدام على مستوى الحساب، وتحليلات مسح لكل رمز QR (حسب الجهاز والموقع الجغرافي والتاريخ)، وتصدير التحليلات أو سجلات المسح الخام.
* **المجلدات** — الإنشاء، والسرد، وإعادة التسمية، والحذف، ونقل رموز QR بين المجلدات.
* **النماذج وقوائم العملاء المحتملين** — سرد نماذج التقاط العملاء المحتملين وقوائمهم وفحصها وتحديثها وحذفها، وربطها/فصلها عن رمز QR.
* **المستخدمون** — سرد مستخدمي الحساب، ودعوتهم، وإزالتهم، وتغيير دورهم.
* **توثيق Scanova نفسه** — تتيح أداة جسر للمساعد البحث في موقع التوثيق هذا أو قراءته مباشرة أثناء عمله، بحيث يمكنه مثلًا الاطلاع على مخطط pattern-info قبل استدعاء أداة أخرى.

راجع [Available tools](/ar/mcp/available-tools) للحصول على القائمة الكاملة لكل أداة مع أوصافها.

## أين تجده

في لوحة التحكم، انتقل إلى **Integrations** وافتح بطاقة **Model Context Protocol** (الفئة: Workflow). يفتح هذا لوحة إعداد تحتوي على عنوان URL لخادمك، وخطوات اتصال لكل أداة ذكاء اصطناعي، وبديل برمز مميز للعملاء الذين لا يدعمون OAuth — راجع [Setup](/ar/mcp/setup) للاطلاع على الشرح الكامل.

## متطلبات الوصول

تكامل MCP مقيّد خلف اسم رمز حصة، `INTEGRATION_MCP`، يُتحقق منه على كل من بطاقة لوحة التحكم (لعرض **Connect** بدلًا من **Upgrade**) وعلى كل طلب يُجريه خادم MCP نيابة عنك إلى Management API. هذا امتياز يديره المسؤول/الخطة وليس حصة تُفعّلها بنفسك.

<Warning>
  لا تعتبر أي اسم مستوى خطة محدد مؤكَّدًا هنا. تحتوي جدول تعيين الحصة إلى الخطة الخاص بالواجهة الأمامية نفسها على تعليق صريح من القائمين على الصيانة يفيد بأن قيم مستويات الخطط فيه عناصر نائبة غير مُتحقَّق منها (وليست مأخوذة من جدول الخطط الفعلي)، لذا فإن ادعاءً مثل "MCP يتطلب خطة Pro" لا يمكن تأكيده من الكود وحده. ما هو مؤكَّد: هذا مقيّد تحديدًا باسم الرمز `INTEGRATION_MCP` (منفصل عن حصة `MANAGEMENT_API` العامة التي تستخدمها Management API العادية)، وأن حساب خطة Pro المستخدم لهذه المراجعة احتاج إلى منح هذا الاسم مباشرة قبل أن يُفتح التكامل. إذا كان حسابك يعرض **Upgrade** على بطاقة MCP، تواصل مع [support@scanova.io](mailto:support@scanova.io).
</Warning>

<CardGroup cols={2}>
  <Card title="Setup" icon="plug" href="/ar/mcp/setup">
    أنشئ اتصالًا، واربطه بـ Claude أو ChatGPT أو Perplexity أو عميل قائم على ملف إعداد.
  </Card>

  <Card title="Available tools" icon="list-check" href="/ar/mcp/available-tools">
    القائمة الكاملة والمُتحقَّق منها لكل أداة يوفّرها الخادم.
  </Card>
</CardGroup>

## ذات صلة

* [MCP setup](/ar/mcp/setup) — اربط Claude أو ChatGPT أو Perplexity أو عميلًا قائمًا على ملف إعداد بالخادم الموصوف هنا.
* [Available tools](/ar/mcp/available-tools) — المرجع الكامل لكل أداة، أداةً أداة، لكل ما يوفّره الخادم.
* [Management API overview](/ar/api-reference/management-api/overview) — نوع الرمز المميز `environment=mcp` وحصة `INTEGRATION_MCP` الخاصة به، موثّقان بالكامل.