API и интеграционная поверхность
Как партнёры и разработчики интегрируются с Fooodo — публичный MCP-сервер, POS-коннектор и white-label-контракты, что открыто и что закрыто сегодня, а также дорожная карта интеграций.
Публичная интеграционная поверхность Fooodo невелика и чётко сфокусирована. На этой странице описано, что открыто сегодня, что закрыто и что запланировано на будущее.
Что открыто сегодня
MCP-сервер
Fooodo запускает сервер Model Context Protocol (MCP) по адресу /api/mcp, чтобы AI-агенты могли запрашивать справочник и выполнять ограниченный набор действий от имени покупателя. Агенты читают справочник без парсинга HTML и отправляют структурированные запросы без заполнения HTML-форм — благодаря этому ассистенты партнёрской поддержки, копилоты для оценки интеграций и агенты закупок на стороне покупателя опираются на канонические данные и попадают в нужный почтовый ящик.
# Connect from Claude Desktop, Cursor, or any MCP-compatible client:
mcp connect https://fooodo.com/api/mcpИнструменты чтения (без побочных эффектов):
| Инструмент | Возвращает |
|---|---|
list_docs | Все страницы справочника со slug, заголовком и однострочным описанием. |
get_doc({ slug }) | Обработанное MDX-содержимое отдельной страницы. |
search_docs({ query }) | Поиск по подстроке в заголовках, описаниях и текстах страниц с фрагментом вокруг каждого совпадения. |
list_pos_connectors | Действующие POS-коннекторы и политика скоупинга для остальных на уровне конкретного клиента. |
get_pricing_scope({ locations?, region? }) | Модель взаимодействия (подписка за локацию, EUR), индикаторы сегмента (Insights в комплекте от 5 локаций, Enterprise от 150+) и вердикт о соответствии для введённых покупателем данных. Не возвращает цену — платформа тарифицируется индивидуально; инструмент возвращает структуру взаимодействия, чтобы агент покупателя мог квалифицировать сделку перед запросом коммерческого предложения. |
Инструмент действия (отправляет письмо команде Fooodo):
| Инструмент | Действие |
|---|---|
request_walkthrough({ name, email, variant?, company?, role?, locations?, message?, locale?, agent_origin? }) | Отправляет лид-письмо в операционный отдел от имени покупателя, которого представляет агент. Ответы поступают на email в течение двух рабочих дней. variant по умолчанию равен demo; передайте pricing для запроса коммерческого предложения, partner — для интереса к реселлерству, developer — для оценки интеграции API/MCP. agent_origin отображается в письме, чтобы операционный отдел мог отдельно обрабатывать лиды, поступившие от агентов, в отличие от заявок через форму. |
Инструмент действия имеет ограничение по частоте запросов на email покупателя (3 в час), а вся MCP-поверхность ограничена по IP (60 вызовов в минуту). Лид-письма по умолчанию направляются на info@fooodo.com.
Insights MCP-сервер (для каждого тенанта)
Отдельный MCP-сервер поставляется с каждым тенантом Fooodo Insights. Если MCP справочника выше открывает публичный контент Fooodo и действие захвата лидов, то Insights MCP открывает собственную операционную аналитику конкретного тенанта — сводки по периодам, эффективность каналов и продуктов, данные P&L, трёх AI-специалистов, кросс-доменный оркестратор и ограниченный набор операций записи, таких как запуск импорта данных и закрытие алерта.
Сервер использует OAuth 2.1 с динамической регистрацией клиентов поверх Streamable HTTP, поэтому любой MCP-совместимый клиент подключается через единый поток в один клик. По умолчанию функция отключена для каждой организации; включение и выделение URL тенанта осуществляются через support@fooodo.com. Полный перечень инструментов, настройка для каждого клиента и детали безопасности: Insights MCP-сервер.
Индекс сайта для LLM
/llms.txt предоставляет плоский структурированный индекс всех публичных страниц маркетингового сайта и справочника. /llms-full.txt — тот же справочник, объединённый в один Markdown-документ для единовременного приёма. Оба файла являются каноническими точками входа, если вы направляете LLM на Fooodo.
Sitemap и Open Graph
Стандартные поверхности — /sitemap.xml охватывает все 7 маркетинговых локалей × публичные маршруты. Изображения Open Graph и Twitter Card генерируются для каждой локали.
Что закрыто сегодня
API заказов приложения меню и API платежей платёжного сервиса не являются публичными. Они работают на инфраструктуре, которую эксплуатируют наши партнёры по развёртыванию, и защищены учётными данными, выдаваемыми каждому партнёру в процессе онбординга.
Если вы — POS-вендор и хотите интегрироваться с Fooodo, напишите на hello@fooodo.com — сегодня путь интеграции требует ручного сопровождения и не является самообслуживанием.
С чем партнёры реально интегрируются
Существующие сегодня форматы интеграций, в порядке убывания числа использующих их партнёров:
POS-коннектор (бэкенд)
Наиболее востребованная интеграция. Новый POS-коннектор реализует тот же входящий и исходящий контракт, что использует R-Keeper (см. интеграция с R-Keeper). Коннектор представляет собой Laravel-пакет, добавляемый в приложение меню, — это не отдельный процесс.
Необходимая поверхность:
- Получение меню (продукты, категории, модификаторы, цены, налоговые флаги)
- Отправка заказа (создание, обновление, блокировка, отметка об оплате)
- Статус (ресторан онлайн/офлайн, состояние стола)
R-Keeper — единственный коннектор, работающий в продакшене сегодня. Сам контракт коннектора не зависит от конкретного POS — дополнительные POS-коннекторы скоупируются под каждого клиента и тарифицируются по запросу. Если вы — POS-вендор и заинтересованы в совместной разработке коннектора, свяжитесь с нами по адресу partners@fooodo.com.
White-label-развёртывание (фронтенд)
Некоторые реселлеры запускают развёртывание Fooodo под собственным брендом. Клиентское приложение поддерживает брендовую конфигурацию на уровне компании: логотип, цветовые токены, домен, брендинг платежей. Это конфигурационная поверхность, а не API.
Встраиваемые виджеты (лёгкий вариант)
Виджет AI Ask на этом сайте можно встроить в партнёрские сайты с помощью одного тега script. Другие виджеты (предпросмотр меню, доступность столиков) ещё не выпущены, но включены в дорожную карту.
Аутентификация и секреты
Когда партнёры получают доступ к API (пакеты POS-коннекторов, white-label-развёртывания), аутентификация осуществляется через bearer-токен. Секреты выдаются для каждой среды; для стейджинга и продакшена используются отдельные токены. OAuth-потока сегодня нет — аудитория, использующая API, слишком мала, чтобы его внедрение было оправданным.
Вебхуки (входящие, для партнёров) — запланировано
Для партнёрских развёртываний исходящие вебхуки для событий заказов включены в дорожную карту интеграций. Планируемый набор событий:
order.createdorder.paidorder.cancelledorder.errored
Внутренние события, лежащие в основе этих вебхуков, уже существуют на стороне приложения меню; исходящий диспетчер подключается для каждого партнёра в процессе онбординга, а не работает как сервис по умолчанию. Если вам нужна доставка событий в рамках вашей интеграции, поднимите этот вопрос на этапе скоупинга — мы добавим её в ваше развёртывание как опциональный модуль.
Версионирование
Внутренние API не имеют версий — приложение меню и платёжный сервис развёртываются совместно для Čili Pizza. Как только внешние партнёры начнут использовать API, мы введём теги версий. До этого момента мы ещё не дошли.
Ограничения частоты запросов
Публичные API маркетингового сайта (/api/ask, /api/mcp) имеют ограничения по частоте запросов на IP. Лимиты в настоящее время не публикуются; они рассчитаны на обычное партнёрское использование и будут увеличены для партнёров, заключивших соглашение.
Дорожная карта
В порядке убывания приоритета:
- Второй POS-коннектор — скоупируется под конкретного клиента, когда сеть берёт на себя обязательства.
- Типизированный JS SDK для потока white-label-встраивания.
- Публичный API только для чтения для запросов меню (чтобы партнёрские сайты могли показывать «меню на сегодня» без парсинга).
Если вам что-то из этого нужно раньше, напишите на hello@fooodo.com — запросы партнёров, как правило, ускоряют реализацию.
Скидки, купоны и программы лояльности
Руководство оператора по привлечению гостей и увеличению среднего чека через Fooodo — скидки с временным окном, купонные коды, программы лояльности на базе POS, перекрёстные продажи на кассе, чаевые и пожертвования.
Fooodo Insights
Слой AI-поддержки принятия решений для ресторанных сетей от 5 до 200 заведений — каждая рекомендация привязана к EBIT, человек всегда участвует в процессе, и шестиуровневая архитектура, лежащая в основе.