دليل وصلة الحسبة
خادم الحسبة MCP لربط مساعدات الذكاء الاصطناعي ببيانات الحسبة
نظرة عامة
توفر الحسبة خادم Model Context Protocol (MCP) مستضافًا يتيح لمساعدات الذكاء الاصطناعي الوصول المباشر إلى بيانات الحسبة العقارية في الكويت وأدوات التقدير. وبعد الربط، يمكنك تقييم العقارات، وتقدير الإيجارات وتكلفة البناء، والبحث في الإعلانات والصفقات المسجلة والمزادات، والاطلاع على المؤشرات العقارية، وحساب التمويل، وذلك باستخدام اللغة الطبيعية ودون الحاجة إلى التنقل بين الشاشات. تُقدَّم هذه الخدمة باسم «وصلة الحسبة» (HisbaPass)، ويخضع استخدامها لـاتفاقية الاستخدام وسياسة الاستخدام العادل (الإصدار 1.0).
يسير العمل عادةً على النحو التالي:
- الاستكشاف: التعرّف على المناطق وأنواع العقارات والخيارات التي تقبلها كل أداة تقدير
- البحث: في الإعلانات والصفقات المسجلة والمزادات والمؤشرات العقارية
- التقدير: الحصول على تقديرات القيمة والإيجار وتكلفة البناء والتمويل
- المتابعة: تحسين النتائج بأسئلة إضافية في المحادثة نفسها
الأدوات المتاحة
| الفئة | الأداة | الوصف |
|---|---|---|
| تقييم العقار | get_value_factors | عرض المساحات والمواقع والشوارع والارتدادات المتاحة لمنطقة معيّنة (أرض أو مبنى) |
estimate_value | تقدير القيمة السوقية لأرض أو مبنى في صورة نطاق سعري | |
| تقدير الإيجار | get_residential_rent_factors | عرض أنواع العقارات والطوابق وأعمار المباني والمساحات المتاحة للإيجار السكني |
estimate_residential_rent | تقدير الإيجار الشهري لشقة أو طابق أو منزل أو فيلا | |
get_investment_rent_factors | عرض خيارات الإيجار الاستثماري (شقة أو محل أو سرداب) | |
estimate_investment_rent | تقدير الإيجار الشهري لشقة استثمارية أو محل أو سرداب | |
| البناء | get_cce_factors | عرض خيارات جودة التشطيب المتاحة لتقدير تكلفة البناء |
estimate_construction_cost | تقدير تكلفة البناء وفق مساحة قطعة الأرض وعدد الطوابق ووجود السرداب ومستوى التشطيب | |
assess_finishing_quality | تحديد درجة التشطيب (A–D) من خلال استبيان من عشرة أسئلة | |
| الإعلانات | get_ads | البحث في إعلانات البيع والإيجار والمبادلة مع إمكانية التصفية حسب السعر والمساحة والتاريخ |
get_ad_types | عرض أنواع الإعلانات (بيع، إيجار، مبادلة، …) | |
get_property_categories | عرض فئات العقارات (سكني، تجاري، استثماري، …) | |
get_property_types | عرض أنواع العقارات (شقة، أرض، فيلا، …) | |
get_areas | عرض جميع المناطق العقارية في الكويت | |
| الصفقات | get_deals | البحث في صفقات البيع المسجلة حسب المنطقة والتاريخ والسعر والمساحة |
get_shorted_property_groupings | عرض تصنيفات الصفقات (وحدة، مبنى، أرض) | |
| المزادات | get_auctions | البحث عن المزادات والجهات المنظِّمة لها ومواعيدها |
get_property_auctions | البحث في العقارات المعروضة في المزادات مع إمكانية التصفية حسب المنطقة والسعر والمساحة والتاريخ | |
| المؤشرات العقارية | init_market_index | عرض ملخص المؤشر والفترات الزمنية وخيارات التصفية المتاحة |
get_market_index_data | عرض مؤشر الأسعار أو حجم التداول عبر الزمن للكويت أو لمنطقة محددة | |
get_market_index_areas | ترتيب المناطق حسب تغيّر السعر أو سعر المتر المربع أو عدد الصفقات أو قيمتها | |
| بيانات العقار | get_gis_nearby | عرض بيانات العقار وما يحيط به باستخدام الرقم الآلي (PACI) |
| التمويل | calculate_monthly_payment | حساب القسط الشهري للتمويل العقاري |
get_finance_amount | حساب الحد الأقصى لمبلغ التمويل بناءً على الراتب والالتزامات | |
get_finance_request_init | تحميل الخيارات اللازمة لتعبئة طلب التمويل | |
submit_finance_request | إرسال طلب التمويل إلى البنك الشريك بعد تأكيدك للبيانات | |
| رحلة الشراء | buy_property_journey | رحلة شراء موجَّهة: القدرة الشرائية، ثم المناطق المتاحة، ثم السيناريوهات، ثم الإثبات، ثم الإحالة |
| قاعدة المعرفة | search_docs | البحث في قوانين العقار الكويتية واشتراطات البناء وتقارير الحسبة عن السوق |
get_disclaimer | عرض نص الشروط وإخلاء المسؤولية الخاص بأداة تقدير أو مؤشر |
رابط خادم MCP
https://live-mcp.alhisba.com/mcpالصلاحيات والوصول
تسجّل الدخول بحسابك الشخصي في الحسبة، ولذلك يُنفَّذ كل ما يقوم به المساعد باسمك. وتُحدَّد الأدوات والبيانات المتاحة لك وفق خطة اشتراك جهتك في وصلة الحسبة.
الحساب المخوَّل شخصي لشخص واحد، ولا يجوز مشاركة بيانات الدخول أو جلسة الربط مع أي شخص آخر، ولو كان من الجهة نفسها.
عند الربط، تعرض الحسبة شاشة موافقة تتضمن اسم التطبيق الذي يطلب الوصول والحساب الذي سجّلت الدخول به، ولا تتم مشاركة أي بيانات إلا بعد تأكيدك الالتزام باتفاقية الاستخدام والضغط على السماح.
طريقة الربط
يعتمد خادم الحسبة MCP على OAuth؛ إذ تسجّل الدخول من المتصفح بحسابك في الحسبة ثم توافق على الربط. اختر مساعدك من الأقسام التالية.
Claude
- انتقل إلى Settings → Connectors → Add custom connector
- أدخل الاسم Alhisba ثم أدخل رابط خادم MCP
- اضغط Connect، ثم سجّل الدخول إلى الحسبة، ثم أكّد التزامك باتفاقية الاستخدام واضغط السماح
ChatGPT
يتطلب ربط خادم MCP مخصص في ChatGPT تفعيل Developer Mode. انتقل إلى Settings → Security and login وفعِّل Developer Mode، ثم اتبع الخطوات التالية:
- انتقل إلى Plugins وأضف إضافة جديدة، ثم أدخل رابط خادم MCP واختر OAuth طريقةً للمصادقة
- سجّل الدخول إلى الحسبة، ثم أكّد التزامك باتفاقية الاستخدام واضغط السماح
- يمكنك اختياريًا نشر الموصل في مساحة العمل ليستخدمه زملاؤك (بشرط أن تكون حساباتهم مخوَّلة أيضًا)
أمثلة على الاستفسارات
بعد الربط، جرّب أن تسأل مساعدك:
التقييم والإيجار
- «كم تبلغ قيمة أرض مساحتها 500 متر مربع في الرميثية على شارع داخلي؟»
- «كم يبلغ إيجار طابق أرضي في منزل حديث في مشرف؟»
- «كم يبلغ إيجار محل في السالمية؟»
الصفقات والسوق
- «ما أحدث صفقات الأراضي في القرين خلال الأشهر الثلاثة الماضية؟»
- «ما المناطق التي سجّلت أعلى ارتفاع في الأسعار خلال هذا الربع؟»
- «كيف تغيّر مؤشر الأسعار في الكويت خلال العامين الماضيين؟»
الإعلانات والمزادات
- «ابحث عن شقق للإيجار في الجابرية بأقل من 400 دينار»
- «هل توجد مزادات عقارية في الشهر المقبل؟»
- «ما العقارات المعروضة في المزادات في الأحمدي؟»
البناء والتمويل
- «كم تبلغ تكلفة بناء منزل من طابقين مع سرداب على قطعة أرض مساحتها 400 متر مربع وبتشطيب متوسط؟»
- «راتبي 1,800 دينار ولديّ قسط شهري بقيمة 200 دينار، فما مبلغ التمويل الذي يمكنني الحصول عليه؟»
- «أرغب في شراء منزل؛ ساعدني في تحديد ميزانيتي والمناطق المناسبة لي»
القوانين والاشتراطات
- «ما نسبة البناء المسموح بها في السكن الخاص؟»
- «ما الارتدادات المطلوبة في المباني التجارية؟»
اعتبارات الأمان
بعد الربط، يستطيع المساعد قراءة بيانات الحسبة وتنفيذ إجراءات نيابةً عنك، مثل إرسال طلب تمويل أو حفظ بيانات رحلة الشراء. ويُفترض أن يطلب المساعد تأكيدك قبل أي إرسال، لكن احرص على مراجعة ما سيقوم به. كما تُرسَل أسئلتك وردود الحسبة إلى مزوّد الذكاء الاصطناعي الذي تستخدمه (Claude أو ChatGPT)، لذا راجع سياسة معالجة البيانات لديه قبل الربط.
ضوابط الوصول
- لا يمكن الربط إلا للحسابات التي فعّلت لها الحسبة خدمة MCP
- يجب أن توافق بنفسك على كل عملية ربط من خلال شاشة الموافقة في الحسبة
- لا يطّلع المساعد إلا على ما يتيحه حسابك في alhisba.com
- يُطبَّق مستوى اشتراكك دون تغيير
اعتبارات أخرى
- قبل الربط، عطّل في إعدادات مساعدك الذكي أي خيار يسمح باستخدام محادثاتك في تدريب النماذج أو تحسينها، أو استخدم خطة أو اتفاقية خدمة مع المزوّد تستبعد ذلك تعاقديًا. لا تتحكم الحسبة في معالجة المزوّد لبياناتك أو احتفاظه بها أو إعدادات التدريب لديه، ولا يضمن الربط بخادم MCP وحده استبعاد بياناتك من التدريب.
- لا تضغط السماح إلا إذا كنت أنت من بدأ عملية الربط؛ إذ توضّح شاشة الموافقة الجهة التي ستُعاد إليها
- لإلغاء الوصول، احذف موصل الحسبة أو افصله من Claude أو ChatGPT
- عند استخدام مساحة عمل مشتركة، قد يتمكن الآخرون من الاطلاع على سجل المحادثات
اتفاقية الاستخدام
يخضع استخدام وصلة الحسبة لـاتفاقية الاستخدام وسياسة الاستخدام العادل (الإصدار 1.0)، الموقَّعة بين الحسبة وجهتك، وهي المرجع في كل ما يتعلق بحقوق الاستخدام وقيوده. هذا الدليل لشرح طريقة الاستخدام فقط.
حل المشكلات
- «تم إيقاف وصول المساعد الذكي لهذا الحساب.»: خدمة MCP غير مفعّلة لحسابك. لتفعيلها، راسلنا عبر واتساب على الرقم +965 6002 0778.
- «انتهت صلاحية طلب الربط.»: انتهت مهلة رابط تسجيل الدخول. ارجع إلى Claude أو ChatGPT وابدأ الربط من جديد.
- «هذا الرابط غير صالح أو غير مكتمل.»: ابدأ الربط من Claude أو ChatGPT بدلًا من فتح رابط تسجيل الدخول مباشرةً.
- الربط بحساب غير صحيح: اضغط في شاشة الموافقة على لست أنت؟ بدّل الحساب. وإذا كان الربط قد تمّ، فافصل الموصل ثم أعد الربط.
- توقّف الأدوات عن العمل بعد فترة: افصل موصل الحسبة ثم أعد الربط.
- «تم تعليق الوصول بسبب تجاوز حدود الاستخدام.»: تجاوز حسابك حدود الاستخدام المقررة في خطة الاشتراك. راسلنا عبر واتساب على الرقم +965 6002 0778 لمراجعة الحالة أو ترقية الاشتراك.
- «يلزم تأكيد الالتزام بالنسخة المحدّثة من الاتفاقية.»: صدرت نسخة جديدة من اتفاقية الاستخدام تتطلب تأكيدك الصريح قبل مواصلة الاستخدام. افصل الموصل وأعد الربط، ثم أكّد التزامك بالنسخة الجديدة في شاشة الموافقة.