max-messenger — MCP-сервер для Claude Code
Интегрирует мессенджер MAX от VK с ИИ-ассистентами через протокол MCP. Позволяет боту читать диалоги, отправлять медиафайлы и модерировать участников.
claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messengerЧто делает max-messenger
Сервер предоставляет 21 инструмент для прямого взаимодействия с MAX Bot API. Через него ассистент может публиковать разметку HTML или Markdown, крепить кнопки пяти видов, удалять или закреплять сообщения и опрашивать чаты через long polling.
Архитектура поддерживает два режима: локальный stdio и удалённый транспорт http на порту 3000. Для работы обязательны среда Node.js 18+ и рабочий токен бота в переменной MAX_TOKEN.
У платформы действует лимит в 30 запросов за секунду. Токен передаётся напрямую в заголовке без префикса Bearer. Если у пользователя включены настройки приватности, метод добавления в чат завершится ошибкой.
Какие задачи решает
- отправлять сообщения с кнопками и разметкой Markdown в чаты MAX
- выгружать медиафайлы по ссылке прямо в диалог
- назначать администраторов и исключать участников из групп
- читать входящие события и нажатия на кнопки через long polling
Примеры запросов агенту
- Отправь в групповой чат сообщение с кнопками подтверждения и отмены
- Покажи последние сообщения из диалога и закрепи важное объявление
- Проверь список участников чата и выдай права администратора новому сотруднику
Как установить max-messenger
Командой платформы
claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messengerВместо <…> подставьте свои значения
Командой платформы
codex mcp add max-messenger --env MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messengerВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"max-messenger": {
"command": "npx",
"args": [
"-y",
"@woyax/mcp-max-messenger"
],
"env": {
"MAX_TOKEN": "<MAX_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"max-messenger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@woyax/mcp-max-messenger"
],
"env": {
"MAX_TOKEN": "<MAX_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MAX_TOKEN=<MAX_TOKEN> max-messenger npx -y @woyax/mcp-max-messengerВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о max-messenger
Как установить max-messenger в Claude Code?
Выполните команду claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messenger. Вместо <MAX_TOKEN> подставьте токен вашего бота.
Что делает MCP-сервер max-messenger?
Он связывает модель с платформой MAX Bot API через 21 готовый инструмент. Ассистент получает возможность пересылать файлы, модерировать чаты и слушать события.
Что нужно подготовить перед запуском?
Требуется установленный Node.js версии 18 или выше. Также необходимо создать бота на max.ru и скопировать выданный ключ доступа.
