max-channel-mcp

MCP-Server für die Veröffentlichung in Kanälen des Messengers MAX.

Verbindet sich mit Claude Desktop, Claude Code und anderen Clients, die das Model Context Protocol unterstützen. Nach der Einrichtung kann der Assistent in Ihrem Kanal Text, Fotos, Videos, Audio, Dokumente und Standortmarkierungen veröffentlichen – einfach auf Ihre Anfrage hin.

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

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

Funktionen

• Veröffentlichung von Text mit Markdown- oder HTML-Auszeichnung

• Alben mit bis zu 10 Fotos, Videos, gemischte Alben

• Audio, Dokumente, Standortmarkierungen

• Schaltflächen unter Nachrichten – Links und Callback

• Ändern und Anpinnen veröffentlichter Nachrichten

• Lesen des Kanalverlaufs

Das Löschen von Nachrichten ist bewusst nicht implementiert: Der Assistent soll nicht die Möglichkeit haben, den Inhalt des Kanals zu löschen.

Related MCP server: Telegram Channel MCP Server

Anforderungen

• Node.js 18.18 oder neuer

• Ein Bot, der über MasterBot erstellt wurde

• Administratorrechte für den Bot in Ihrem Kanal

Installation

Claude Code

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

Der Bereich local hält das Token in Ihrer persönlichen Konfiguration, nicht in der Projektdatei.

Claude Desktop

Fügen Sie in claude_desktop_config.json hinzu:

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

Pfad zur Konfigurationsdatei:

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

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

Aus dem Quellcode

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

Geben Sie dann in der Konfiguration node /полный/путь/dist/index.js anstelle von npx an.

Konfiguration

So erhalten Sie ein Token

Öffnen Sie MasterBot, erstellen Sie einen Bot gemäß der Anleitung – als Antwort erhalten Sie ein Token.

So ermitteln Sie die Kanal-ID

1. Fügen Sie den Bot als Administrator zum Kanal hinzu.

2. Führen Sie die Anfrage aus:

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

3. Übernehmen Sie das Feld chat_id des gewünschten Kanals. Normalerweise ist das eine negative Zahl.

Umgebungsvariablen

Werkzeuge

Dateien werden über Pfade auf der Festplatte übergeben. Schaltflächen sind ein optionaler Parameter кнопки bei allen veröffentlichenden Werkzeugen.

MAX-Einschränkungen

In der Praxis getestet. In der offiziellen Dokumentation sind diese Regeln unvollständig beschrieben.

Das Mischen von Audio, Dokumenten und Standortmarkierungen mit anderen Anhängen lehnt der Server mit einem Fehler wie Must be only one audio attachment in message ab.

Zertifikate

MAX-Server verwenden ein Zertifikat der Zertifizierungsstelle „Russian Trusted Root CA“ (Ministerium für digitale Entwicklung der Russischen Föderation). Dieser Root ist nicht im Standard- Speicher von Node.js enthalten, daher bricht die Verbindung ohne zusätzliche Konfiguration mit dem Fehler unable to get local issuer certificate ab.

Damit der Server auf jeder Maschine ohne manuelle Konfiguration funktioniert, ist das Root-Zertifikat im Paket enthalten – Datei certs/russian_trusted_root.pem.

So funktioniert es:

• Das Zertifikat wird nur auf die Domänen max.ru, oneme.ru, okcdn.ru und mycdn.me angewendet – der übrige Datenverkehr wird auf normale Weise geprüft;

• Es wird zu den System-Roots hinzugefügt und ersetzt sie nicht;

• Beim Start wird die SHA-256-Prüfsumme verglichen; wenn die Datei ausgetauscht wurde, startet der Server nicht;

• Es wird nichts im System installiert – die Konfiguration wirkt nur innerhalb des Serverprozesses.

Fingerabdruck des integrierten Zertifikats:

d26d2d0231b7c39f92cc738512ba54103519e4405d68b5bd703e9788ca8ecf31

Vergleichen lässt er sich mit dem auf gosuslugi.ru veröffentlichten.

Wenn der Root bereits in Ihrem System installiert ist, kann das integrierte Zertifikat deaktiviert werden: MAX_DISABLE_CUSTOM_CA=1. Ein eigenes Zertifikat wird über MAX_CA_CERT_PATH eingebunden.

Diagnose

Der Server schreibt Diagnoseinformationen in den Standardfehlerstrom. Beim Start werden der TLS-Status und das Ergebnis der Verbindungsprüfung ausgegeben.

Bekanntes Problem der Bibliothek

Der Server verwendet die offizielle Bibliothek @maxhub/max-bot-api. In Version 0.2.5 funktioniert das Hochladen von Bildern und Dokumenten über einen Dateipfad oder einen Stream auf Node.js 21 und neuer nicht: In FormData wird ein Objekt eingefügt, das das moderne undici nicht als Datei erkennt, und der Server antwortet mit NO_IMAGE.

Dieser Server umgeht das Problem, indem er Dateien in den Speicher liest und als Buffer übergibt. Video und Audio werden auf andere Weise hochgeladen und sind nicht betroffen.

Lizenz

MIT