Available tools

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

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

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

البدء

جسر توثيق Scanova

تصميم رمز QR

إدارة رموز QR

التحليلات

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

النماذج

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

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

ذات صلة

​جسر توثيق Scanova

​تصميم رمز QR

​إدارة رموز QR

​التحليلات

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

​النماذج

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

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

​ذات صلة

جسر توثيق Scanova

تصميم رمز QR

إدارة رموز QR

التحليلات

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

النماذج

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

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

ذات صلة