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