Menubarcode MCP
किसी भी AI एजेंट के लिए
पांच सर्वर एजेंट्स को लाइव मेन्यू, ऑर्डर, एनालिटिक्स और थीम टूलिंग से जोड़ते हैं। दो को बिल्कुल साइनअप की ज़रूरत नहीं।
एक मिनट से भी कम में कनेक्ट करें
अपना क्लाइंट
हर स्निपेट सार्वजनिक Catalog सर्वर को टारगेट करता है, इसलिए यह बिना किसी सेटअप के ज्यों का त्यों काम करता है। नीचे दिए किसी भी एंडपॉइंट से बदलें; टोकन सर्वर जोड़ते हैं --header "Authorization: Bearer YOUR_TOKEN".
एंडपॉइंट कॉपी करें
सार्वजनिक Catalog URL। आप इसे स्टेप 2 में अपने क्लाइंट को देंगे।
https://menubarcode.com/mcp/catalogइसे अपने क्लाइंट में जोड़ें
आपके टर्मिनल में एक कमांड, फिर रन करें /mcp यह पुष्टि करने के लिए कि यह कनेक्ट हो गया:
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalogटोकन सर्वर के लिए (जैसे Admin), हेडर पास करें:
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"वेब या डेस्कटॉप पर Claude में: सेटिंग्स → कनेक्टर्स → कस्टम कनेक्टर जोड़ें, फिर स्टेप 1 से एंडपॉइंट URL पेस्ट करें।
वन-क्लिक इंस्टॉल (Cursor खुलता है):
या इसे मैन्युअल रूप से जोड़ें ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}वन-क्लिक इंस्टॉल (VS Code खुलता है):
या इसे मैन्युअल रूप से जोड़ें .vscode/mcp.json. ध्यान दें कि VS Code एक अलग स्कीमा उपयोग करता है (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}ChatGPT में डेवलपर मोड सक्षम करें, एक कस्टम कनेक्टर जोड़ें, और स्टेप 1 से सर्वर URL पेस्ट करें।
Windsurf, Zed और अन्य क्लाइंट जो कमांड की अपेक्षा रखते हैं, HTTP एंडपॉइंट को इसके साथ रैप करें mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}सर्वर एकल-रिस्पॉन्स Streamable HTTP POST पर JSON-RPC 2.0 बोलते हैं। टूल्स की सूची बनाएं:
curl -s https://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://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://menubarcode.com/mcp/catalog then confirm it connected and list its tools.इसके बजाय बना रहे हैं या डीबग कर रहे हैं? गहन प्रोटोकॉल रेफ़रेंस यहां मौजूद है /developers.
पांच सर्वर, एक प्रोटोकॉल
5 सर्वरों में 55 टूल्स। दो सार्वजनिक हैं। सभी Streamable HTTP POST पर JSON-RPC 2.0 बोलते हैं।
| सर्वर | एंडपॉइंट | प्रमाणीकरण | उपकरण |
|---|---|---|---|
menubarcode-catalog-mcp |
https://menubarcode.com/mcp/catalog |
Public | 4 |
menubarcode-dev-mcp |
https://menubarcode.com/mcp/dev |
Public | 8 |
menubarcode-mcp |
https://menubarcode.com/mcp |
API token | 23 |
menubarcode-storefront-mcp |
https://menubarcode.com/mcp/storefront |
Storefront token | 13 |
menubarcode-customer-mcp |
https://menubarcode.com/mcp/customer |
Customer token | 7 |
आपको कौन-सा सर्वर आप चाहिए?
अपनी भूमिका चुनें। हर कार्ड सही सर्वर, उसके ऑथ, और उसके टूल्स की ओर इशारा करता है।
OW स्टोर मालिक
अपने AI असिस्टेंट से मेन्यू, ऑर्डर, कूपन, समय प्रबंधित करें और अपना खुद का एनालिटिक्स पढ़ें।
https://menubarcode.com/mcpAG शॉपिंग-एजेंट बिल्डर
पूरे प्लेटफ़ॉर्म पर रेस्टोरेंट खोजें, फिर एक स्टोर ब्राउज़ करें और सर्वर-प्राइस्ड, अनपेड ऑर्डर दें।
https://menubarcode.com/mcp/catalogDV थीम / ऐप डेवलपर
प्लेटफ़ॉर्म सीखें, आधिकारिक Liquid रेफ़रेंस पाएं, और मार्केटप्लेस की अपनी जांचों से अपनी थीम को वैलिडेट करें, यह सब आपके एडिटर में।
https://menubarcode.com/mcp/devCU डाइनर / कस्टमर
अपने ऑर्डर देखें, डिलीवरी ट्रैक करें, और साइन-इन असिस्टेंट से किसी पुराने ऑर्डर को ड्राफ़्ट के रूप में फिर से बनाएं।
https://menubarcode.com/mcp/customerके लिए बनाएं Menubarcode
एक स्टोरफ़्रंट थीम या पार्टनर ऐप शिप करें। पब्लिक Dev सर्वर आपके बनाने के दौरान आपके एडिटर को प्लेटफ़ॉर्म एक्सपर्ट बना देता है।
TH थीम बनाएं
OS 2.0 सेक्शन, एक टाइप्ड सेटिंग्स स्कीमा और पूर्ण कॉमर्स रनटाइम के साथ Liquid-आधारित स्टोरफ़्रंट थीम।
- starter theme डाउनलोड करें और थीम गाइड खोलें: पैकेज लेआउट, theme.json, सेक्शन, और Drop रेफ़रेंस।
- Dev सर्वर कनेक्ट करें और Liquid रेफ़रेंस और सेक्शन स्कीमा के साथ बनाएं जो आपके एडिटर से जवाब देते हैं।
- सबमिट करने से पहले validate_theme चलाएं: यह मार्केटप्लेस की अपनी जांचें लागू करता है और हर एरर की सूची देता है।
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP ऐप बनाएं
पार्टनर ऐप्स डैशबोर्ड को विस्तार देते हैं: OAuth एक्सेस, सेशन टोकन, एम्बेडेड सरफ़ेस, webhooks और यूसेज बिलिंग।
- ऐप गाइड पढ़ें: OAuth और टोकन, स्कोप, एम्बेडेड ऐप्स और webhook इवेंट्स।
- अपनी पार्टनर ऐप रजिस्टर करें, केवल वे स्कोप मांगें जिनकी आपको ज़रूरत है, और सैंडबॉक्स स्टोर पर डेवलप करें।
- लिस्टिंग और समीक्षा की आवश्यकताएँ पूरी करें, फिर ऐप मार्केटप्लेस में सबमिट करें।
बिल्ड करते समय, Dev सर्वर पर मौजूद search_docs और fetch_full_doc, एडिटर छोड़े बिना API और वेबहुक से जुड़े सवालों के जवाब देते हैं।
टूल कैटलॉग
5 सर्वरों में 55 टूल्स। किसी सर्वर को विस्तृत करके देखें कि उसका एजेंट क्या कर सकता है। पूर्ण 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 | पथ (path) के ज़रिए एक पूर्ण दस्तावेज़ प्राप्त करें। |
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> | डाइनर साइन-इन (पंजीकरण / लॉग इन / OTP) | केवल उसी डाइनर का अपना खाता |
हर टोकन 60 अनुरोध/मिनट और 1000/घंटा तक सीमित है। Storefront सर्वर इसके बजाय 120/मिनट की अनुमति देता है। सीमा पार करने पर HTTP 429 मिलता है: गति धीमी करें और फिर से प्रयास करें।
सीक्रेट्स केवल एक बार दिखाए जाते हैं, केवल SHA-256 हैश के रूप में संग्रहीत होते हैं, और डैशबोर्ड से कभी भी रद्द किए जा सकते हैं।
सुरक्षा
- न्यूनतम विशेषाधिकार दें। Admin टोकन क्षमता-सीमित होते हैं: एजेंट को केवल वही क्षमताएँ दें जिनकी उसे ज़रूरत है। जिन टूल्स का वह उपयोग नहीं कर सकता, वे उसकी टूल सूची से पूरी तरह छुपा दिए जाते हैं।
- ह्यूमन कन्फर्मेशन चालू रखें। राइट्स को अपने-आप स्वीकृत न करें; हर राइट वास्तविक है और इसका ऑडिट यहाँ से होता है: mcp।
- सीक्रेट स्वच्छता। टोकन केवल एक बार दिखाए जाते हैं और हैश किए हुए रूप में संग्रहीत होते हैं। इन्हें कभी भी कोड या रेपो में शामिल न करें; उजागर होने पर इन्हें बदल दें।
- जहाँ संभव हो, केवल-पठन को प्राथमिकता दें। एनालिटिक्स या शॉपिंग एजेंट्स के लिए, रीड-स्कोप्ड या सार्वजनिक सर्वर, राइट-सक्षम सर्वर से अधिक सुरक्षित है।
सवाल हैं चला गया
MCP क्या है?
Model Context Protocol एक ओपन स्टैंडर्ड है जो AI एजेंट्स (Claude, Cursor, ChatGPT और अन्य) को अनुमान लगाने के बजाय सर्वर पर वास्तविक टूल्स कॉल करने देता है। अपने क्लाइंट को हमारे पांच एंडपॉइंट्स में से किसी एक पर पॉइंट करें और एजेंट मेन्यू ब्राउज़ कर सकता है, ऑर्डर दे सकता है, आपकी सेल्स पढ़ सकता है, या लाइव Menubarcode डेटा के आधार पर थीम को वैलिडेट कर सकता है।
कौन-से क्लाइंट कनेक्ट हो सकते हैं?
Streamable HTTP पर कोई भी MCP-सक्षम क्लाइंट: Claude Code, Claude (वेब और डेस्कटॉप), Cursor, VS Code, ChatGPT डेवलपर मोड, Windsurf, Zed, या raw curl। हर एक के लिए सटीक वन-कमांड सेटअप हेतु Connect your client सेक्शन देखें।
मुझे कौन-सा सर्वर चाहिए?
शॉपिंग एजेंट्स सार्वजनिक Catalog और Storefront सर्वर का उपयोग करते हैं। स्टोर मालिक API टोकन के साथ Admin सर्वर उपयोग करते हैं। थीम और ऐप डेवलपर सार्वजनिक 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 रेफ़रेंस के साथ बनाएं, और मार्केटप्लेस में सबमिट करने से पहले Dev सर्वर के validate_theme टूल से वैलिडेट करें। ऐप्स: OAuth एक्सेस, webhooks, एम्बेडेड डैशबोर्ड सरफ़ेस और यूसेज बिलिंग के लिए पार्टनर ऐप रजिस्टर करें। दोनों गाइड /developers के अंतर्गत उपलब्ध हैं।
क्या मेरा व्हाइट-लेबल डोमेन इसे इस्तेमाल कर सकता है?
जी हां। इस पेज पर हर सर्वर, नाम और URL ब्रांड-अवेयर है: रीसेलर डोमेन पर एंडपॉइंट्स रीसेलर के अपने ब्रांड और स्लग किए गए सर्वर नामों का प्रचार करते हैं, प्लेटफ़ॉर्म के कभी नहीं। /.well-known/mcp.json पर डिस्कवरी मेनिफ़ेस्ट भी ब्रांड-अवेयर है।
मैं अपना लिस्टेड डेटा कैसे हटवाऊं?
पब्लिक Catalog सर्वर केवल सक्रिय, सार्वजनिक रूप से सूचीबद्ध स्टोर्स को लिस्ट करता है और मालिक की PII कभी उजागर नहीं करता। किसी स्टोर के डैशबोर्ड सेटिंग्स में पब्लिक लिस्टिंग बंद करें और वह कैटलॉग परिणामों में आना बंद हो जाता है।
