Xonta MAX — MCP для ботов и мини-приложений MAX
MCP для разработки ботов и мини-приложений MAX: справка по Bot API, проверка кода, перенос с Telegram, шаблоны и тестовые данные.
- 20
- MIT
- Python
Когда полезен
Xonta MAX закрывает следующие сценарии, когда подключён к AI-агенту через Model Context Protocol:
- Проверить код MAX-бота и составить план переноса с Telegram.
- Подготовить проект бота на Python, TypeScript или Go и структуру сообщений.
- Протестировать webhook и backend мини-приложения на синтетических данных.
- Подготовить ссылки для размещений и рассчитать рекламные показатели по собственным данным.
О категории «Мессенджеры и почта»: MCP-серверы для мессенджеров и почты позволяют AI-агенту читать переписку, искать по истории и (с подтверждением) отправлять сообщения от вашего имени. Подробнее о категории →
Что умеет Xonta MAX
Xonta MAX помогает ИИ-агенту разрабатывать ботов и мини-приложения для мессенджера MAX. В инструментах автора объединены справка по Bot API, разбор методов и ограничений, проверка кода и план переноса с Telegram. Справочные ответы опираются на источники, перечисленные автором; при разработке их следует сверять с документацией MAX. Сервер подготавливает шаблоны ботов на Python, TypeScript и Go, JSON сообщений, кнопки, ссылки запуска бота и мини-приложения. Для локальных тестов предусмотрены примеры webhook-событий, подписанные тестовые initData и эмулятор window.WebApp. Такие данные предназначены для разработки и не подтверждают работу готового бота в MAX. Удалённый MCP доступен без авторизации по Streamable HTTP. На удалённом адресе отключены инструменты управления ботом с MAX_BOT_TOKEN; они доступны при локальном запуске через stdio. Реальный токен своего бота не передавайте удалённому серверу. Большинство справочных инструментов можно использовать без своего бота. Отдельные инструменты готовят ссылки для рекламных размещений, рассчитывают показатели по введённым данным и проверяют текст рекламного поста. Они не обращаются к рекламным кабинетам и бюджетам. Проверка поста — подсказка, а не юридическое заключение или подтверждение регистрации рекламы.
Ограничения
Справочные сведения и правила проверок поддерживает автор Xonta MAX. Сверяйте спорные сведения с документацией MAX. На удалённом адресе отключены инструменты управления ботом; для управления своим ботом нужен локальный запуск. Реальный токен не передавайте удалённому серверу. Тестовые события и initData не являются данными реальных пользователей.
Как установить
Для удалённого подключения требуется поддержка Streamable HTTP; для локального — запуск MCP через stdio. Совместимость проверяйте для своей версии клиента.
Удалённо: укажите URL https://mcp.xonta.ru/max/mcp в настройках MCP-клиента с поддержкой Streamable HTTP. Авторизация не требуется; инструменты управления ботом на этом адресе отключены. Реальный токен не передавайте удалённому серверу. Локально: установите Python 3.10+ и uv, затем настройте command: uvx, args: ["xonta-max-mcp"] для stdio. Для инструментов управления своим ботом передайте MAX_BOT_TOKEN и путь к PEM-файлу в MAX_CA_FILE согласно инструкции автора. Без токена доступны справочные инструменты. Команда относится к Python-пакету из PyPI.
Переменные окружения
MAX_BOT_TOKENопциональнаяТолько для локальных инструментов управления собственным ботом. Для удалённого адреса токен не нужен; управление ботом доступно локально. Реальный токен не передавайте удалённому серверу.MAX_CA_FILEопциональнаяПри локальном запуске укажите путь к PEM-файлу сертификата согласно инструкции автора.XONTA_MAX_LANGопциональнаяЯзык ответов по умолчанию: ru или en. В отдельных инструментах можно передать lang.
Примеры использования
Несколько типовых сценариев, когда Xonta MAX полезен прямо в чате с агентом:
- «Проверь этот код бота для MAX и объясни предлагаемые исправления.»Проверка кода через max_lint_code с последующей сверкой разработчиком.
- «Подготовь шаблон MAX-бота на TypeScript с webhook.»Генерация каркаса проекта через max_scaffold_bot.
- «Подготовь тестовые initData для локальной проверки моего backend.»Синтетические подписанные данные через max_mock_init_data.
Типичные проблемы и решения
Даже у простых MCP-серверов бывают мелкие проблемы при первой установке. Ниже — типовые сценарии и быстрые фиксы:
- На удалённом сервере нет инструментов отправки сообщений.
- По инструкции автора инструменты с токеном отключены на hosted endpoint. Для управления собственным ботом нужен локальный stdio-запуск.
- Клиент не подключается по URL.
- Проверьте поддержку Streamable HTTP в своей версии клиента и точный адрес https://mcp.xonta.ru/max/mcp. Пример конфигурации сам по себе не подтверждает совместимость каждого клиента.
- Локальному боту не хватает параметров подключения.
- Сверьте MAX_BOT_TOKEN и путь MAX_CA_FILE с инструкцией автора. Не помещайте токен в текст запроса агенту.
Часто задаваемые вопросы
- Для каких задач подходит Xonta MAX?
- Для разработки ботов и мини-приложений MAX: сервер предоставляет справку по Bot API, проверку кода, план переноса с Telegram и тестовые данные. Это инструмент для ИИ-агента разработчика; создание и допуск самого бота регулирует платформа MAX.
- Как подключиться к удалённому Xonta MAX и нужен ли токен?
- В MCP-клиенте с поддержкой Streamable HTTP укажите URL https://mcp.xonta.ru/max/mcp. Авторизация для этого endpoint не требуется. На удалённом адресе отключены инструменты управления ботом с MAX_BOT_TOKEN. Реальный токен своего бота не передавайте удалённому серверу.
- Как запустить Xonta MAX локально через stdio?
- Пакет опубликован в PyPI и требует Python 3.10 или новее. В конфигурации MCP используйте command: uvx и args: ["xonta-max-mcp"]. Для управления своим ботом автор предусматривает MAX_BOT_TOKEN и путь к сертификату в MAX_CA_FILE. Без токена локальный сервер работает со справочными инструментами.
- На каких языках сервер создаёт шаблоны и отвечает?
- Сам MCP-пакет написан на Python, а max_scaffold_bot подготавливает проекты ботов на Python, TypeScript или Go. Ответы инструментов доступны на русском и английском через параметр lang: ru или en; XONTA_MAX_LANG задаёт язык по умолчанию.
- Поможет ли он перенести Telegram-бота и проверить код MAX?
- max_migrate_from_telegram составляет план переноса и отмечает функции без прямого аналога. max_lint_code ищет проблемы в коде, включая остатки Telegram API, настройки TLS и webhook. Это подсказки автора сервера: результат нужно сверить с документацией MAX и проверить в своём проекте.
- Как тестировать мини-приложение и webhook без реальных пользователей?
- max_mock_update создаёт тестовые события webhook, max_mock_init_data — подписанные тестовые initData (если test_bot_token не передан, генерируется случайный тестовый токен), max_bridge_mock — эмулятор window.WebApp для браузера. Они помогают проверить локальные обработчики и интерфейс; не заменяют интеграционную проверку в MAX.
- Что делают инструменты сообщений и ссылок?
- max_build_message подготавливает JSON сообщения, max_validate_message проверяет его структуру, а max_convert_formatting и max_split_text помогают с разметкой и длинным текстом. max_deeplink создаёт ссылки запуска бота, мини-приложения или отправки материала в MAX. Подготовка сообщения не означает его отправку.
- Управляет ли Xonta MAX рекламой и подтверждает ли маркировку?
- max_tracking_links готовит ссылки для размещений, max_ad_report рассчитывает показатели по данным, которые передал пользователь. По документации автора сервер не обращается к рекламным кабинетам и бюджетам. max_check_ad_post даёт подсказки по тексту; это не юридическое заключение и не подтверждение регистрации рекламы в ОРД.