Menubarcode MCP
для любого ИИ-агента
Пять серверов связывают агентов с актуальными меню, заказами, аналитикой и инструментами для тем. Два из них вообще не требуют регистрации.
Подключение менее чем за минуту
Подключите свой клиент
Каждый фрагмент кода нацелен на публичный сервер Catalog, поэтому он работает как есть, без какой-либо настройки. Замените на любую конечную точку ниже; серверы с токеном добавляют --header "Authorization: Bearer YOUR_TOKEN".
Скопируйте конечную точку
Публичный URL сервера Catalog. Вы передадите его своему клиенту на шаге 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 в браузере или на компьютере: Настройки → Коннекторы → Добавить пользовательский коннектор, затем вставьте URL конечной точки из шага 1.
Установка в один клик (откроется 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, добавьте пользовательский коннектор и вставьте URL сервера из шага 1.
Windsurf, Zed и другие клиенты, ожидающие команду, оборачивают HTTP-конечную точку с помощью mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}Серверы используют JSON-RPC 2.0 через Streamable HTTP POST с одиночным ответом. Список инструментов:
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.
Пять серверов, один протокол
55 инструментов на 5 серверах. Два из них публичные. Все используют JSON-RPC 2.0 через Streamable HTTP POST.
| Сервер | Конечная точка | Аутентификация | Инструменты |
|---|---|---|---|
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 Владелец магазина
Управляйте меню, заказами, купонами, часами работы и просматривайте собственную аналитику через своего ИИ-ассистента.
https://menubarcode.com/mcpИнструменты Admin → Получить токен (Connect AI) → API-ключи →
AG Конструктор агента для покупок
Находите рестораны по всей платформе, затем просматривайте отдельный магазин и оформляйте неоплаченный заказ с ценой, рассчитанной сервером.
https://menubarcode.com/mcp/catalogDV Разработчик тем и приложений
Изучайте платформу, используйте официальный справочник Liquid и проверяйте свою тему теми же проверками, что применяет маркетплейс, — прямо в своём редакторе.
https://menubarcode.com/mcp/devCU Посетитель / клиент
Просматривайте свои заказы, отслеживайте доставку и воссоздавайте прошлый заказ как черновик через авторизованного ассистента.
https://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://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.
Может ли мой white-label домен использовать это?
Да. Каждый сервер, имя и URL на этой странице учитывают бренд: на домене реселлера конечные точки отображают собственный бренд реселлера и производные от него имена серверов, а не бренд платформы. Манифест обнаружения по адресу /.well-known/mcp.json также учитывает бренд.
Как убрать мои данные из списка?
Публичный сервер Catalog отображает только активные, публично размещённые магазины и никогда не раскрывает личные данные владельца. Отключите публичный листинг магазина в настройках панели управления — и он перестанет отображаться в результатах каталога.
