MCP Сервер — Руководство пользователя

Что это?#

MCP сервер (Model Context Protocol) для cenaly.ru позволяет подключать AI-ассистентов (Claude, ChatGPT, Cursor, VS Code Copilot и др.) к данным вашего ресторана. AI получает доступ к меню, локациям, заказам, изображениям и может управлять ими от вашего имени.

⚠️ В российском контуре MCP-сервера нет. Он работает в основном контуре платформы; на cenaly.ru его не поднимали, поэтому раздел «MCP API Ключи» там в настройках больше не показывается (раньше показывался и предлагал адрес, который отвечал «not found»). В остальных контурах сервер работает; если ваш аккаунт живёт не в основном контуре, своих данных в нём вы пока можете не увидеть — разведение хранилищ по контурам в работе.

Быстрый старт#

1. Получите API-ключ#

API-ключ генерируется в админ-панели вашего ресторана.

Шаг за шагом:#

1. Войдите в Админ-панель по адресу admin.cenaly.ru
2. В боковом меню откройте ⚙️ Настройки → 🔑 Доступ
3. На странице найдите раздел 🤖 MCP API Ключи
4. Нажмите кнопку «Сгенерировать новый ключ»
5. Введите имя ключа (например, «Claude Desktop», «Cursor», «Мой GPT») — это поможет отличать ключи друг от друга
6. Скопируйте ключ сразу — он показывается только один раз!

Сам ключ — это 64 шестнадцатеричных символа. Рядом в списке отображается короткий идентификатор вида mk_… — это не ключ, а его «номер» для отзыва.

💡 На этой же странице отображается URL сервера (https://api.cenaly.ru/mcp), который тоже можно скопировать одним кликом.

Управление ключами#

• Вы можете создать до 10 ключей на аккаунт
• Каждый ключ можно отозвать в любой момент — кнопка «Отозвать» рядом с ключом
• После отзыва ключ перестаёт работать немедленно
• Если ключ потерян — отзовите его и создайте новый

2. Подключите AI-ассистент#

Claude Desktop / Claude Code#

Файл конфигурации claude_desktop_config.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.cenaly.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Cursor#

В настройках Cursor → MCP Servers → Add, или файл .cursor/mcp.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.cenaly.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

VS Code (GitHub Copilot)#

В .vscode/mcp.json проекта:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.cenaly.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Другие AI-инструменты#

Подробные пошаговые инструкции для Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Continue, ChatGPT и других — в отдельном руководстве:

👉 Подключение AI-инструментов к MCP

Что может AI-ассистент?#

Для владельцев ресторанов (обычные пользователи)#

Профили пользователей#

Работа с локациями#

Работа с меню#

Языки приложения#

Часы работы#

Заказы#

Домены#

CDN (опубликованные данные)#

Изображения#

Низкоуровневый доступ к S3#

Cognito#

Статистика#

Аутентификация#

Сервер поддерживает три способа авторизации:

1. API-ключ (рекомендуется для AI-ассистентов)#

Authorization: Bearer ваш_64_символьный_ключ

Ключ генерируется в админ-панели. Привязан к вашему аккаунту — AI видит только ваши данные.

2. Cognito JWT-токен#

Для программной интеграции можно получить токен через логин:

# Получить токен
curl -X POST https://api.cenaly.ru/mcp/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "ваш@email.com", "password": "ваш_пароль"}'

# Ответ содержит idToken — используйте его:
Authorization: Bearer eyJraWQ...

Токен действует 1 час, после чего требуется повторный логин.

3. Admin API Key (только для администраторов)#

Authorization: Bearer admin_key

Администраторский ключ даёт полный доступ ко всем данным всех пользователей.

Безопасность#

• Каждый API-ключ привязан к конкретному аккаунту
• Обычные пользователи видят только свои данные
• Ключ можно отозвать в любой момент в админ-панели
• Максимум 10 ключей на аккаунт
• Все запросы идут через HTTPS
• Команды с пометкой [ADMIN] недоступны обычным пользователям

Примеры использования#

Попросить AI обновить цену блюда#

«Обнови цену позиции «Хачапури» в моём меню — сделай 15 лари вместо 12»

AI вызовет my_locations → get_location_menu → update_menu_item.

Добавить новую позицию в меню#

«Добавь в категорию «Десерты» новое блюдо «Чурчхела» за 8 лари»

AI вызовет my_locations → get_location_menu → create_menu_item.

Создать новую категорию#

«Создай категорию «Напитки» с переводами на грузинский и английский»

AI вызовет create_menu_category с nameTranslations.

Переместить блюдо между категориями#

«Перенеси «Лимонад» из «Холодные напитки» в «Безалкогольные»»

AI вызовет move_menu_item с указанием исходной и целевой категории.

Посмотреть заказы за сегодня#

«Покажи мои заказы за сегодня»

AI вызовет my_orders и отфильтрует по дате.

Проверить опубликованное меню#

«Как выглядит моё меню на русском языке для посетителей?»

AI вызовет resolve_domain → get_cdn_menu с языком ru.

Сменить домен ресторана#

«Проверь, доступен ли домен my-restaurant, и если да — установи его»

AI вызовет check_domain_availability → set_location_domain.

Загрузить фото блюда#

«Дай мне ссылку для загрузки фото к блюду X»

AI вызовет get_image_upload_url и вернёт presigned URL для загрузки.

API-эндпоинты#

Управление ключами#

Просмотр ключей#

В админ-панели → Настройки → Доступ → MCP API Ключи. Или через API:

curl https://api.cenaly.ru/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

Создание ключа#

curl -X POST https://api.cenaly.ru/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Claude Desktop"}'

Ответ содержит поле key — это и есть ваш ключ. Сохраните его!

Отзыв ключа#

curl -X DELETE https://api.cenaly.ru/mcp/api/keys/mk_abc123 \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

Управлять ключами можно и по Cognito JWT, и по собственному MCP-ключу (в примерах выше вместо COGNITO_JWT_TOKEN подставляется он же). Не подходит только администраторский ключ: у него нет привязки к конкретному пользователю, и сервер ответит 403 user identity required. Проще всего — админ-панель.

Устранение неполадок#