max-channel-mcp

MAXメッセンジャーのチャンネルに投稿するためのMCPサーバー。

Claude Desktop、Claude Code、その他Model Context Protocolをサポートするクライアントに接続します。設定後、アシスタントはあなたの依頼に応じて、チャンネルにテキスト、写真、動画、音声、ドキュメント、位置情報を投稿できます。

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

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

機能

• MarkdownまたはHTMLのマークアップ付きテキストの投稿

• 最大10枚の写真、動画、混合アルバム

• 音声、ドキュメント、位置情報

• メッセージ下のボタン — リンクとコールバック

• 投稿済みメッセージの編集とピン留め

• チャンネル履歴の読み取り

メッセージの削除は意図的に実装されていません。アシスタントがチャンネルの内容を消去できないようにするためです。

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

次に、設定でnpxの代わりにnode /полный/путь/dist/index.jsを指定します。

設定

トークンの取得方法

MasterBotを開き、指示に従ってボットを作成すると、トークンが返ってきます。

チャンネルIDの確認方法

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