Menubarcode MCP
her yapay zekâ ajanı için
Beş sunucu, ajanları canlı menülere, siparişlere, analizlere ve tema araçlarına bağlar. İkisi hiç kayıt gerektirmez.
Bir dakikadan kısa sürede bağlanın
İstemcinizi bağlayın
Her kod parçası herkese açık Catalog sunucusunu hedefler, bu yüzden hiçbir kurulum yapmadan olduğu gibi çalışır. Aşağıdaki uç noktalardan herhangi biriyle değiştirin; belirteçli sunucular şunu ekler: --header "Authorization: Bearer YOUR_TOKEN".
Uç noktayı kopyalayın
Herkese açık Catalog URL'si. Bunu 2. adımda istemcinize vereceksiniz.
https://menubarcode.com/mcp/catalogİstemcinize ekleyin
Terminalinizde tek bir komut, ardından şunu çalıştırın /mcp bağlandığını doğrulamak için:
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalogBelirteçli bir sunucu için (örn. Admin), şu başlığı geçirin:
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"Web veya masaüstünde Claude'da: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle, ardından 1. adımdaki uç nokta URL'sini yapıştırın.
Tek tıkla kurulum (Cursor'u açar):
Veya şuna manuel olarak ekleyin: ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}Tek tıkla kurulum (VS Code'u açar):
Veya şuna manuel olarak ekleyin: .vscode/mcp.json. Not: VS Code farklı bir şema kullanır (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}ChatGPT'de geliştirici modunu etkinleştirin, özel bir bağlayıcı ekleyin ve 1. adımdaki sunucu URL'sini yapıştırın.
Bir komut bekleyen Windsurf, Zed ve diğer istemciler, HTTP uç noktasını şununla sarmalar: mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}Sunucular, tek yanıtlı bir Streamable HTTP POST üzerinden JSON-RPC 2.0 konuşur. Araçları listeleyin:
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"}'Bir aracı çağırın (şunu ekleyin: -H "Authorization: Bearer YOUR_TOKEN" belirteçli sunucular için):
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"}}}'İlk sorunuzu sorun
Ajan gerçek araçları çağırır ve canlı verilerle yanıt verir. Şunu deneyin:
Ya da kodlama ajanınızın kurmasına izin verin
Bunu Claude Code, Cursor veya herhangi bir kodlama ajanına yapıştırın. Sunucuyu sizin için ekler, terminale gerek yok.
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.Bunun yerine geliştirme mi yoksa hata ayıklama mı yapıyorsunuz? Ayrıntılı protokol referansı şurada: /developers.
Beş sunucu, tek protokol
5 sunucuda 55 araç. İkisi herkese açık. Hepsi Streamable HTTP POST üzerinden JSON-RPC 2.0 konuşur.
| Sunucu | Uç nokta | Kimlik doğrulama | Araçlar |
|---|---|---|---|
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 |
Hangi sunucuya Siz ihtiyacınız var?
Rolünüzü seçin. Her kart doğru sunucuyu, kimlik doğrulamasını ve araçlarını gösterir.
OW Mağaza sahibi
Menüleri, siparişleri, kuponları ve çalışma saatlerini yönetin, kendi analizlerinizi yapay zekâ asistanınızdan okuyun.
https://menubarcode.com/mcpAdmin araçları → Bir belirteç alın (Connect AI) → API anahtarları →
AG Alışveriş ajanı oluşturucu
Platform genelinde restoranları keşfedin, ardından bir mağazaya göz atın ve sunucu fiyatlandırmalı, ödemesiz bir sipariş verin.
https://menubarcode.com/mcp/catalogDV Tema / uygulama geliştiricisi
Platformu öğrenin, yetkili Liquid referansını edinin ve temanızı pazar yerinin kendi kontrolleriyle doğrulayın; hepsi düzenleyicinizde.
https://menubarcode.com/mcp/devCU Müşteri
Kendi siparişlerinizi görüntüleyin, bir teslimatı takip edin ve oturum açmış bir asistan üzerinden geçmiş bir siparişi taslak olarak yeniden oluşturun.
https://menubarcode.com/mcp/customerŞunun için geliştirin Menubarcode
Bir storefront teması veya ortak uygulama yayınlayın. Herkese açık Dev sunucusu, siz geliştirirken düzenleyicinizi bir platform uzmanına dönüştürür.
TH Bir tema oluşturun
OS 2.0 bölümleri, tipli bir ayar şeması ve tam ticaret çalışma zamanına sahip Liquid tabanlı storefront temaları.
- Başlangıç temasını indirin ve tema kılavuzunu açın: paket düzeni, theme.json, bölümler ve Drop referansı.
- Dev sunucusuna bağlanın ve düzenleyicinizden yanıt veren Liquid referansı ve bölüm şemasıyla geliştirin.
- Göndermeden önce validate_theme'i çalıştırın: pazar yerinin kendi kontrollerini uygular ve tüm hataları listeler.
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP Uygulama geliştir
Ortak uygulamalar panoyu genişletir: OAuth erişimi, oturum belirteçleri, gömülü yüzeyler, webhook'lar ve kullanım bazlı faturalama.
- Uygulama kılavuzunu okuyun: OAuth ve belirteçler, kapsamlar, gömülü uygulamalar ve webhook olayları.
- Ortak uygulamanızı kaydedin, yalnızca ihtiyacınız olan kapsamları isteyin ve bir sandbox mağazasına karşı geliştirin.
- Listeleme ve inceleme gereksinimlerini karşılayın, ardından uygulama pazar yerine gönderin.
Geliştirme yaparken, Dev sunucusundaki search_docs ve fetch_full_doc, editörden çıkmadan API ve webhook sorularını yanıtlar.
Araç Katalog
5 sunucuda 55 araç. Aracısının neler yapabileceğini görmek için bir sunucuyu genişletin. Tam JSON şemaları şurada bulunur: geliştirici referansı.
menubarcode-catalog-mcp (4 araç) Genel
Platform genelinde restoranları keşfedin. Yalnızca aktif, herkese açık listelenmiş mağazalar; sahibinin kişisel verileri asla paylaşılmaz.
search_stores | Restoranları isme veya mutfak türüne göre bulun. |
search_items | Bir yemeği tüm mağazalarda arayın ("yakınımda kim shawarma satıyor"). |
get_store | Bir mağazanın ayrıntıları ve Storefront sunucusuna yönelik bir deep-link ipucu. |
menubarcode-storefront-mcp (13 araç) Storefront: belirteçli
Bir alışveriş aracısının tek bir restoranda ihtiyaç duyduğu her şey. create_order fiyatı sunucu tarafından belirlenen, ödenmemiş bir sipariş oluşturur. Asla fiyat göndermeyin.
search_menu | Bu mağazanın menüsünde arama yapın. |
get_item | Bir ürünün tüm ayrıntıları (varyantlar, ekstralar, işaretler). |
validate_cart | Sipariş vermeden önce sepeti kontrol edin ve sunucu tarafından hesaplanan toplamı alın. |
create_order | Fiyatı sunucu tarafından belirlenen, ödenmemiş bir sipariş verin. |
order_status | Bir siparişin mevcut durumu. |
order_eta | Siparişin hazır olmasına kalan tahmini süre. |
order_history | Bu mağazadaki geçmiş siparişler. |
reorder_last | Son siparişi yeni bir sepet olarak yeniden oluşturun. |
store_credit_balance | Alışveriş yapan kişi için kullanılabilir mağaza kredisi. |
restaurant_info | Çalışma saatleri, adres ve sipariş seçenekleri. |
suggest_upsell | Mevcut sepet için ilgili ek ürünler. |
dietary_answer | Menüyle ilgili bir beslenme sorusunu yanıtlayın. |
menubarcode-mcp (23 araç) API token'ı
Sahibinin araç kutusu. Araçlar, jeton başına yetenek bazında sınırlandırılır: jetonun yapamadığı her şey listeden gizlenir. İki CRM aracı ayrıca crm_suite özelliğini gerektirir. Her yazma işlemi şu yolla denetlenir: mcp.
list_restaurants | Restoranlarınız |
get_menu | Bir restoranın kategorileri ve ürünleri. |
list_categories | Ürün sayılarıyla birlikte menü kategorileri. |
list_orders | Duruma/tarihe/aramaya göre filtrelenebilen siparişler. |
get_order | Bir siparişin tüm ayrıntıları. |
get_analytics | N gün boyunca sipariş sayısı ve gelir. |
sales_report | Bir tarih aralığı için yetkili satış özeti. |
get_restaurant_settings | Profil ve sipariş ayarlarının anlık görüntüsü. |
list_coupons | İndirim kuponlarınız. |
list_customers crm_suite | CRM müşteri listeniz. |
get_customer crm_suite | Bir müşterinin tam CRM kaydı. |
add_menu_item | Bir menü ürünü oluşturun. |
update_menu_item | Bir ürünün adını/fiyatını/açıklamasını düzenleyin. |
delete_menu_item | Bir ürünü kalıcı olarak silin. |
set_item_availability | Bir ürünü stokta/tükendi olarak işaretleyin ("86" anahtarı). |
add_category | Bir menü kategorisi oluşturun. |
update_category | Bir kategoriyi yeniden adlandırın veya sırasını değiştirin. |
delete_category | Boş bir kategoriyi silin. |
update_order_status | Bir siparişin durumunu ilerletin. |
update_business_hours | Herkese açık çalışma saatleri metnini ayarlayın. |
create_coupon | Bir indirim kuponu oluşturun. |
update_coupon | Bir kuponu düzenleyin. |
delete_coupon | Bir kuponu silin. |
menubarcode-customer-mcp (7 araç) Customer belirteci
Oturum açmış bir yemek yiyenin kendi hesabı. Kimlik yalnızca jetondan gelir; başka hiçbir müşterinin verilerine asla erişilemez.
my_orders | Son siparişleriniz. |
order_detail | Siparişlerinizden birinin tüm ayrıntıları. |
track_order | Siparişinizin canlı durumu. |
reorder | Geçmiş bir siparişi sepet taslağı olarak yeniden oluşturun. |
my_profile | Bu restorandaki profiliniz. |
menubarcode-dev-mcp (8 araç) Genel
MCP destekli herhangi bir editörü platform uzmanına dönüştürür: editörünüzden çıkmadan öğrenin, geliştirin, doğrulayın.
learn_platform | Platforma giriş. Önce bunu çağırın. |
get_liquid_reference | Yetkili Liquid izin listesi (canlı olarak oluşturulur). |
get_section_schema | Tema bölümü şema blok biçimi (ayarlar, bloklar, bağlantılar). |
search_docs | Geliştirici belgelerinde anahtar kelime araması. |
fetch_full_doc | Yola göre tam bir belge getirin. |
validate_theme | Tema dosyalarınız üzerinde pazar yerinin kendi kontrollerini çalıştırın. |
submit_feedback | Belgelerdeki bir eksikliği veya yanlış ya da eksik bir şeyi bildirin. |
Deneyin şimdi
Claude'u önceden doldurulmuş komutla açın. Önce kimlik doğrulama gerektirmeyen komutlar.
"Yakınımdaki en yüksek puanlı shawarma'yı bul ve menüyü göster."
"Menubarcode pazar yeri kurallarına göre temamı doğrulayın ve tüm hataları listeleyin."
"Bu hafta en çok satan ürünlerim hangileriydi ve ne kadar gelir getirdiler?"
"Menüme 25 SAR karşılığında bir Ramazan özel ürünü ekleyin ve mevcut olarak işaretleyin."
"Favori mağazamdan her zamanki siparişimi sepet taslağı olarak yeniden oluşturun."
"Son siparişimi takip edin ve tahmini varış süresini söyleyin."
Kimlik doğrulama Token'lar
İki sunucu herkese açıktır. Diğer üçü, sahip olduğunuz bir jetonla kimlik doğrular.
| Sunucu | İstemci nasıl kimlik doğrular | Jeton nereden alınır | Kapsam |
|---|---|---|---|
| Catalog / Dev | Yok (herkese açık) | Gerekli değil | Herkese açık, salt okunur |
| Admin | Authorization: Bearer <token> | Kontrol Paneli → API anahtarları / Connect AI | Yeteneğe göre (6 kaynak genelinde okuma/yazma); CRM araçları crm_suite gerektirir |
| Storefront | X-Storefront-Token: <token> | Kontrol Paneli → Vitrin token'ları | Mağaza başına; kapsamlar menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | Müşteri girişi (kayıt / giriş / OTP) | Yalnızca o müşterinin kendi hesabı |
Her jeton dakikada 60 ve saatte 1000 istekle sınırlıdır. Storefront sunucusu bunun yerine dakikada 120 isteğe izin verir. Bir sınırı aşmak HTTP 429 döndürür: yavaşlayın ve tekrar deneyin.
Gizli anahtarlar yalnızca bir kez gösterilir, yalnızca SHA-256 karması olarak saklanır ve panodan istediğiniz zaman iptal edilebilir.
Güvenlik
- En az ayrıcalığı verin. Yönetici jetonları yeteneğe göre kapsamlandırılır: bir aracıya yalnızca ihtiyaç duyduğu yetenekleri verin. Kullanamayacağı araçlar araç listesinden tamamen gizlenir.
- İnsan onayını açık tutun. Yazma işlemlerini otomatik onaylamayın; her yazma işlemi gerçektir ve şu yolla denetlenir: mcp.
- Gizli anahtar hijyeni. Jetonlar yalnızca bir kez gösterilir ve karması alınarak saklanır. Bunları asla koda veya depolara eklemeyin; açığa çıkarsa yenileyin.
- Mümkün olduğunda salt okunuru tercih edin. Analitik veya alışveriş aracıları için, salt okunur kapsamlı veya herkese açık bir sunucu, yazma yeteneğine sahip bir sunucudan daha güvenlidir.
Sorularınız mı var Ayrıldı
MCP nedir?
Model Context Protocol, yapay zekâ ajanlarının (Claude, Cursor, ChatGPT ve diğerleri) tahmin etmek yerine bir sunucudaki gerçek araçları çağırmasını sağlayan açık bir standarttır. Bir istemciyi beş uç noktamızdan birine yönlendirin; ajan menülere göz atabilir, sipariş verebilir, satışlarınızı okuyabilir veya bir temayı canlı Menubarcode verileriyle doğrulayabilir.
Hangi istemciler bağlanabilir?
Streamable HTTP üzerinden MCP destekli herhangi bir istemci: Claude Code, Claude (web ve masaüstü), Cursor, VS Code, ChatGPT geliştirici modu, Windsurf, Zed veya doğrudan curl. Her biri için tek komutluk kurulum talimatlarını “İstemcinizi bağlayın” bölümünde bulabilirsiniz.
Hangi sunucuya ihtiyacım var?
Alışveriş ajanları herkese açık Catalog ve Storefront sunucularını kullanır. Mağaza sahipleri bir API belirteciyle Admin sunucusunu kullanır. Tema ve uygulama geliştiricileri herkese açık Dev sunucusunu kullanır. Müşteriler kendi girişleriyle Customer sunucusunu kullanır. “Hangi sunucuya ihtiyacınız var?” kartları her kitleyi kendi sunucusuyla eşleştirir.
Ücretsiz mi?
Bağlanmak ücretsizdir. Catalog ve Dev sunucuları tamamen herkese açıktır: kayıt yok, anahtar yok. Admin, Storefront ve Customer sunucuları, sahip, mağaza veya oturum açmış bir müşteri olarak zaten sahip olduğunuz bir belirteç gerektirir.
Bir API anahtarına ihtiyacım var mı?
Beş sunucudan ikisi için gerekmez. Catalog (restoranları keşfetme) ve Dev (tema oluşturma) herkese açıktır ve hiçbir anahtar gerektirmez. Diğer üçü, panonuzda oluşturduğunuz veya oturum açtığınızda aldığınız bir belirteçle kimlik doğrular.
Yazma işlemleri nasıl korunur?
Her yazma işlemi belirteç sahibiyle sınırlıdır ve via: mcp olarak denetlenir. Admin belirteçleri yetenek bazlı kapsamlıdır: yalnızca ajanın ihtiyaç duyduğunu verin; izni olmayan araçlar araç listesinden tamamen gizlenir. Hiçbir aracın siz görmeden çalışmaması için istemcinizin insan onayı istemini açık tutun.
Hız sınırları nelerdir?
Her belirteç dakikada 60 ve saatte 1000 istekle sınırlıdır (Storefront sunucusu bunun yerine dakikada 120'ye izin verir). Bunun ötesindeki ani yüklenmeler HTTP 429 döndürür. Yavaşlayıp tekrar deneyin.
Kendi temamı veya uygulamamı oluşturabilir miyim?
Evet. Temalar: başlangıç temasını indirin, Liquid referansıyla geliştirin ve pazar yerine göndermeden önce Dev sunucusunun validate_theme aracıyla doğrulayın. Uygulamalar: OAuth erişimi, webhook'lar, gömülü pano yüzeyleri ve kullanım bazlı faturalama için bir ortak uygulama kaydedin. Her iki kılavuz da /developers altında yer alır.
Beyaz etiket alan adım bunu kullanabilir mi?
Evet. Bu sayfadaki her sunucu, ad ve URL markaya duyarlıdır: bir bayi alan adında, uç noktalar platformunkini değil, bayinin kendi markasını ve slug'lanmış sunucu adlarını gösterir. /.well-known/mcp.json adresindeki keşif bildirimi de markaya duyarlıdır.
Listelenen verilerimi nasıl kaldırabilirim?
Herkese açık Catalog sunucusu yalnızca aktif ve herkese açık olarak listelenen mağazaları listeler ve sahibin kişisel verilerini asla ifşa etmez. Bir mağazanın herkese açık listelenmesini pano ayarlarından kapatın; artık Catalog sonuçlarında görünmeyecektir.
