Menubarcode MCP
لأي وكيل ذكاء اصطناعي
تربط خمسة خوادم الوكلاء بالقوائم المباشرة والطلبات والتحليلات وأدوات القوالب. اثنان منها لا يحتاجان إلى تسجيل على الإطلاق.
اربط عميلك
يستهدف كل مقتطف خادم Catalog العام، لذا يعمل حرفيًا بلا أي إعداد. استبدله بأي نقطة نهاية أدناه؛ خوادم الرموز تضيف --header "Authorization: Bearer YOUR_TOKEN".
انسخ نقطة النهاية
رابط Catalog العام. ستُسلّمه إلى عميلك في الخطوة 2.
https://www.menubarcode.com/mcp/catalogأضفه إلى عميلك
أمر واحد في الطرفية، ثم شغّل /mcp للتأكد من نجاح الاتصال:
claude mcp add --transport http menubarcode-catalog-mcp https://www.menubarcode.com/mcp/catalogلخادم يتطلب رمزًا (مثل Admin)، مرّر الترويسة:
claude mcp add --transport http menubarcode-mcp https://www.menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"في Claude على الويب أو سطح المكتب: الإعدادات → الموصلات → إضافة موصل مخصص, ثم الصق رابط نقطة النهاية من الخطوة 1.
تثبيت بنقرة واحدة (يفتح Cursor):
أو أضفه يدويًا إلى ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://www.menubarcode.com/mcp/catalog" }
}
}تثبيت بنقرة واحدة (يفتح VS Code):
أو أضفه يدويًا إلى .vscode/mcp.json. لاحظ أن VS Code يستخدم مخططًا مختلفًا (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://www.menubarcode.com/mcp/catalog" }
}
}فعّل وضع المطوّر في ChatGPT، وأضف موصلًا مخصصًا، والصق رابط الخادم من الخطوة 1.
بالنسبة إلى Windsurf وZed والعملاء الأخرى التي تتوقع أمرًا، لُفّ نقطة نهاية HTTP باستخدام mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://www.menubarcode.com/mcp/catalog"]
}تتحدث الخوادم بروتوكول JSON-RPC 2.0 عبر طلب Streamable HTTP POST بردٍّ واحد. اسرد الأدوات:
curl -s https://www.menubarcode.com/mcp/catalog \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'استدعِ أداة (أضف -H "Authorization: Bearer YOUR_TOKEN" لخوادم الرموز):
curl -s https://www.menubarcode.com/mcp/catalog \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stores","arguments":{"query":"pizza"}}}'اطرح سؤالك الأول
يستدعي الوكيل أدوات حقيقية ويجيب ببيانات مباشرة. جرّب هذا المثال:
أو دع وكيلك البرمجي يُعِدّه
الصقه في Claude Code أو Cursor أو أي وكيل برمجي. سيضيف الخادم نيابةً عنك، دون الحاجة إلى الطرفية.
Set up the Menubarcode Catalog MCP server for me. Run: claude mcp add --transport http menubarcode-catalog-mcp https://www.menubarcode.com/mcp/catalog then confirm it connected and list its tools.تبني أو تصحّح الأخطاء بدلاً من ذلك؟ يوجد المرجع التفصيلي للبروتوكول على /developers.
خمسة خوادم، بروتوكول واحد
55 أداة عبر 5 خوادم. اثنان منها عامّان. وتتحدث جميعها بروتوكول JSON-RPC 2.0 عبر Streamable HTTP POST.
| الخادم | نقطة النهاية | المصادقة | أدوات |
|---|---|---|---|
menubarcode-catalog-mcp |
https://www.menubarcode.com/mcp/catalog |
Public | 4 |
menubarcode-dev-mcp |
https://www.menubarcode.com/mcp/dev |
Public | 8 |
menubarcode-mcp |
https://www.menubarcode.com/mcp |
API token | 23 |
menubarcode-storefront-mcp |
https://www.menubarcode.com/mcp/storefront |
Storefront token | 13 |
menubarcode-customer-mcp |
https://www.menubarcode.com/mcp/customer |
Customer token | 7 |
أي خادم أنت تحتاجه؟
اختر دورك. تشير كل بطاقة إلى الخادم المناسب ومصادقته وأدواته.
OW صاحب المتجر
أدر القوائم والطلبات والكوبونات وساعات العمل، واطّلع على تحليلاتك الخاصة من مساعدك بالذكاء الاصطناعي.
https://www.menubarcode.com/mcpAG منشئ وكيل التسوق
اكتشف المطاعم عبر المنصة، ثم تصفّح متجرًا واحدًا وقدّم طلبًا غير مدفوع بسعر يحدّده الخادم.
https://www.menubarcode.com/mcp/catalogDV مطوّر القوالب / التطبيقات
تعرّف على المنصة، واحصل على المرجع الرسمي لـ Liquid، وتحقّق من صحة قالبك باستخدام فحوصات المتجر نفسها، كل ذلك من داخل محرّرك.
https://www.menubarcode.com/mcp/devCU الطاعم / العميل
اطّلع على طلباتك الخاصة، وتتبّع توصيلة، وأعد بناء طلب سابق كمسودة من مساعد مسجَّل الدخول.
https://www.menubarcode.com/mcp/customerطوّر لـ Menubarcode
أطلق قالب متجر أو تطبيق شريك. يحوّل خادم Dev العام محرّرك إلى خبير بالمنصة أثناء البناء.
TH أنشئ قالبًا
قوالب متجر مبنية على Liquid بأقسام OS 2.0 ومخطط إعدادات مُصنَّف ووقت تشغيل تجاري كامل.
- نزّل starter theme وافتح دليل القوالب: تخطيط الحزمة، وtheme.json، والأقسام، ومرجع Drop.
- اربط خادم Dev وابنِ باستخدام مرجع Liquid ومخطط الأقسام اللذين يجيبان مباشرة من محرّرك.
- شغّل validate_theme قبل الإرسال: فهو يطبّق فحوصات المتجر نفسها ويسرد كل خطأ.
claude mcp add --transport http menubarcode-dev-mcp https://www.menubarcode.com/mcp/devAP ابنِ تطبيقاً
توسّع تطبيقات الشركاء لوحة التحكم: وصول OAuth، ورموز الجلسات، وواجهات مضمّنة، وwebhooks، وفوترة الاستخدام.
- اقرأ دليل التطبيقات: OAuth والرموز، والنطاقات، والتطبيقات المضمّنة، وأحداث webhook.
- سجّل تطبيق شريكك، واطلب فقط النطاقات التي تحتاجها، وطوّر مقابل متجر تجريبي (sandbox).
- استوفِ متطلبات الإدراج والمراجعة، ثم قدّم طلبك إلى سوق التطبيقات.
أثناء البناء، تجيب search_docs وfetch_full_doc على خادم Dev عن أسئلة API والويب هوك دون مغادرة المحرر.
أداة الكتالوج
55 أداة عبر 5 خوادم. وسّع أي خادم لمعرفة ما يمكن لوكيله فعله. تتوفر المخططات الكاملة بصيغة JSON ضمن المرجع التقني للمطورين.
menubarcode-catalog-mcp (4 أدوات) عام
اكتشف المطاعم على مستوى المنصة بأكملها. المتاجر النشطة والمُدرجة للعامة فقط؛ لا يتم عرض بيانات المالك الشخصية أبدًا.
search_stores | ابحث عن المطاعم بالاسم أو نوع المطبخ. |
search_items | ابحث عن طبق في جميع المتاجر («من يبيع الشاورما بالقرب مني»). |
get_store | تفاصيل متجر واحد إضافةً إلى رابط مباشر يوجهك إلى خادم Storefront الخاص به. |
menubarcode-storefront-mcp (13 أدوات) Storefront: رمز
كل ما يحتاجه وكيل التسوق في مطعم واحد. create_order يضع طلبًا غير مدفوع يحدد الخادم سعره. لا تُرسل الأسعار أبدًا.
search_menu | ابحث في قائمة الطعام في هذا المتجر. |
get_item | تفاصيل كاملة لعنصر واحد (المتغيرات، الإضافات، العلامات). |
validate_cart | تحقق من السلة واحصل على الإجمالي الذي يحسبه الخادم قبل الطلب. |
create_order | ضع طلبًا غير مدفوع بسعر يحدده الخادم. |
order_status | الحالة الحالية للطلب. |
order_eta | الوقت المتوقع حتى يصبح الطلب جاهزًا. |
order_history | الطلبات السابقة في هذا المتجر. |
reorder_last | أعد بناء آخر طلب كسلة جديدة. |
store_credit_balance | رصيد المتجر المتاح للمتسوق. |
restaurant_info | ساعات العمل والعنوان وخيارات الطلب. |
suggest_upsell | الإضافات ذات الصلة بالسلة الحالية. |
dietary_answer | أجب عن سؤال غذائي بخصوص القائمة. |
menubarcode-mcp (23 أدوات) رمز API
صندوق أدوات المالك. الأدوات مقيّدة حسب صلاحيات كل رمز: أي شيء لا يستطيع الرمز فعله يُخفى من القائمة. أداتا CRM تحتاجان أيضًا ميزة crm_suite. تتم مراجعة كل عملية كتابة عبر: mcp.
list_restaurants | مطاعمك |
get_menu | فئات المطعم وعناصره. |
list_categories | فئات القائمة مع عدد العناصر في كل منها. |
list_orders | الطلبات، قابلة للتصفية حسب الحالة/التاريخ/البحث. |
get_order | تفاصيل كاملة لطلب واحد. |
get_analytics | عدد الطلبات والإيرادات خلال N يومًا. |
sales_report | ملخص مبيعات رسمي لفترة زمنية محددة. |
get_restaurant_settings | لقطة للملف الشخصي وإعدادات الطلب. |
list_coupons | كوبونات الخصم الخاصة بك. |
list_customers crm_suite | قائمة عملاء CRM الخاصة بك. |
get_customer crm_suite | السجل الكامل لعميل واحد في CRM. |
add_menu_item | أنشئ عنصرًا في القائمة. |
update_menu_item | عدّل اسم العنصر أو سعره أو وصفه. |
delete_menu_item | احذف عنصرًا نهائيًا. |
set_item_availability | وسم عنصر كمتوفر/غير متوفر في المخزون (مفتاح «86»). |
add_category | أنشئ فئة في القائمة. |
update_category | أعد تسمية فئة أو رتّبها من جديد. |
delete_category | احذف فئة فارغة. |
update_order_status | قدّم حالة الطلب إلى المرحلة التالية. |
update_business_hours | عيّن نص ساعات العمل المعروض للعامة. |
create_coupon | أنشئ كوبون خصم. |
update_coupon | عدّل كوبونًا. |
delete_coupon | احذف كوبونًا. |
menubarcode-customer-mcp (7 أدوات) رمز Customer
الحساب الخاص بالزبون المسجّل دخوله. تُستمد الهوية من الرمز فقط؛ لا يمكن الوصول إلى بيانات أي عميل آخر إطلاقًا.
my_orders | طلباتك الأخيرة. |
order_detail | تفاصيل كاملة لأحد طلباتك. |
track_order | الحالة المباشرة لطلبك. |
reorder | أعد بناء طلب سابق كمسودة سلة. |
my_profile | ملفك الشخصي في هذا المطعم. |
menubarcode-dev-mcp (8 أدوات) عام
يحوّل أي محرر يدعم MCP إلى خبير بالمنصة: تعلّم وابنِ وتحقق دون مغادرة محررك.
learn_platform | مقدمة تعريفية عن المنصة. استدعِ هذه الأداة أولًا. |
get_liquid_reference | القائمة البيضاء الرسمية لـ Liquid (تُنشأ لحظيًا). |
get_section_schema | تنسيق كتلة مخطط قسم القالب (الإعدادات، الكتل، الربط). |
search_docs | بحث بالكلمات المفتاحية عبر وثائق المطورين. |
fetch_full_doc | أحضر مستندًا كاملًا واحدًا عبر مساره. |
validate_theme | شغّل فحوصات السوق الخاصة على ملفات قالبك. |
submit_feedback | أبلغ عن نقص في الوثائق أو شيء كان خاطئًا أو ناقصًا. |
جرّبه الآن
افتح Claude مع تعبئة الطلب مسبقًا. ابدأ بالطلبات التي لا تحتاج مصادقة.
"ابحث لي عن أفضل شاورما تقييمًا بالقرب مني وأرِني القائمة."
"تحقق من قالبي وفق قواعد سوق Menubarcode، واذكر كل خطأ."
"ما هي العناصر الأكثر مبيعًا لديّ هذا الأسبوع، وما الإيرادات التي حققتها؟"
"أضف عرض رمضان خاصًا إلى قائمتي بسعر 25 SAR وضعه كمتوفر."
"أعد طلب المعتاد من متجري المفضل كمسودة سلة."
"تتبّع طلبي الأخير وأخبرني بالوقت المتوقع للوصول."
المصادقة الرموز
خادمان عموميان. أما الخوادم الثلاثة الأخرى فتتطلب مصادقة برمز تملكه أنت.
| الخادم | كيف يصادق العميل | أين تحصل على الرمز | النطاق |
|---|---|---|---|
| Catalog / Dev | لا شيء (عام) | غير مطلوب | عام، للقراءة فقط |
| Admin | Authorization: Bearer <token> | لوحة التحكم → مفاتيح API / Connect AI | حسب الصلاحية (قراءة/كتابة عبر 6 موارد)؛ تحتاج أدوات CRM إلى crm_suite |
| Storefront | X-Storefront-Token: <token> | لوحة التحكم → رموز واجهة المتجر | لكل متجر؛ نطاقات menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | تسجيل دخول الزبون (تسجيل / دخول / رمز تحقق) | حساب ذلك الزبون فقط |
يقتصر كل رمز على 60 طلبًا في الدقيقة و1000 في الساعة. أما خادم Storefront فيسمح بـ 120 في الدقيقة بدلًا من ذلك. تجاوز الحد يُعيد HTTP 429: تمهّل ثم أعد المحاولة.
تُعرض الأسرار مرة واحدة فقط، وتُخزَّن كتجزئة SHA-256 فقط، ويمكن إلغاؤها في أي وقت من لوحة التحكم.
الأمان
- امنح أقل الصلاحيات الممكنة. رموز Admin مقيّدة حسب الصلاحيات: امنح الوكيل الصلاحيات التي يحتاجها فقط. الأدوات التي لا يمكنه استخدامها تُخفى تمامًا من قائمة أدواته.
- أبقِ التأكيد البشري مفعّلًا. لا توافق تلقائيًا على عمليات الكتابة؛ فكل عملية كتابة حقيقية وتُراجَع عبر: mcp.
- نظافة الأسرار. تُعرض الرموز مرة واحدة وتُخزَّن بصيغة مجزّأة. لا تُدرجها أبدًا في الكود أو المستودعات؛ بدّلها إذا تعرّضت للانكشاف.
- افضّل الاقتصار على القراءة فقط حيثما أمكن. بالنسبة لوكلاء التحليلات أو التسوق، يُعد الخادم المقتصر على القراءة أو العام أكثر أمانًا من الخادم القادر على الكتابة.
لديك أسئلة غادر
ما هو MCP؟
بروتوكول سياق النموذج (Model Context Protocol) هو معيار مفتوح يتيح لوكلاء الذكاء الاصطناعي (Claude وCursor وChatGPT وغيرها) استدعاء أدوات حقيقية على خادم بدلاً من التخمين. وجّه العميل إلى إحدى نقاط النهاية الخمس لدينا، ويصبح بإمكان الوكيل تصفح القوائم وتقديم الطلبات وقراءة مبيعاتك أو التحقق من صحة قالب مقابل بيانات Menubarcode المباشرة.
ما العملاء التي يمكنها الاتصال؟
أي عميل يدعم MCP عبر Streamable HTTP: Claude Code وClaude (الويب وسطح المكتب) وCursor وVS Code ووضع المطوّر في ChatGPT وWindsurf وZed أو curl مباشرة. راجع قسم Connect your client للحصول على إعداد بأمر واحد لكل منها.
ما الخادم الذي أحتاجه؟
تستخدم وكلاء التسوق خادمَي Catalog وStorefront العامّين. يستخدم أصحاب المتاجر خادم Admin برمز API. يستخدم مطوّرو القوالب والتطبيقات خادم Dev العام. يستخدم الطاعمون خادم Customer بحساب تسجيل الدخول الخاص بهم. تربط بطاقات "Which server do you need؟" كل فئة من الجمهور بخادمها.
هل هو مجاني؟
الاتصال مجاني. خادما Catalog وDev عامّان بالكامل: بلا تسجيل وبلا مفتاح. أما خوادم Admin وStorefront وCustomer فتحتاج إلى رمز تملكه بالفعل كمالك أو متجر أو طاعم مسجّل الدخول.
هل أحتاج إلى مفتاح API؟
ليس لخادمين من أصل خمسة. خادما Catalog (اكتشاف المطاعم) وDev (بناء القوالب) عامّان ولا يحتاجان إلى أي مفتاح على الإطلاق. أما الخوادم الثلاثة الأخرى فتُوثَّق باستخدام رمز تولّده من لوحة التحكم أو تحصل عليه عند تسجيل الدخول.
كيف تُحمى عمليات الكتابة؟
كل عملية كتابة مقيّدة بنطاق مالك الرمز، ويُسجَّل تدقيقها باسم via: mcp. رموز Admin مقيّدة بالصلاحيات: امنح فقط ما يحتاجه الوكيل، وتُخفى الأدوات التي لا يملك صلاحيتها تمامًا من قائمة الأدوات. أبقِ مطالبة التأكيد البشري في عميلك مفعّلة حتى لا تعمل أي أداة دون أن تراها.
ما هي حدود معدل الطلبات؟
يقتصر كل رمز على 60 طلبًا/دقيقة و1000 طلب/ساعة (بينما يسمح خادم Storefront بـ 120/دقيقة بدلاً من ذلك). أي زيادة على ذلك تُعيد HTTP 429. تمهّل ثم أعد المحاولة.
هل يمكنني بناء قالبي أو تطبيقي الخاص؟
نعم. القوالب: نزّل starter theme، وابنِ باستخدام مرجع Liquid، وتحقّق منه بأداة validate_theme في خادم Dev قبل إرساله إلى المتجر. التطبيقات: سجّل تطبيق شريك للحصول على وصول OAuth وwebhooks وواجهات لوحة تحكم مضمّنة وفوترة استخدام. كلا الدليلين متاحان ضمن /developers.
هل يمكن لنطاقي ذي العلامة البيضاء استخدامه؟
نعم. كل خادم واسم ورابط في هذه الصفحة يراعي العلامة التجارية: على نطاق أحد الموزّعين، تُعلن نقاط النهاية عن العلامة التجارية الخاصة بالموزّع وأسماء خوادم مُشتقّة منها، لا عن علامة المنصة أبدًا. ملف الاكتشاف في /.well-known/mcp.json يراعي العلامة التجارية أيضًا.
كيف يمكنني إزالة بياناتي المدرجة؟
لا يُدرج خادم Catalog العام سوى المتاجر النشطة والمُدرجة للعامة، ولا يكشف أبدًا عن بيانات هوية المالك الشخصية. أوقف الإدراج العام لمتجر ما من إعدادات لوحة تحكمه ليتوقف عن الظهور في نتائج الكتالوج.
