Что агент делает в мессенджере MAX
Большинство серверов и плагинов работает через официальный Bot API. Пара проектов входит в MAX под пользовательской сессией, о них ниже отдельно.
- Пишет и читает от имени бота. MCP-сервер для мессенджера MAX, пакет mcp-max-messenger, дает 21 инструмент: сообщения с правкой и закрепом, фото, видео и файлы, участники чатов, ответы на нажатия кнопок. Запускается рядом с агентом или как HTTP-сервер. MCP-сервер мессенджера MAX на Python короче, 14 инструментов, и ставится через pip или uvx.
- Ищет по переписке и ничего не отправляет. MCP-сервер бота Max фильтрует сообщения по датам, ищет по тексту без учета регистра и скачивает вложения в отдельный каталог.
- Пускает Claude Code в мессенджер. Канал MAX для Claude Code передает сообщения боту в сессию, а Claude отвечает с вложениями до 50 МБ. Канал на демоне держит соединение под systemd, буферизует входящие при обрыве и дает команды
/status,/logsи/restart. - Подключает Hermes и OpenClaw. MAX-шлюз для Hermes Agent рисует markdown-таблицы картинками и переключает сессии агента командой
/resume. Для OpenClaw есть плагин MAX и openclaw-max-plus со стримингом ответа, мультиаккаунтом и меню команд бота. - Ищет каналы и считает охваты. MaxStat MCP от самого сервиса MaxStat дает 21 инструмент: поиск каналов и постов, динамика подписчиков, просмотры, реакции, пересылки и вебхук на новые посты.
- Собирает воронку бота из описания. MCP Retensy строит граф сценария для Telegram, MAX и Instagram и проверяет его валидатором до публикации. Условие
SUBSCRIBEDи reply-клавиатуры для MAX недоступны.
Как получить токен бота MAX
Бота создают на платформе MAX для партнеров после верификации профиля. Подключение открыто юрлицам, ИП и самозанятым, резидентам РФ, а число ботов зависит от типа профиля. Пользователи увидят бота после модерации. Авторы плагинов для OpenClaw пишут, что она длится до 48 часов в рабочие дни.
Токен лежит на платформе в разделе «Чат-боты», в меню бота, пункт «Настройки». Если бот создан в мини-приложении «MAX для бизнеса», токен выдаст оно же или одноименный бот по команде «Получить токен».
Запросы идут на platform-api2.max.ru с токеном в заголовке Authorization. Передачу токена параметром адреса API больше не принимает. Храните токен как пароль. Еще понадобится сертификат Минцифры в списке доверенных: плагин openclaw-max добавляет его только для своих соединений, системное доверие не трогает.
npx skillfoxx add mcp/mcp-max-messenger
Какой инструмент выбрать под задачу
Если нужен бот, который отвечает клиентам в Макс, берите сервер на Bot API. У mcp-max-messenger расширенный доступ: он удаляет сообщения и меняет участников чатов. Сервер на Python, шлюзы и каналы для агентов получают широкий доступ, потому что пишут от имени бота или пускают сообщения из мессенджера в сессию на вашей машине.
Канал Claude Code вдобавок запускается с флагом --dangerously-load-development-channels, потому что каналы пока в предварительной версии. Поэтому начните с кода сопряжения и белого списка через /max:access.
Для разбора чатов без риска что-то отправить подходит сервер только на чтение. Его доступ все равно расширенный. Токен открывает переписку бота до отзыва.
Проекты на пользовательской сессии стоят особняком. MAX MCP входит как ваше устройство через неофициальный клиент maxapi-python, и автор советует отдельный аккаунт. Гайд по AI-секретарю использует User API через вторую сим-карту и прикладывает разбор 152-ФЗ, 38-ФЗ и статьи 159 УК. Серверы на Bot API и плагины каналов работают без VPN.
Ограничения Bot API MAX
Платформа держит предел 30 запросов в секунду. Long polling, когда бот сам опрашивает сервер, документация оставляет для разработки и тестов. В рабочей среде нужен вебхук по HTTPS с сертификатом доверенного центра, самоподписанные больше не принимаются.
С июня 2026 года метод GET /chats не работает. Список групповых чатов и каналов отдает POST /subscriptions. Добавлять участников в групповой чат API пока не умеет. Опросов и реакций у ботов нет, слеш-команд не больше 32.
Для проверок заведите второго бота и тестовую группу, а боевой токен выдавайте агенту после прогона.