MCP-сервер мессенджера MAX
mcp-server-max
MCP-сервер для мессенджера MAX (бывший VK Teams): отправка и чтение сообщений, управление чатами, закреп и статус набора текста
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Отправляет, редактирует и удаляет сообщения от имени бота
- Читает историю чатов и список участников
Установка
Ручная установка
pip install mcp-server-maxУстановка из README, альтернативно uvx mcp-server-max без установки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает Max Bot API в 14 инструментов: отправка сообщения с поддержкой Markdown, HTML и ответа на другое сообщение, чтение истории чата с диапазоном времени и пагинацией, список групповых чатов бота, информация о чате и список участников, редактирование и удаление сообщения, закрепление и открепление сообщения и получение текущего закрепа, выход бота из чата, информация о самом боте, индикатор набора текста и получение событий через long polling. Ставится как обычный Python-пакет через pip или uvx и запускается по имени команды.
Для кого. Для тех, кто хочет управлять ботом MAX или читать и отправлять сообщения в чатах прямо из агента.
Подходит, если
- Нужно отправлять уведомления или ответы ботом MAX из диалога с агентом
- Нужно читать историю чата за период для анализа или обработки
- Нужно закреплять важные сообщения или управлять составом чата
Не подходит, если
- Нужен надежный постоянно живой канал с буферизацией на случай обрыва, для этого больше подходит демон вроде max-gateway
- Нужны личные, а не групповые чаты MAX, README описывает в основном групповые
Пример запроса к агенту
Отправь в чат 123456 сообщение с markdown о переносе встречи и закрепи егоОграничения
Нужен собственный бот MAX и его токен, полученный через @MasterBot. README не описывает лимиты частоты запросов Max Bot API и поведение при долгом простое без long polling.
Как отключить. Удалите сервер max из конфигурации MCP-клиента и отзовите токен бота через @MasterBot.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MAX_BOT_TOKEN обязательная, секрет | Токен бота MAX, полученный через @MasterBot. |
| MCP_LOG_LEVEL | Уровень логирования: DEBUG, INFO, WARNING, ERROR, по умолчанию INFO. |
Проверка безопасности
- Отправляет, редактирует и удаляет сообщения от имени бота
- Читает историю чатов и список участников
Коротко о README
README на английском с версией на русском в отдельном файле описывает сервер как MCP для мессенджера MAX, бывшего VK Teams / ICQ. Таблица из 14 инструментов покрывает сообщения, чаты, закреп и статус бота. Показана установка через pip или uvx, получение токена через @MasterBot, переменные окружения MAX_BOT_TOKEN и MCP_LOG_LEVEL, и конфигурации для Claude Desktop, Claude Code и OpenClaw.
Частые вопросы
Как получить токен бота?
Открыть MAX, найти @MasterBot или раздел чат-ботов, создать нового бота и скопировать токен.
Поддерживается ли Claude Code?
README приводит примеры для Claude Desktop, Claude Code и OpenClaw с одинаковой структурой конфигурации.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI