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

# Available tools

> كل أداة يوفّرها خادم Scanova MCP لمساعد ذكاء اصطناعي متصل.

<Note>
  **مصدر الحقيقة لهذه الصفحة.** هذه القائمة منسوخة مباشرة من `list_mcp_tools()` في [`src/mcp_http/registry.py`](https://github.com/trycon/scanova-mcp/blob/main/src/mcp_http/registry.py) من مستودع `trycon/scanova-mcp` العام — وهي الكود الفعلي الذي يجيب على استدعاء `tools/list` من عميل MCP حقيقي مقابل `https://mcp.scanova.io/mcp`. هي **ليست** مأخوذة من ملف README الخاص بذلك المستودع، وهو قديم: يروّج README لسبع أدوات فقط لإدارة رموز QR، بينما يسجّل الخادم المنشور فعليًا 42 أداة موزّعة على 8 فئات. يعكس **النوع** الخاص بكل أداة أدناه تعليقها الفعلي في MCP (‏`readOnlyHint`/`destructiveHint`) من الملف نفسه.
</Note>

يستدعي مساعد الذكاء الاصطناعي المتصل `initialize` أولًا (يُبلغ الخادم عن `protocolVersion: "2025-03-26"`، و`serverInfo: { name: "scanova-mcp", version: "1.0.0" }`)، ثم `tools/list` لاكتشاف كل ما يلي، ثم `tools/call` لكل أداة. تعمل كل الأدوات الـ 42 على حساب Scanova الخاص بك، باستخدام أي بيانات اعتماد صادق بها عميلك (راجع [Setup](/ar/mcp/setup)).

## جسر توثيق Scanova

يتيح للمساعد الرجوع إلى موقع التوثيق هذا مباشرة، في منتصف المحادثة.

| الأداة           | النوع       | الوصف                                                                                                                                                                                                                             |
| :--------------- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `probe_docs_mcp` | للقراءة فقط | يتحقق من الاتصال بخادم توثيق Scanova MCP ويسرد أدواته المتاحة.                                                                                                                                                                    |
| `query_docs`     | للقراءة فقط | يبحث في توثيق API الخاص بـ Scanova (‏`mode="search"`)، أو يُشغّل أمرًا للقراءة فقط بأسلوب نظام الملفات — `cat` أو `head` أو `rg` أو `tree` أو `jq` — مقابل التوثيق (‏`mode="filesystem"`)، مثلًا لقراءة صفحة مرجعية محددة مباشرة. |

## تصميم رمز QR

| الأداة                  | النوع       | الوصف                                                                                                                                                                                                            |
| :---------------------- | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_qr_design_options` | للقراءة فقط | يُعيد الكتالوج الكامل لخيارات التصميم — أنماط البيانات، وأنماط التدرج، وأشكال العين، والإطارات، ومستويات تصحيح الأخطاء، والخطوط — بحيث يمكن للمساعد تقديم خيارات حقيقية قبل استدعاء `set_qr_design`.             |
| `set_qr_design`         | كتابة       | يطبّق تصميمًا بصريًا على رمز QR موجود من معاملات مسمّاة سهلة الفهم (النمط، والألوان، وشكل العين، والإطار، والشعار، إلخ). تتغير الحقول التي تحدّدها فقط — يُحافَظ على كل شيء آخر بدمجه مع التصميم الحالي لرمز QR. |

## إدارة رموز QR

| الأداة                     | النوع       | الوصف                                                                                                     |
| :------------------------- | :---------- | :-------------------------------------------------------------------------------------------------------- |
| `create_qr_code`           | كتابة       | ينشئ رمز QR جديدًا.                                                                                       |
| `list_qr_codes`            | للقراءة فقط | يسرد رموز QR و/أو الصفحات في الحساب، مع تقسيم للصفحات وبحث؛ يمكنه التصفية إلى رموز QR فقط أو الصفحات فقط. |
| `update_qr_code`           | كتابة       | يحدّث رمز QR موجودًا.                                                                                     |
| `retrieve_qr_code`         | للقراءة فقط | يحصل على تفاصيل رمز QR محدد.                                                                              |
| `download_qr_code`         | للقراءة فقط | ينزّل صورة رمز QR بصيغة PNG أو JPG أو PDF أو SVG أو EPS.                                                  |
| `activate_qr_code`         | كتابة       | يفعّل رمز QR.                                                                                             |
| `deactivate_qr_code`       | كتابة       | يعطّل رمز QR.                                                                                             |
| `delete_qr_code`           | إتلافي      | يحذف رمز QR نهائيًا.                                                                                      |
| `get_qr_categories`        | للقراءة فقط | يسرد فئات رموز QR المتاحة (URL وvCard وWiFi وDocument وSocial Media وغيرها).                              |
| `download_qr_printable`    | للقراءة فقط | يُنشئ نسخة PDF مُحسَّنة للطباعة من رمز QR.                                                                |
| `attach_form_to_qr`        | كتابة       | يُرفق نموذج التقاط عملاء محتملين برمز QR.                                                                 |
| `detach_form_from_qr`      | كتابة       | يزيل نموذج التقاط العملاء المحتملين من رمز QR.                                                            |
| `attach_lead_list_to_qr`   | كتابة       | يُرفق قائمة عملاء محتملين برمز QR لالتقاط العملاء المحتملين.                                              |
| `detach_lead_list_from_qr` | كتابة       | يزيل قائمة العملاء المحتملين من رمز QR.                                                                   |

## التحليلات

| الأداة              | النوع       | الوصف                                                                                       |
| :------------------ | :---------- | :------------------------------------------------------------------------------------------ |
| `get_account_stats` | للقراءة فقط | يسترجع عدادات الاستخدام على مستوى الحساب — إجمالي رموز QR، وعمليات المسح، والمستخدمين، إلخ. |
| `get_qr_analytics`  | للقراءة فقط | يسترجع مقاييس أداء رمز QR مُصنَّفة حسب الجهاز والموقع الجغرافي والتاريخ وأبعاد أخرى.        |
| `export_analytics`  | للقراءة فقط | يصدّر تحليلات رمز QR كتقرير Excel أو PDF.                                                   |
| `export_raw_scans`  | للقراءة فقط | يصدّر سجلات المسح على مستوى الصف بصيغة CSV أو Excel، لخطوط أنابيب ذكاء أعمال مخصصة.         |

## إدارة المجلدات

| الأداة                          | النوع       | الوصف                                                                                                                                            |
| :------------------------------ | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_folder`                 | كتابة       | ينشئ مجلدًا جديدًا لتنظيم رموز QR أو الصفحات.                                                                                                    |
| `list_folders`                  | للقراءة فقط | يسرد كل المجلدات من نوع معين (`qr` أو `page`).                                                                                                   |
| `update_folder`                 | كتابة       | يعيد تسمية مجلد موجود.                                                                                                                           |
| `delete_folder`                 | إتلافي      | يحذف مجلدًا. يوجّه وصف الأداة نفسه المساعد للتأكد منك أولًا بشأن ما إذا كان ينبغي نقل رموز QR الموجودة فيه إلى Uncategorized أو حذفها مع المجلد. |
| `move_qr_codes_to_folder`       | كتابة       | ينقل عدة رموز QR إلى مجلد.                                                                                                                       |
| `unassign_qr_codes_from_folder` | كتابة       | يزيل عدة رموز QR من مجلد (تصبح Uncategorized).                                                                                                   |

## النماذج

| الأداة          | النوع       | الوصف                                                                        |
| :-------------- | :---------- | :--------------------------------------------------------------------------- |
| `list_forms`    | للقراءة فقط | يسرد كل نماذج التقاط العملاء المحتملين، مع إمكانية التصفية حسب حالة التفعيل. |
| `retrieve_form` | للقراءة فقط | يحصل على معلومات مفصّلة عن نموذج محدد، بما في ذلك تهيئته.                    |
| `update_form`   | كتابة       | يحدّث اسم نموذج أو حالة تفعيله.                                              |
| `delete_form`   | إتلافي      | يحذف نموذجًا نهائيًا.                                                        |

## قوائم العملاء المحتملين

| الأداة               | النوع       | الوصف                                                                                          |
| :------------------- | :---------- | :--------------------------------------------------------------------------------------------- |
| `list_lead_lists`    | للقراءة فقط | يسرد كل قوائم العملاء المحتملين، مع إمكانية التصفية حسب حالة التفعيل.                          |
| `retrieve_lead_list` | للقراءة فقط | يحصل على معلومات مفصّلة عن قائمة عملاء محتملين محددة، بما في ذلك تهيئة الـ Webhook الخاصة بها. |
| `update_lead_list`   | كتابة       | يحدّث اسم قائمة عملاء محتملين أو حالة تفعيلها.                                                 |
| `delete_lead_list`   | إتلافي      | يحذف قائمة عملاء محتملين نهائيًا.                                                              |

## إدارة المستخدمين

| الأداة             | النوع       | الوصف                                                  |
| :----------------- | :---------- | :----------------------------------------------------- |
| `list_users`       | للقراءة فقط | يسرد كل المستخدمين في الحساب.                          |
| `get_user`         | للقراءة فقط | يحصل على تفاصيل مستخدم محدد.                           |
| `add_user`         | كتابة       | يدعو مستخدمًا جديدًا إلى الحساب عبر البريد الإلكتروني. |
| `remove_user`      | إتلافي      | يزيل مستخدمًا من الحساب.                               |
| `list_user_roles`  | للقراءة فقط | يسرد كل أدوار المستخدمين المتاحة التي يمكن تعيينها.    |
| `update_user_role` | كتابة       | يغيّر دور مستخدم موجود.                                |

<Warning>
  **الأدوات الإتلافية تتخطى مربع حوار التأكيد بحسب التصميم** — لا يملك بروتوكول MCP خطوة "هل أنت متأكد؟" مُدمجة؛ فأي تأكيد يحدث متروك لاتفاقيات واجهة عميل الذكاء الاصطناعي الخاص بك. راجع ما سيفعله استدعاء أداة `delete_*` أو `remove_user` قبل الموافقة عليه، بنفس الطريقة التي تفعلها لأي إجراء كتابة آخر تفوّضه لمساعد.
</Warning>

## ذات صلة

* [MCP overview](/ar/mcp/overview) — ما هو الخادم، وما يمكنه فعله بنظرة سريعة، ومتطلبات الوصول إليه.
* [MCP setup](/ar/mcp/setup) — اربط عميل ذكاء اصطناعي بالخادم الذي يوفّر هذه الأدوات.
* [Management API overview](/ar/api-reference/management-api/overview) — الـ API الأساسية التي تستدعيها هذه الأدوات نيابة عنك.