max-channel-mcp

MCP server for publishing to channels of the messenger MAX.

Connects to Claude Desktop, Claude Code, and other clients that support the Model Context Protocol. After setup, the assistant can publish text, photos, videos, audio, documents, and geo tags to your channel — simply at your request.

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

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

Features

• Publishing text with Markdown or HTML markup

• Albums of up to 10 photos, videos, mixed albums

• Audio, documents, geo tags

• Buttons under messages — links and callback

• Editing and pinning published messages

• Reading channel history

Deleting messages is intentionally not implemented: the assistant must not be able to erase channel content.

Related MCP server: Telegram Channel MCP Server

Requirements

• Node.js 18.18 or newer

• A bot created via MasterBot

• Administrator rights for the bot in your channel

Installation

Claude Code

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

The local scope keeps the token in your personal config, not in the project file.

Claude Desktop

Add to claude_desktop_config.json:

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

Path to the settings file:

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

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

From source

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

Then specify node /full/path/dist/index.js in the config instead of npx.

Configuration

How to get a token

Open MasterBot, create a bot according to the instructions — you will receive a token in response.

How to find the channel ID

1. Add the bot to the channel as an administrator.

2. Run the request:

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

3. Take the chat_id field of the desired channel. This is usually a negative number.

Environment variables

Tools

Files are passed as paths on disk. Buttons are an optional кнопки parameter for all publishing tools.

MAX limitations

Verified in practice. The official documentation describes these rules only partially.

Mixing audio, documents, or geo tags with other attachments is rejected by the server with an error like Must be only one audio attachment in message.

Certificates

MAX servers use a certificate from the certificate authority «Russian Trusted Root CA» (Ministry of Digital Development of the Russian Federation). This root is not present in the standard Node.js store, so without additional configuration the connection is interrupted with the error unable to get local issuer certificate.

To make the server work on any machine without manual configuration, the root certificate is included in the package — the file certs/russian_trusted_root.pem.

How it works:

• the certificate is applied only to the domains max.ru, oneme.ru, okcdn.ru, and mycdn.me — all other traffic is checked normally;

• it is added to the system roots, not replacing them;

• on startup the SHA-256 checksum is verified; if the file has been replaced, the server does not start;

• nothing is installed into the system — the setting only applies inside the server process.

Fingerprint of the built-in certificate:

d26d2d0231b7c39f92cc738512ba54103519e4405d68b5bd703e9788ca8ecf31

It can be checked against the one published on gosuslugi.ru.

If the root is already installed in your system, you can disable the built-in one: MAX_DISABLE_CUSTOM_CA=1. Your own certificate is connected via MAX_CA_CERT_PATH.

Diagnostics

The server writes diagnostics to the standard error stream. On startup it prints the TLS state and the result of the connection check.

Known library issue

The server uses the official library @maxhub/max-bot-api. In version 0.2.5, uploading images and documents by file path or via a stream does not work on Node.js 21 and newer: an object is put into FormData that modern undici does not recognize as a file, and the server responds with NO_IMAGE.

This server works around the issue by reading files into memory and passing them as a Buffer. Videos and audio are uploaded through a different path and are not affected.

License

MIT