tools/list، ثم يستدعي كل أداة عبر tools/call. ويتعامل الخادم مع مراجعة MCP الحالية (2026-07-28، التي يبدأ فيها العميل بـ server/discover) ومع المراجعات السابقة (التي يبدأ فيها بـ initialize)، ويعرّف نفسه باسم scanova-mcp. وتعمل الأدوات الاثنتان والثمانون كلها على حسابك في Scanova، بالاعتماد على بيانات الدخول التي صادق بها عميلك — راجع Setup.
يوافق نوع كل أداة تعليقَها التوضيحي في MCP: أدوات للقراءة فقط تقرأ ولا تزيد، وأدوات الكتابة تضيف شيئًا أو تغيّره دون أن تنتقص منه شيئًا، وأما الإتلافية فقد تحذف شيئًا قائمًا أو تستبدل به غيره أو توقفه عن العمل — ويدخل في ذلك تغيير ما يعرضه رمز QR مطبوع. والتجميع أدناه من عندنا ليسهل تصفّح القائمة — أما الخادم فيُعيد قائمة واحدة مسطّحة.
جسر توثيق Scanova
تتيح للمساعد الرجوع إلى موقع التوثيق هذا مباشرةً في أثناء المحادثة.| الأداة | النوع | الوصف |
|---|---|---|
probe_docs_mcp | للقراءة فقط | يتحقق من الاتصال بخادم توثيق Scanova MCP ويسرد أدواته المتاحة |
query_docs | للقراءة فقط | يبحث في هذا التوثيق (mode="search")، أو ينفّذ أمرًا للقراءة فقط بأسلوب نظام الملفات — cat وhead وrg وtree وjq — لقراءة صفحة مرجعية بعينها مباشرة (mode="filesystem") |
الفئات والتحقق
بيانات مرجعية يمكن للمساعد الرجوع إليها قبل أن ينشئ أي شيء.| الأداة | النوع | الوصف |
|---|---|---|
get_qr_categories | للقراءة فقط | يسرد فئات رموز QR المتاحة (URL وvCard وWiFi وDocument وSocial Media وغيرها) |
get_qr_category_fields | للقراءة فقط | يُعيد مرجع حقول info المطلوبة والاختيارية لفئة ما، أو لكل الفئات مرة واحدة. وهي بيانات مرجعية ثابتة، فلا تستهلك أي استدعاء للواجهة |
validate_qr_info | للقراءة فقط | يتحقق من الفئة وحمولة info قبل تنفيذ create_qr_code أو update_qr_code، فيكشف JSON المعطوب والحقول المطلوبة الناقصة والقيم غير الصالحة |
تصميم رمز QR
لا تُحفظ معاينات التصميم أبدًا: يعرض المساعد الخيارات أولًا، ثم يطبّق ما تختاره منها عبرset_qr_design.
| الأداة | النوع | الوصف |
|---|---|---|
get_qr_design_options | للقراءة فقط | يُعيد الكتالوج الكامل لخيارات التصميم — أنماط البيانات، وأنماط التدرج، وأشكال العين، والإطارات، ومستويات تصحيح الأخطاء، والخطوط — بحيث يمكن للمساعد تقديم خيارات حقيقية قبل استدعاء set_qr_design |
preview_qr_design | للقراءة فقط | يعاين تصميمًا دون حفظه: التصميم بعد الدمج، وفحوص أمان المسح (تباين ألوان النقاط والعيون، وتصحيح الأخطاء عند وجود شعار، والخلفيات المعكوسة أو الشفافة)، واختبار مسح فعلي على صورة مُولَّدة، والصورة نفسها. ويعمل مع رمز QR قائم أو مع محتوى جديد |
set_qr_design | إتلافي | يطبّق تصميمًا مرئيًا على رمز QR قائم انطلاقًا من معطيات بأسماء واضحة. ولا تتغير سوى الحقول التي تحددها؛ أما الباقي فيُدمج مع التصميم الحالي للرمز. ويرفض أي تصميم لا يجتاز فحوص أمان المسح ما لم تقبل المخاطرة (accept_risk) |
إدارة رموز QR
| الأداة | النوع | الوصف |
|---|---|---|
create_qr_code | كتابة | ينشئ رمز QR جديدًا، بعد أن يصبح الاسم والفئة والنوع وحمولة info معروفة كلها |
open_qr_code_creation_form | للقراءة فقط | يفتح نموذجًا تفاعليًا بدلًا من ذلك، وذلك عندما تطلب رمز QR دون تقديم كل ما يحتاجه |
list_qr_codes | للقراءة فقط | يسرد رموز QR والصفحات في الحساب، مع الترقيم والبحث، أو يقصر القائمة على أحد النوعين |
retrieve_qr_code | للقراءة فقط | يحصل على تفاصيل رمز QR محدد |
update_qr_code | إتلافي | يحدّث رمز QR موجودًا |
activate_qr_code | كتابة | يفعّل رمز QR |
deactivate_qr_code | إتلافي | يعطّل رمز QR |
delete_qr_code | إتلافي | يحذف رمز QR نهائيًا |
download_qr_code | للقراءة فقط | ينزّل صورة رمز QR بصيغة PNG أو JPG أو PDF |
list_tags | للقراءة فقط | يسرد الوسوم الموجودة على رموز QR في الحساب. وهو للقراءة فقط بحكم التصميم — إذ تنشأ الوسوم عند إرفاق وسم برمز QR، لا عبر استدعاء إنشاء |
update_qr_tags | إتلافي | يستبدل بوسوم رمز QR الوسومَ التي تحددها (والقائمة الفارغة تزيلها كلها). وتُنشأ الوسوم غير الموجودة بعد |
سلة المهملات والسلامة
| الأداة | النوع | الوصف |
|---|---|---|
list_trashed_qr_codes | للقراءة فقط | يسرد رموز QR الموجودة في سلة المهملات — المحذوفة التي لا يزال استرجاعها ممكنًا — مع وقت حذف كلٍّ منها وعدد عمليات مسحه |
restore_qr_codes | كتابة | يسترجع رموز QR من سلة المهملات لتعمل من جديد، بحسب qrid. ويُحتسب ذلك ضمن حدود رموز QR في خطتك، ولا يسترجع السلة كلها في استدعاء واحد أبدًا |
get_qr_health | للقراءة فقط | يُجري فحص سلامة رموز QR في الحساب: المشكلات التي تمنع الرموز من العمل كما ينبغي، مثل الرموز غير النشطة أو المنتهية الصلاحية، والوجهات المعطّلة، والنماذج أو النطاقات المخصصة التي تحتاج إلى معالجة |
سحب منتجات GS1
| الأداة | النوع | الوصف |
|---|---|---|
list_gs1_recalls | للقراءة فقط | يسرد إشعارات سحب الدفعات/اللوتات في GS1 الخاصة بالحساب — أي GTIN وأي دفعة، والرسالة التي تظهر لمن يمسح منتجًا متأثرًا، وهل كل إشعار نشط |
create_gs1_recall | كتابة | يسحب دفعة منتج: كل من يمسح رمز QR من GS1 لذلك الـ GTIN والدفعة/اللوت يرى رسالتك بدلًا من المحتوى المعتاد |
update_gs1_recall | إتلافي | يغيّر رسالة إشعار السحب، أو يوقفه بعد انتهاء السحب. ويُحتفظ بسجلّه |
المجلدات
| الأداة | النوع | الوصف |
|---|---|---|
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 | للقراءة فقط | يحصل على معلومات مفصّلة عن نموذج محدد، بما في ذلك تهيئته |
create_form | كتابة | ينشئ نموذجًا من عنوان وأسئلة — لكل سؤال نوع إجابة (إجابة قصيرة، أو بريد إلكتروني، أو اختيار من متعدد، أو تقييم بالنجوم، وغيرها) وخيارات لأسئلة الاختيار — ويربطه فورًا برمز QR ديناميكي إن مرّرت واحدًا. ويقبل أيضًا بنية الكتل الكاملة للنموذج |
update_form | إتلافي | يحدّث اسم نموذج أو حالة تفعيله |
delete_form | إتلافي | يحذف نموذجًا نهائيًا |
attach_form_to_qr | كتابة | يُرفق نموذج التقاط عملاء محتملين برمز QR، باستخدام المعرّف الرقمي id للنموذج أو form_id الخاص به |
detach_form_from_qr | إتلافي | يزيل نموذج التقاط العملاء المحتملين من رمز QR |
list_form_templates | للقراءة فقط | يسرد قوالب نماذج جاهزة يمكن أن تبدأ منها نموذجًا جديدًا |
list_form_responses | للقراءة فقط | يسرد الردود التي جمعها نموذج، من الأحدث إلى الأقدم: الإجابات، ووقت ورود كل رد، ورمز QR الذي ورد عبره. ويمكن التصفية بنطاق زمني أو برمز QR أو بعبارة بحث |
get_form_analytics | للقراءة فقط | يحصل على أداء نموذج: إجمالي الردود ومرات التخطي مقارنةً بالفترة السابقة، وكلاهما بحسب التاريخ، والردود بحسب رمز QR المصدر |
get_form_question_analytics | للقراءة فقط | يحصل على كيفية الإجابة عن كل سؤال في نموذج: عدد الردود التي أجابت عنه، ولأسئلة الاختيار والتقييم والمقياس عدد مرات اختيار كل إجابة |
list_form_notifications | للقراءة فقط | يسرد تنبيهات البريد الإلكتروني المُعدّة للردود الجديدة على النماذج — من تُرسل إليه، وبأي تواتر، ولأي نماذج، وهل كل تنبيه مفعّل |
create_form_notification | كتابة | يرسل بريدًا إلكترونيًا إلى شخص ما عند ورود ردود جديدة على النماذج — مع كل رد، أو في ملخص يومي أو أسبوعي أو شهري. ويتلقى العنوان إجابات المستجيبين |
update_form_notification | إتلافي | يغيّر مستلم تنبيه النموذج أو تواتره أو نماذجه، أو يوقفه. وتبقى نماذجه كما هي ما لم تمرّر نماذج جديدة |
قوائم العملاء المحتملين
| الأداة | النوع | الوصف |
|---|---|---|
list_lead_lists | للقراءة فقط | يسرد جميع قوائم العملاء المحتملين، مع إمكانية التصفية بحسب حالة التفعيل. وفي الأعمال الجديدة تُعدّ النماذج الخيار المفضل |
retrieve_lead_list | للقراءة فقط | يحصل على معلومات مفصّلة عن قائمة عملاء محتملين محددة، بما في ذلك تهيئة الـ Webhook الخاصة بها |
update_lead_list | إتلافي | يحدّث اسم قائمة عملاء محتملين أو حالة تفعيلها |
delete_lead_list | إتلافي | يحذف قائمة عملاء محتملين نهائيًا |
attach_lead_list_to_qr | كتابة | يُرفق قائمة عملاء محتملين برمز QR لالتقاط العملاء المحتملين |
detach_lead_list_from_qr | إتلافي | يزيل قائمة العملاء المحتملين من رمز QR |
التحليلات والتقارير
| الأداة | النوع | الوصف |
|---|---|---|
get_account_stats | للقراءة فقط | يسترجع عدادات الاستخدام على مستوى الحساب — إجمالي رموز QR، وعمليات المسح، والمستخدمين، إلخ |
get_qr_analytics | للقراءة فقط | يسترجع مقاييس أداء رمز QR مُصنَّفة حسب الجهاز والموقع الجغرافي والتاريخ وأبعاد أخرى |
get_analytics_overview | للقراءة فقط | يحصل على نظرة عامة على عمليات المسح في الحساب: الإجماليات منذ البداية، والشهر الحالي، والأشهر الأخيرة، وعمليات المسح بحسب التاريخ |
list_analytics_reports | للقراءة فقط | يسرد تقارير تحليلات المسح المُنشأة للحساب، مع نطاق كل تقرير وتواريخه وحالته، ورابط تنزيله متى أصبح جاهزًا |
create_analytics_report | كتابة | يُنشئ تقرير تحليلات مسح — تحليلات موجزة، أو بيانات مسح أولية، أو كليهما — لرموز QR أو وسوم أو مجلدات مختارة خلال نطاق زمني. ويُعدّ في الخلفية ثم يُرسل بالبريد الإلكتروني إلى من طلبه |
الخطة والفوترة
للقراءة فقط: يستطيع المساعد شرح الخطة وسجل الفوترة، أما تغييرات الاشتراك فتبقى داخل التطبيق.| الأداة | النوع | الوصف |
|---|---|---|
get_current_plan | للقراءة فقط | يجلب الخطة السارية للحساب — تاريخ انتهائها، وحالة الفوترة، والقائمة الكاملة للحصص التي تمنحها |
list_available_plans | للقراءة فقط | يسرد الخطط التي يمكن للحساب الانتقال إليها، مع ميزاتها وحصصها |
get_downgrade_impact | للقراءة فقط | قبل الانتقال إلى خطة أصغر، يبيّن أيّ رموز QR والمستخدمين والنطاقات وغيرها من موارد الحساب تتجاوز حدود تلك الخطة |
list_payments | للقراءة فقط | يسرد سجل مدفوعات الحساب — مبلغ كل دفعة وتاريخها وحالتها |
list_orders | للقراءة فقط | يسرد طلبات الحساب — شراء الخطط، والتجديدات، وعمليات الشحن الإضافي — وحالتها |
list_quota_topups | للقراءة فقط | يسرد الحصص الإضافية المشتراة فوق الخطة، وموعد انتهاء كل إضافة منها |
المستخدمون والأدوار
| الأداة | النوع | الوصف |
|---|---|---|
list_users | للقراءة فقط | يسرد كل المستخدمين في الحساب |
get_user | للقراءة فقط | يحصل على تفاصيل مستخدم محدد |
add_user | كتابة | يدعو مستخدمًا جديدًا إلى الحساب عبر البريد الإلكتروني |
resend_user_invitation | كتابة | يعيد إرسال رسالة الدعوة إلى عضو في الفريق لم يقبلها بعد |
remove_user | إتلافي | يزيل مستخدمًا من الحساب |
list_user_roles | للقراءة فقط | يسرد كل أدوار المستخدمين المتاحة التي يمكن تعيينها |
create_custom_role | كتابة | ينشئ دورًا مخصصًا. ويتطلب حصة خطة مخصصة، ويعيد 403 إن لم تمنحها الخطة. استدعِ list_user_roles أولًا لمعرفة الأدوار الموجودة |
update_user_role | إتلافي | يغيّر دور مستخدم موجود |
النشاط
| الأداة | النوع | الوصف |
|---|---|---|
get_activity_feed | للقراءة فقط | يسرد ما جرى في الحساب — من أنشأ ماذا أو غيّره أو حذفه، ومتى — مع التصفية بحسب نوع الحدث أو عضو الفريق أو التاريخ |
get_activity_summary | للقراءة فقط | يحصل على أعداد النشاط في الحساب خلال فترة ما |
النطاقات المخصصة
| الأداة | النوع | الوصف |
|---|---|---|
list_custom_domains | للقراءة فقط | يسرد النطاقات المخصصة للروابط القصيرة في الحساب (مثل qr.example.com)، وأيها الافتراضي، وهل كلٌّ منها موثَّق |
get_custom_domain | للقراءة فقط | يحصل على تفاصيل نطاق مخصص واحد — التحقق منه عبر DNS (TXT/CNAME)، وحالة SSL، وهل هو الافتراضي |
العمليات المجمّعة والوسائط
| الأداة | النوع | الوصف |
|---|---|---|
list_bulk_operations | للقراءة فقط | يسرد العمليات المجمّعة في الحساب — التوليد والتحديث المجمّعان لرموز QR — مع حالة كل عملية ونتائجها |
get_bulk_operation_stats | للقراءة فقط | يحصل على الإجماليات عبر العمليات المجمّعة في الحساب |
list_media | للقراءة فقط | يسرد الملفات في مكتبة وسائط الحساب — الصور وملفات PDF ومقاطع الفيديو وغيرها — لاختيار شعار أو مستند لرمز QR مثلًا |
التكاملات وتتبع التحويلات
| الأداة | النوع | الوصف |
|---|---|---|
get_integrations_overview | للقراءة فقط | يبيّن التكاملات التي ربطها الحساب — Webhooks وZapier وSlack وHubSpot وGoogle Analytics — وحالة كلٍّ منها |
list_webhooks | للقراءة فقط | يسرد Webhooks الحساب: الوجهة التي يرسل إليها كلٌّ منها الأحداث، ولأي نماذج أو رموز QR، وهل هو مفعّل |
list_tracking_sites | للقراءة فقط | يسرد المواقع المُعدّة لتتبع التحويلات، مع نطاقاتها |
list_tracking_funnels | للقراءة فقط | يسرد مسارات التحويل لموقع تتبع — الخطوات من المسح إلى التحويل |
صفحات الهبوط
| الأداة | النوع | الوصف |
|---|---|---|
list_page_templates | للقراءة فقط | يسرد قوالب صفحات الهبوط لرموز QR التي تفتح صفحة — قوالب Scanova نفسها، أو القوالب المحفوظة في الحساب فقط |
تتخطى الأدوات الإتلافية مربع التأكيد بحكم التصميم — فبروتوكول MCP لا يتضمن خطوة “هل أنت متأكد؟”، وما يحدث من تأكيد يخضع لأعراف واجهة عميل الذكاء الاصطناعي الذي تستخدمه. فتحقق مما يوشك استدعاء
delete_* أو update_* أو remove_user أن يفعله قبل الموافقة عليه، كما تفعل مع أي إجراء كتابة آخر تُوكله إلى مساعد.ذات صلة
- نظرة عامة على MCP — ما هو الخادم، وما يستطيع فعله بإيجاز، وشروط الوصول إليه
- إعداد MCP — اربط عميل ذكاء اصطناعي بالخادم الذي يوفّر هذه الأدوات
- نظرة عامة على واجهة الإدارة — الواجهة الأساسية التي تستدعيها هذه الأدوات بالنيابة عنك