MCP-сервер для мессенджера MAX
mcp-max-messenger
MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента
Установка
{
"mcpServers": {
"max-messenger": {
"command": "npx",
"args": ["-y", "@woyax/mcp-max-messenger"],
"env": {
"MAX_TOKEN": "YOUR_BOT_TOKEN"
}
}
}
}Тот же конфиг подходит для Cursor.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Подключает агента к боту в мессенджере MAX через Bot API. Дает 21 инструмент: отправка, чтение, редактирование и закрепление сообщений, отправка фото, видео и файлов, управление чатами и участниками, получение событий и ответы на нажатия кнопок. Работает локально через stdio или как HTTP-сервер.
Для кого. Разработчикам и командам, которые автоматизируют уведомления, согласования и работу с чатами в MAX.
Подходит, если
- Отправлять уведомления в рабочие чаты MAX из агента или n8n
- Собрать согласование с кнопками «Одобрить» и «Отклонить»
- Прочитать последние сообщения чата или новые события бота
- Управлять участниками и администраторами группового чата
Не подходит, если
- Нужен доступ к личному аккаунту пользователя, а не к боту
- Нужны вебхуки в реальном времени: пока события получаются через long polling
Пример запроса к агенту
Отправь в чат команды запрос на согласование счета с кнопками «Одобрить» и «Отклонить»Ограничения
Работает от имени бота, get_chats возвращает только групповые чаты. У MAX API есть известные ошибки: remove_admin может вернуть успех без снятия прав, кнопка open_app не работает, add_members падает при режиме приватности пользователя. Лимит 30 запросов в секунду. Лицензия MIT + Commons Clause.
Как отключить. Удалите блок max-messenger из mcpServers в конфиге клиента. При необходимости отзовите токен бота в MAX.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MAX_TOKEN обязательная, секрет | Токен бота MAX |
| MCP_TRANSPORT | Транспорт: stdio (по умолчанию) или http |
| MCP_PORT | Порт для HTTP-режима, по умолчанию 3000 |
Проверка безопасности
- Нужен токен бота MAX
- Инструменты отправляют и удаляют сообщения, меняют участников и администраторов чатов
Коротко о README
Сервер покрывает MAX Bot API 21 инструментом в группах сообщений, медиа, чатов, участников и событий, поддерживает пять типов кнопок. Есть режим stdio для Claude Desktop и Cursor и HTTP-режим для удаленного запуска. В README описаны переменные окружения, архитектура, особенности MAX API и известные ошибки платформы. В планах хостинг по URL и поддержка вебхуков.
Частые вопросы
Как получить доступ к личным диалогам с ботом?
Через get_updates: он возвращает chat_id, который затем используется с остальными инструментами.
Нужен ли префикс Bearer для токена?
Нет, MAX API принимает токен в заголовке Authorization без префикса Bearer.
Похожие
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
MCP-сервер Честный знак
@woyax/mcp-chestnyi-znak
MCP-сервер для True API Честного знака: документы, коды маркировки, остатки и проверка участников по ИНН
Яндекс Умный дом для OpenClaw
Yandex Smart Home CLI for OpenClaw
Python CLI и скилл для OpenClaw, которые включают лампы и розетки Яндекс Умного дома, меняют яркость, температуру и цвет