مرجع MCP للمالك

يقع خادم MCP الخاص بالمالك على https://mcp.qaema.ai. اتصل به كما هو موضح في اربط وكيلك؛ يعمل كل استدعاء أدناه بصفتك أنت، عبر الصلاحيات التي منحتها وقت الاتصال.

الأدوات حسب الصلاحية

ترفض الأداة العمل خارج الصلاحية الممنوحة لها برسالة missing scope <scope> — reconnect the agent and grant it <scope>.

`venue:read`

الأداة	ما تفعله
`list_venues`	سرد المنشآت في منظمتك.
`get_analytics`	المسحات، والزوار، ومعدل مشاهدة→إضافة، والمصادر، واللغات، وأثر الشارات، ورؤى أسبوعية.
`list_feedback`	تقييمات الزوار وتعليقاتهم، مع ملخص.
`get_billing_status`	باقتك وحالة اشتراكك.
`list_plans`	سعر كل باقة وما تتضمنه.
`list_docs`	سرد صفحات قاعدة المعرفة هذه بلغة واحدة.
`search_docs`	البحث في قاعدة المعرفة هذه؛ يعيد الصفحات المطابقة مع مقتطف.
`get_doc`	قراءة صفحة واحدة من قاعدة المعرفة كـmarkdown، حسب الـslug.

`venue:write`

الأداة	ما تفعله
`create_venue`	إنشاء منشأة مع مسودة قائمة فارغة.
`update_venue`	تحديث الملف الشخصي، والتواصل، وساعات العمل، والروابط، والتوصيل، والاستلام، وقسم متابعتنا. رقم واتساب أو هاتف فارغ للحجز أو الاستلام يستخدم رقم تواصل المنشأة؛ ويُرفض الحفظ إن لم يوجد أيٌّ منهما.
`generate_qr`	إنشاء رموز QR للطاولات أو الاستلام أو التوصيل.
`mark_feedback_read`	تعليم صفوف التقييمات كمقروءة.

`menu:read`

الأداة	ما تفعله
`get_menu`	قراءة مسودة القائمة، بأقسامها وأصنافها.
`get_change_log`	التغييرات الأخيرة من الوكلاء والأشخاص، مع القيم قبل وبعد.
`list_unavailable_items`	الأصناف النافدة حاليًا، مع موعد عودتها ومن أخرجها.
`audit_menu`	العثور على ما ينقصه من سعرات حرارية، أو مسببات حساسية، أو صور، أو ترجمات، أو تكرارات.
`get_theme_suggestions`	اقتراح قالب قائم على قواعد استنادًا إلى حجم القائمة ونسبة الصور فيها.

`menu:write`

الأداة	ما تفعله
`import_menu`	وضع قائمة مستخرجة من صورة أو PDF أو موقع أو إنستغرام في مرحلة المراجعة. لا شيء يُنشر مباشرة.
`confirm_import`	تطبيق استيراد معلَّق على المسودة، مع التصحيحات.
`discard_import`	تجاهل استيراد معلَّق دون تطبيقه.
`publish_menu`	نشر مسودة القائمة كنسخة جديدة.
`unpublish_menu`	إلغاء نشر القائمة (تعود إلى مسودة).
`undo_change`	التراجع عن تغيير واحد بمعرّفه.
`upsert_sections`	إنشاء أقسام أو إعادة تسميتها.
`upsert_items`	إنشاء أصناف أو تحديثها. عند التحديث، تمسح القيمة `null` السعر، أو السعر قبل الخصم، أو السعرات، أو الوصف.
`delete_items`	حذف أصناف حذفًا ناعمًا (قابل للتراجع).
`set_allergens`	استبدال مسببات حساسية صنف واحد، وقائمة “قد يحتوي”، والوسوم الغذائية.
`set_item_badges`	ضبط ما يصل إلى شارتين (`new`، `offer`) على الأصناف.
`set_item_contexts`	اختيار أين تظهر الأصناف: داخل المطعم، أو الاستلام، أو التوصيل.
`upload_media`	إرفاق صورة بصنف أو ضبط شعار المنشأة.
`set_item_availability`	تعليم أصناف أو أقسام بأنها نفدت، أو إعادتها. تصبح حية خلال 30 ثانية.
`set_theme`	ضبط قالب المنشأة، وألوانها، وخطوطها، ونصف قطرها، وتخطيطها.

أدوات الحجز

