max-channel-mcp

Servidor MCP para publicar en canales del mensajero MAX.

Se conecta a Claude Desktop, Claude Code y otros clientes que admiten Model Context Protocol. Tras la configuración, el asistente puede publicar en tu canal texto, fotos, vídeos, audio, documentos y ubicaciones — simplemente cuando lo pidas.

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

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

Características

• Publicación de texto con formato Markdown o HTML

• Álbumes de hasta 10 fotos, vídeos, álbumes mixtos

• Audio, documentos, ubicaciones

• Botones bajo los mensajes: enlaces y callback

• Edición y fijación de mensajes publicados

• Lectura del historial del canal

La eliminación de mensajes no está implementada deliberadamente: el asistente no debe tener la posibilidad de borrar el contenido del canal.

Related MCP server: Telegram Channel MCP Server

Requisitos

• Node.js 18.18 o superior

• Un bot creado con MasterBot

• Permisos de administrador para el bot en tu canal

Instalación

Claude Code

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

El ámbito local guarda el token en tu configuración personal, no en el archivo del proyecto.

Claude Desktop

Añade a claude_desktop_config.json:

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

Ruta del archivo de configuración:

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

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

Desde el código fuente

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

Luego indica en la configuración node /полный/путь/dist/index.js en lugar de npx.

Configuración

Cómo obtener el token

Abre MasterBot, crea un bot siguiendo las instrucciones: recibirás un token como respuesta.

Cómo averiguar el identificador del canal

1. Añade el bot al canal como administrador.

2. Ejecuta la solicitud:

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

3. Toma el campo chat_id del canal correspondiente. Normalmente es un número negativo.

Variables de entorno

Herramientas

Los archivos se pasan mediante rutas en el disco. Los botones son un parámetro opcional кнопки en todas las herramientas de publicación.

Limitaciones de MAX

Comprobado en la práctica. En la documentación oficial estas reglas están descritas de forma incompleta.

El servidor rechaza mezclar audio, documentos y ubicaciones con otros adjuntos con un error del tipo Must be only one audio attachment in message.

Certificados

Los servidores de MAX utilizan un certificado de la autoridad de certificación «Russian Trusted Root CA» (Ministerio de Desarrollo Digital de la Federación de Rusia). Esta raíz no está en el almacén estándar de Node.js, por lo que sin configuración adicional la conexión se interrumpe con el error unable to get local issuer certificate.

Para que el servidor funcione en cualquier máquina sin configuración manual, el certificado raíz está incluido en el paquete: el archivo certs/russian_trusted_root.pem.

Cómo funciona:

• el certificado se aplica solo a los dominios max.ru, oneme.ru, okcdn.ru y mycdn.me; el resto del tráfico se verifica de la forma habitual;

• se añade a las raíces del sistema, no las reemplaza;

• al iniciar se comprueba la suma de verificación SHA-256; si el archivo ha sido sustituido, el servidor no arranca;

• no se instala nada en el sistema: la configuración solo actúa dentro del proceso del servidor.

Huella del certificado integrado:

d26d2d0231b7c39f92cc738512ba54103519e4405d68b5bd703e9788ca8ecf31

Se puede contrastar con el publicado en gosuslugi.ru.

Si la raíz ya está instalada en tu sistema, puedes desactivar la integrada: MAX_DISABLE_CUSTOM_CA=1. Tu propio certificado se conecta mediante MAX_CA_CERT_PATH.

Diagnóstico

El servidor escribe el diagnóstico en el flujo de error estándar. Al iniciar se muestra el estado de TLS y el resultado de la comprobación de conexión.

Problema conocido de la biblioteca

El servidor utiliza la biblioteca oficial @maxhub/max-bot-api. En la versión 0.2.5, la carga de imágenes y documentos mediante ruta de archivo o a través de un flujo no funciona en Node.js 21 y posteriores: en FormData se inserta un objeto que el undici moderno no reconoce como archivo, y el servidor responde NO_IMAGE.

Este servidor evita el problema leyendo los archivos en memoria y pasándolos como Buffer. El vídeo y el audio se cargan de otra forma y no se ven afectados.

Licencia

MIT