موصّل مساعدي الذكاء الاصطناعي

خادم بروتوكول سياق النموذج (MCP) · قنزية ذ.م.م

نظرة عامة

قنزية دليل ثنائي اللغة (بالعربية والإنجليزية) لمزوّدي الخدمات المحلية في دول الخليج (عيادات وصالونات وشركات تنظيف ومدرّسين وغيرهم) مع إمكانية حجز المواعيد عبر الإنترنت. يتيح موصّل قنزية MCP هذا الدليل ومسار الحجز لمساعدي الذكاء الاصطناعي مثل ChatGPT وClaude، فيتمكّن المستخدم من البحث عن مزوّد وحجز موعد لديه مباشرة من داخل المحادثة، دون مغادرة المساعد.

لا حاجة إلى حساب في قنزية. الحجز متاح كضيف، ويُعرَّف بالاسم ورقم الهاتف.

الربط

الموصّل عبارة عن خادم MCP بعيد واحد، يمكن الوصول إليه عبر Streamable HTTP على العنوان:

https://qunzia.com/api/mcp

ChatGPT

وضع المطوّر ← إضافة تطبيق ← أدخل عنوان الرابط أعلاه. أو انتقل مباشرة إلى إعدادات موصّلات ChatGPT.

Claude

الإعدادات ← الموصّلات ← إضافة موصّل مخصّص ← أدخل عنوان الرابط أعلاه. أو انتقل مباشرة إلى إعدادات موصّلات Claude.

أي عميل MCP

يتحدّث الخادم بروتوكول MCP القياسي عبر Streamable HTTP، ويمكن اختباره باستخدام @modelcontextprotocol/inspector أو أي عميل متوافق. عند أول اتصال يعيد الخادم قائمة أدواته وتعليمات الاستخدام التي تشرح المسار المعتاد من البحث إلى الحجز.

المصادقة

يعمل الموصّل دون تسجيل الدخول: الحجز كضيف مدعوم بالكامل. وإذا سجّلت الدخول بحسابك في قنزية عبر OAuth، تُربَط حجوزاتك تلقائيًا بحسابك فتظهر أيضًا في لوحة التحكم على الويب، ويمكنك عرضها أو تعديل موعدها أو إلغاؤها دون تكرار رقم هاتفك. يستخدم تسجيل الدخول معيار OAuth 2.1 مع PKCE؛ ولا توجد بيانات اعتماد خاصة بالموصّل.

تُعرَّف حجوزات الضيوف برقم الهاتف الذي تمّ الحجز به: رقم الهاتف نفسه مع الرمز المرجعي للحجز يكفيان للاطّلاع عليه أو تعديل موعده أو إلغائه لاحقًا، على غرار نموذج الرقم المرجعي المعتاد في الشراء كضيف.

الأدوات

يوفّر الموصّل الأدوات التالية. أدوات القراءة لا تعدّل البيانات أبدًا؛ أما أدوات الكتابة فتنشئ حجزًا أو تعدّله أو تلغيه.

الأداة	النوع	ماذا تفعل
`search_providers`	قراءة	البحث في الدليل بالكلمة المفتاحية والفئة والموقع (الدولة / المدينة / المنطقة). تُعيد قائمة مرتّبة ومقسّمة إلى صفحات بالمزوّدين مع معرّفاتهم.
`get_provider`	قراءة	تفاصيل كاملة عن مزوّد واحد عبر معرّفه: الوصف والفئة والمدينة ووسائل التواصل والتقييم وساعات العمل والخدمات القابلة للحجز مع أسعارها.
`list_reviews`	قراءة	تقييمات العملاء المعتمدة لمزوّد معيّن: التعليقات والتقييم العام والتقييمات التفصيلية وأي ردود نشرها المزوّد. مقسّمة إلى صفحات.
`check_availability`	قراءة	أوقات بدء المواعيد المتاحة لدى مزوّد: تاريخ محلي واحد، أو حتى أسبوع كامل دفعة واحدة، في فرع محدّد. أما المزوّدون الذين لم ينشروا تقويمًا فيقبلون أوقاتًا مطلوبة للتأكيد لاحقًا.
`list_cities`	قراءة	كل المدن والمناطق التي تغطيها قنزية حاليًا، مع إمكانية التصفية حسب الدولة.
`list_categories`	قراءة	كل فئات الخدمات والفئات الفرعية التي تدعمها قنزية.
`book_appointment`	كتابة	طلب موعد لدى مزوّد، كضيف أو بعد تسجيل الدخول. تُعيد رمزًا مرجعيًا؛ وبحسب المزوّد يُؤكَّد الحجز فورًا أو يبقى بانتظار موافقته.
`list_my_bookings`	قراءة	مواعيد العميل القادمة، يتم البحث عنها برقم الهاتف أو عبر حساب قنزية الذي سجّل الدخول.
`reschedule_appointment`	كتابة	نقل حجز قائم إلى وقت جديد. يتطلّب الرمز المرجعي للحجز ورقم الهاتف الذي تمّ الحجز به.
`cancel_appointment`	كتابة	إلغاء حجز قائم. يتطلّب الرمز المرجعي للحجز ورقم الهاتف الذي تمّ الحجز به.
`link_qunzia_account`	قراءة	رابط لتسجيل الدخول إلى حساب قنزية أو إنشائه، لتظهر الحجوزات تلقائيًا في لوحة التحكم على الويب.

تُعالَج جميع أوقات المواعيد بالتوقيت المحلي للمزوّد. المسار المعتاد:

search_providersget_providercheck_availabilitybook_appointment

التعامل مع البيانات والخصوصية

لا يتلقّى الموصّل سوى مدخلات الأدوات المحدّدة التي يرسلها المساعد نيابةً عنك: كلمات البحث، وعند اختيارك الحجز، اسم العميل ورقم الهاتف والبريد الإلكتروني الاختياري اللازمة لإنشاء الموعد. ولا يتلقّى محادثتك مع المساعد ولا يخزّنها. التفاصيل الكاملة، بما فيها مدد الاحتفاظ وحقوقك، موضّحة في القسم ١٣ من سياسة الخصوصية.

الدعم

للأسئلة أو مشكلات التكامل أو الإبلاغ عن سلوك غير متوقّع من الموصّل، تواصل معنا على info@qunzia.com.