max-channel-mcp

MCP-сервер для публикации в каналы мессенджера MAX.

Подключается к Claude Desktop, Claude Code и другим клиентам, поддерживающим Model Context Protocol. После настройки ассистент может публиковать в вашем канале текст, фотографии, видео, аудио, документы и геометки — просто по вашей просьбе.

Вы:  Опубликуй в канале анонс с картинкой из ~/Downloads/banner.png
     и кнопкой на сайт.

ИИ:  [вызывает max_send_photos]
     Опубликовано. Ссылка: https://max.ru/ваш_канал/AaApSIDNYGM

Возможности

• Публикация текста с разметкой Markdown или HTML

• Альбомы до 10 фотографий, видео, смешанные альбомы

• Аудио, документы, геометки

• Кнопки под сообщениями — ссылки и callback

• Изменение и закрепление опубликованных сообщений

• Чтение истории канала

Удаление сообщений намеренно не реализовано: ассистент не должен иметь возможности стереть содержимое канала.

Related MCP server: Telegram Channel MCP Server

Требования

• Node.js 18.18 или новее

• Бот, созданный через MasterBot

• Права администратора у бота в вашем канале

Установка

Claude Code

claude mcp add max-channel \
  --scope local \
  --env MAX_BOT_TOKEN=ваш_токен \
  --env MAX_CHAT_ID=-10000000000001 \
  -- npx -y max-channel-mcp

Область local держит токен в вашем личном конфиге, а не в файле проекта.

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "max-channel": {
      "command": "npx",
      "args": ["-y", "max-channel-mcp"],
      "env": {
        "MAX_BOT_TOKEN": "ваш_токен",
        "MAX_CHAT_ID": "-10000000000001"
      }
    }
  }
}

Путь к файлу настроек:

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

Из исходников

git clone https://github.com/eduard256/max-channel-mcp.git
cd max-channel-mcp
npm install
npm run build

Затем укажите в конфиге node /полный/путь/dist/index.js вместо npx.

Настройка

Как получить токен

Откройте MasterBot, создайте бота по инструкции — в ответ придёт токен.

Как узнать идентификатор канала

1. Добавьте бота в канал администратором.

2. Выполните запрос:

curl -H "Authorization: ВАШ_ТОКЕН" https://platform-api2.max.ru/chats

3. Возьмите поле chat_id нужного канала. Обычно это отрицательное число.

Переменные окружения

Инструменты

Файлы передаются путями на диске. Кнопки — необязательный параметр кнопки у всех публикующих инструментов.

Ограничения MAX

Проверено на практике. В официальной документации эти правила описаны неполно.

Смешивание аудио, документов и геометок с другими вложениями сервер отклоняет с ошибкой вида Must be only one audio attachment in message.

Сертификаты

Серверы MAX используют сертификат удостоверяющего центра «Russian Trusted Root CA» (Минцифры РФ). Этого корня нет в стандартном хранилище Node.js, поэтому без дополнительной настройки соединение обрывается с ошибкой unable to get local issuer certificate.

Чтобы сервер работал на любой машине без ручной настройки, корневой сертификат включён в состав пакета — файл certs/russian_trusted_root.pem.

Как это устроено:

• сертификат применяется только к доменам max.ru, oneme.ru, okcdn.ru и mycdn.me — остальной трафик проверяется обычным образом;

• он добавляется к системным корням, а не заменяет их;

• при запуске сверяется контрольная сумма SHA-256; если файл подменён, сервер не стартует;

• ничего не устанавливается в систему — настройка действует только внутри процесса сервера.

Отпечаток встроенного сертификата:

d26d2d0231b7c39f92cc738512ba54103519e4405d68b5bd703e9788ca8ecf31

Сверить можно с опубликованным на gosuslugi.ru.

Если корень уже установлен в вашей системе, встроенный можно отключить: MAX_DISABLE_CUSTOM_CA=1. Свой сертификат подключается через MAX_CA_CERT_PATH.

Диагностика

Сервер пишет диагностику в стандартный поток ошибок. При запуске выводится состояние TLS и результат проверки подключения.

Известная проблема библиотеки

Сервер использует официальную библиотеку @maxhub/max-bot-api. В версии 0.2.5 загрузка изображений и документов по пути к файлу или через поток не работает на Node.js 21 и новее: в FormData подставляется объект, который современный undici не распознаёт как файл, и сервер отвечает NO_IMAGE.

Этот сервер обходит проблему, читая файлы в память и передавая их как Buffer. Видео и аудио загружаются другим способом и не затронуты.

Лицензия

MIT