تعمل أدوات Qaema Book فقط على منشأة مفعَّل فيها الحجز؛ كل استدعاء يتحقق من ذلك أولاً.

`book:read`

الأداة	ما تفعله
`get_availability`	الفترات المتاحة والمحجوزة والمغلقة والفائتة لمنشأة في يوم واحد.
`list_bookings`	سرد حجوزات منشأة، الأحدث بدءًا أولاً.

`book:write`

الأداة	ما تفعله
`create_booking`	حجز موعد لزائر. متكرر بأمان (idempotent) عبر `command_id`.
`cancel_booking`	إلغاء حجز؛ يُرفض عند عدم تطابق `expected_revision`.
`claim_security`	احتجاز جزء من مبلغ التأمين على حجز مكان، من المغادرة حتى 48 ساعة بعدها؛ ويُعاد الباقي للضيف فورًا.
`set_book_settings`	تحديث إعدادات الحجز (فاصل الفترات، مهلة الحجز، فواصل الصلاة، وغيرها).
`block_time`	حجب فترة زمنية لمورد واحد أو للمنشأة كاملة.
`add_service`	إضافة خدمة قابلة للحجز: الاسم، والمدة، والسعر.
`add_resource`	إضافة مورد قابل للحجز (موظف، أو مقصورة، أو ملعب، أو فريق، أو غرفة، أو مكان).

`dry_run`

تقبل update_venue وgenerate_qr وimport_menu وdiscard_import وpublish_menu وunpublish_menu وundo_change وupsert_items القيمة dry_run: true لمعاينة النتيجة — الفرق، أو العدد، أو ما سيُتجاهل — دون كتابة أي شيء.

الودجت (Widgets)

تحمل ثلاث أدوات ودجت تفاعلية للعملاء الذين يدعمون MCP Apps، إلى جانب نتيجة الأداة النصية التي يحصل عليها كل عميل:

import_menu ← مراجعة الاستيراد (ui://qaema/import-review)
set_theme ← معاينة المظهر (ui://qaema/theme-preview)
get_analytics ← التحليلات (ui://qaema/analytics)

العميل الذي لا يدعم MCP Apps يحصل مع ذلك على الإجابة كاملة — الملخص النصي نفسه والبيانات المهيكلة (JSON) التي يعيدها أي أداة أخرى — لكنه لا يعرض الودجت المضمّن؛ افتح صفحة لوحة التحكم المقابلة بدلاً من ذلك (/app/imports/{id}، /app/theme، /app/analytics).

المطالبات (Prompts)

يسجّل الخادم مطالبتين يمكن لعميلك عرضهما كنقطة انطلاق: import_menu_from_file (تحويل صورة قائمة أو PDF إلى استدعاء import_menu) وimport_menu_from_instagram (تحويل حساب إنستغرام الخاص بك نفسه إلى استدعاء مماثل).

حدود المعدل

مسار MCP الخاص بالمالك نفسه لا يحمل أي حد للمعدل — الوصول إليه محكوم برمز OAuth بدلاً من ذلك. (فقط MCP العام للقائمة، الذي يصل إليه مساعد الزائر الذكي الخاص به على {slug}.qaema.ai/mcp، محدود المعدل بـ60 طلبًا في الدقيقة لكل عنوان.)

التراجع

يتراجع undo_change عن كتابة الوكيل تمامًا كما يتراجع عن تعديل من لوحة التحكم — كلاهما يمر عبر سجل التغييرات نفسه، وكلاهما قابل للتراجع باستثناء قلة من الإجراءات المعلَّمة بلا عكس (راجع التراجع وسجل التغييرات).

الوصول واستيراد الصور

يتطلب موصل المالك عضوية حالية بدور مالك أو مدير، بالإضافة إلى الصلاحيات الممنوحة. لا تستطيع حسابات الموظفين استخدام هذا الموصل. تغيير الدور إلى موظف أو إزالة العضوية يوقف الطلبات التالية حتى لو لم تنته صلاحية الرمز.

للصور، أرسل base64 مع نوع الصورة (JPEG أو PNG أو WebP، حتى 10 MB). يعمل الاستيراد عبر source_url فقط من مصدر صور وافق عليه مشغّل المنصة، دون إعادة توجيه. إذا رُفض المصدر، ارفع صورة المالك مباشرة أو اطلب من مساعدك إرسالها بصيغة base64. التنزيلات لها حدود للحجم والوقت؛ ولا تُحفظ الصورة عند رفض الاستيراد.