MCP-сервер для мессенджера MAX

mcp-max-messenger

MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента

MCP-серверСредний рискРоссийский стек

woyaxnini/mcp-max-messenger

Установка

{
  "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.

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллВысокий риск75 тыс.

MCP-сервер для True API Честного знака: документы, коды маркировки, остатки и проверка участников по ИНН

MCP-серверСредний рискРоссийский стек3

Яндекс Умный дом для OpenClaw

Yandex Smart Home CLI for OpenClaw

Python CLI и скилл для OpenClaw, которые включают лампы и розетки Яндекс Умного дома, меняют яркость, температуру и цвет

СкиллСредний рискРоссийский стек