MAX MCP

woyaxnini/mcp-max-messenger· Проверено 12.11.2026· 12на GitHub

Подключает агента к мессенджеру MAX: читать и отправлять сообщения, файлы и кнопки, управлять участниками групп. Первый вариант работает через бота, второй — через вашу пользовательскую сессию.

2 реализации:

21 инструмент поверх Bot API MAX по токену бота, ставится через npx; умеет кнопки, медиа, закреп, права администраторов и режим HTTP.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Бот, созданный на max.ru

MAX_TOKEN

токен бота: создайте бота на max.ru

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MAX_TOKEN=<токен бота MAX>' --transport stdio max \
  -- npx -y @woyax/mcp-max-messenger

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.max]
command = "npx"
args = ["-y", "@woyax/mcp-max-messenger"]

[mcp_servers.max.env]
MAX_TOKEN = "<токен бота MAX>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "<токен бота MAX>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "max": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "<токен бота MAX>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "<токен бота MAX>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "<токен бота MAX>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "max": {
        "type": "local",
        "command": ["npx", "-y", "@woyax/mcp-max-messenger"],
        "environment": {
          "MAX_TOKEN": "<токен бота MAX>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "<токен бота MAX>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "<токен бота MAX>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_messagesчитает сообщения чата

send_messageотправляет текст, кнопки и вложения

edit_messageредактирует сообщение

delete_messageудаляет сообщение

pin_messageзакрепляет сообщение

send_mediaотправляет фото, видео или файл по ссылке

send_actionпоказывает статус «печатает»

get_bot_infoпоказывает данные бота

get_chatsперечисляет групповые чаты бота

get_chatпоказывает участников и закреп

edit_chatменяет название и описание чата

get_chat_membersперечисляет участников с ролями

get_adminsперечисляет администраторов

set_adminвыдаёт права администратора

add_membersдобавляет людей в группу

remove_memberудаляет из группы

get_updatesполучает входящие события

answer_callbackотвечает на нажатие кнопки

Показано 18 из 21.

8 инструментов на Python через вашу пользовательскую сессию: видит все диалоги, группы и каналы, ищет по истории и выгружает каналы; вход по QR-коду или SMS.

Как подключить

Что сделать до подключения

macOS или Linux, Python 3.11–3.13 и uv

git clone https://github.com/renosaza/max-mcp.git и uv sync --frozen в папке репозитория

Вход: uv run max-mcp-login login-qr и сканирование QR-кода в приложении MAX, или uv run max-mcp-login login-sms --phone <номер>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio max-mcp \
  -- uv run --directory /path/to/max-mcp max-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.max-mcp]
command = "uv"
args = ["run", "--directory", "/path/to/max-mcp", "max-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "max-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/max-mcp", "max-mcp"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "max-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/max-mcp", "max-mcp"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "max-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/max-mcp", "max-mcp"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "max-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/max-mcp", "max-mcp"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "max-mcp": {
        "type": "local",
        "command": ["uv", "run", "--directory", "/path/to/max-mcp", "max-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "max-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/max-mcp", "max-mcp"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "max-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/max-mcp", "max-mcp"]
    }
  }
}

Инструменты сервера

list_chatsперечисляет диалоги, группы и каналы

get_chatпоказывает данные чата или канала

read_messagesчитает историю сообщений

search_messagesищет текст в истории чата

list_channel_postsпоказывает посты канала и реакции

dump_channelвыгружает до 1000 постов канала

send_messageотправляет сообщение или ответ

send_fileотправляет файл, фото или видео

Что попросить агента

«Отправь в чат <ID чата>: «Совещание начнётся через 10 минут»»Агент вызовет send_message

«Отправь в чат команды запрос на согласование с кнопками «Одобрить» и «Отклонить»»Агент вызовет send_message с кнопками callback, ответы поймает через get_updates и answer_callback

«Кто состоит в группе <название>? Сделай <имя> администратором»Агент вызовет get_chat_members и set_admin

«Найди в чате <ID чата> сообщения со словом «договор», просмотрев не больше 1000 сообщений»В max-mcp агент вызовет search_messages

«Выгрузи публикации канала <ID канала> частями и сохрани в JSON»В max-mcp агент вызовет dump_channel несколько раз, продолжая с next_before_time

Для каких задач

Отправить сообщение в рабочий чат или запрос на согласование с кнопками «Одобрить» и «Отклонить»

Показать последние сообщения чата или канала

Найти в переписке сообщения со словом «договор»

Выгрузить посты канала с реакциями в JSON

Посмотреть участников группы и выдать кому-то права администратора

Проверить новые сообщения и нажатия кнопок у бота

Ограничения

Бот видит только групповые чаты, куда его добавили; личные диалоги приходят через get_updates. Bot API MAX пропускает 30 запросов в секунду

max-mcp работает через сторонний клиент maxapi-python и вашу пользовательскую сессию: протокол MAX может измениться без предупреждения, автоматизация может повлечь ограничения аккаунта. Для экспериментов берите отдельный аккаунт и не делайте массовых рассылок

В max-mcp вход и отправка с реального аккаунта MAX не тестировались; поиск идёт последовательным чтением истории, файлы отправляются только из ~/Downloads, ~/Documents и /tmp, если не задан MAX_MCP_SEND_ROOTS

mcp-max-messenger распространяется по лицензии MIT + Commons Clause: продавать его как размещённый сервис можно только с разрешения автора

Если не работает

remove_admin отвечает success: true, а права остаются

Ошибка на стороне MAX. Проверьте результат через get_admins.

add_members падает с add.participant.privacy

У пользователя включён режим приватности, и MAX не даёт добавить его в группу.

max-mcp: ошибка загрузки fingerprint или VersionNotFoundError

Не открывается каталог hashes.pymax.org. Запустите сервер с MAX_MCP_APP_VERSION=26.28.0 из встроенного каталога, сессию удалять не нужно.

max-mcp: MAX client did not become ready

Клиент не ответил за 30 секунд. Проверьте соединение и актуальность сессии, затем запустите uv run max-mcp вручную, чтобы увидеть ошибку.

max-mcp не отправляет файл

Укажите абсолютный путь и добавьте папку в MAX_MCP_SEND_ROOTS. Папки с ключами, конфигурацией и сессией MAX остаются закрытыми.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-max-messenger	Oleg Alekseev	12	локально	токен	21	31 марта 2026
max-mcp	renosaza	6	локально	не нужен	8	14 октября 2026

Частые вопросы

Какой вариант выбрать?

Для рабочих чатов и уведомлений подходит бот: mcp-max-messenger ставится через npx и пишет от имени бота. max-mcp читает всё, что видите вы сами, включая каналы, но работает от вашего аккаунта и с риском ограничений.

Где взять токен бота?

Создайте бота на max.ru и передайте его токен в MAX_TOKEN. Bot API MAX принимает токен в заголовке Authorization без префикса Bearer.

Можно запустить mcp-max-messenger на сервере для n8n?

Да: MAX_TOKEN=<токен> MCP_TRANSPORT=http MCP_PORT=3000 npx @woyax/mcp-max-messenger, затем подключите клиент к http://<ваш сервер>:3000/mcp.

Где max-mcp хранит сессию?

В папке ~/.max-mcp/ с правами 0700, файлы сессии — 0600. Для повторного входа удалите session.db, session.kind и session.phone и снова выполните uv run max-mcp-login login-qr.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере; первый обращается к platform-api.max.ru по токену бота, второй — к MAX под вашей учётной записью. Зарубежные аккаунты не нужны.

MAX MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы