Claude Max 消息插件

claude-max-messenger-plugin

MCP-сервер, который подключает Claude Code к Max мессенджеру через Bot API. Пишите боту в Max — Claude отвечает прямо из терминала.

Возможности

• Инструмент reply — отправка сообщений с вложениями (до 50 МБ каждое)
• Инструмент edit_message — редактирование ранее отправленных сообщений (например, «обрабатываю…» → результат)
• Контроль доступа: коды сопряжения, белые списки, поддержка групп
• Скачивание фото и передача их Клоду

Ограничения

• Нет истории сообщений и поиска (Bot API Max не поддерживает)
• Бот видит только сообщения, пришедшие после запуска

Установка

1. Клонировать репозиторий

Склонируйте в любую удобную папку, например C:/GIT:

git clone https://github.com/curlysasha/claude-max-messenger-plugin C:/GIT/claude_max_plugin

2. Зарегистрировать локальный маркетплейс

Добавьте в ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "local-plugins": {
      "source": {
        "source": "directory",
        "path": "C:/GIT"
      }
    }
  },
  "enabledPlugins": {
    "max@local-plugins": true
  }
}

Путь C:/GIT — это папка, внутри которой лежит claude_max_plugin/. Claude Code сканирует её в поисках плагинов. Если склонировали в другое место (например, D:/projects/claude_max_plugin), укажите D:/projects.

3. Получить токен бота

Внимание: токен выдаётся только через бизнес-платформу и требует ИП или юрлицо. Telegram такого не требует, но мы здесь не для того, чтобы спорить с Max.

Зарегистрируйтесь на business.max.ru → создайте бота → скопируйте токен.

4. Сохранить токен

/max:configure <ваш-токен>

5. Запустить с флагом канала

Каналы находятся в research preview, и только официальные плагины Anthropic попадают в список разрешённых. Для локальных плагинов используйте флаг разработки. Завершите текущую сессию и запустите новую:

claude --dangerously-load-development-channels plugin:max@local-plugins

6. Сопрячь себя

Напишите своему боту в Max. Он ответит кодом сопряжения. Одобрите его:

/max:access pair <код>

7. Заблокировать доступ (рекомендуется)

Когда все нужные пользователи сопряжены, переключитесь в режим белого списка:

/max:access policy allowlist

Управление доступом

Подробная документация — в ACCESS.md.

Переменные окружения

Директория состояния

Всё состояние хранится в ~/.claude/channels/max/:

~/.claude/channels/max/
├── .env          ← токен бота
├── access.json   ← настройки контроля доступа
├── inbox/        ← скачанные фото (временные)
└── approved/     ← подтверждения сопряжения (обрабатываются сервером)