Memungkinkan AI client untuk membaca, mencari, dan mengirim pesan melalui akun MAX atau bot Anda.
Juga dikenal sebagai WireCatLabs/max-cli, max-cli, @wirecat/max-cli
- Stars
- 13
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.115.0
- Commit terakhir
- 14 Nov 2026
- Lisensi
- Apache-2.0
Apa itu WireCat MAX MCP?
WireCat MAX adalah MCP server. Memungkinkan AI client untuk membaca, mencari, dan mengirim pesan melalui akun MAX atau bot Anda.
Ringkasan dibuat dari README proyek
Tentang WireCat MAX MCP server
WireCat MAX menyediakan jembatan antara akun MAX atau bot Anda dengan AI agent. Tool ini memungkinkan pengguna untuk mengintegrasikan riwayat pesan, chat, dan kontak ke dalam tool seperti Claude Code, Cursor, dan Gemini CLI. Server ini dapat digunakan secara lokal melalui terminal atau sebagai MCP server untuk desktop client seperti Claude Desktop. Setup dilakukan melalui pemindaian QR code di aplikasi MAX atau via SMS, sehingga CLI berfungsi sebagai perangkat tambahan pada akun Anda.
Tool ini dirancang untuk developer dan power user yang ingin mengotomatisasi tugas pengiriman pesan atau menggunakan AI untuk merangkum percakapan. Tool ini menyimpan salinan lokal dari korespondensi Anda untuk pencarian offline yang cepat dan menyertakan fitur transkripsi bawaan untuk pesan suara. Meskipun mendukung akses akun penuh termasuk grup dan file, tool ini menyertakan fitur keamanan seperti profil read-only dan batasan pesan untuk mencegah tindakan yang tidak diinginkan. Pengguna dapat memilih antara berinteraksi dengan akun pribadi melalui API tidak resmi atau mengelola bot resmi melalui Bot API standar.
Apa yang bisa Anda lakukan dengannya
- 1Merangkum komitmen terbaruMinta AI agent untuk meninjau chat terbaru Anda guna menemukan apa saja yang telah Anda janjikan kepada orang lain.
- 2Cari riwayat pesan secara offlineLakukan pencarian cepat melalui riwayat chat Anda tanpa memerlukan koneksi internet yang aktif.
- 3Transkripsi pesan suaraKonversi voice note yang masuk menjadi teks secara lokal di mesin Anda agar lebih mudah dibaca.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal WireCat MAX MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal WireCat MAX MCP di Claude Code
$ claude mcp add max-cli -- npx -y @wirecat/max-cliInstal WireCat MAX MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Instal WireCat MAX MCP di VS Code
.vscode/mcp.json
{
"servers": {
"max-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Instal WireCat MAX MCP di VS Code CLI
$ code --add-mcp '{"name":"max-cli","type":"stdio","command":"npx","args":["-y","@wirecat/max-cli"]}'Instal WireCat MAX MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Instal WireCat MAX MCP di Codex
$ codex mcp add max-cli -- npx -y @wirecat/max-cliInstal WireCat MAX MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.max-cli] command = "npx" args = ["-y", "@wirecat/max-cli"]
Instal WireCat MAX MCP di Gemini CLI
$ gemini mcp add -s user max-cli npx -- -y @wirecat/max-cliInstal WireCat MAX MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di GitHubMAX CLI для людей, ботов и агентов
Ваш аккаунт и ваши боты MAX — в терминале и в ИИ-агентах. Читайте, ищите и отвечайте сами или поручите это Claude, Codex и Cursor — по вашим правилам.
Документация · Примеры · WireCat
Пример разговора с агентом (люди и чаты вымышленные):
Вы: Что я кому обещал за последние три дня?
Агент: (вызывает max personal review: 12 чатов, 3 голосовых расшифровано)
Я должен
· Алисе Пример — прислать счёт до пятницы. Личный чат, 24.09
Жду от других
· Борис Образцов — макет к 25.09. В группе «Дизайн» его пока нет
Нужно уточнить
· «Проект Альфа»: кто везёт образцы — договорились «потом решим», 25.09
Вы: Напомни Борису про макет.
Агент: Черновик: «Борис, привет! Как там макет?» Отправить?
Вы: Да.
Быстрый старт
npm install -g @wirecat/max-cli
max skill install --for all # навык для Claude Code, Codex и Gemini CLI
max personal setup # вход по QR-коду
max personal inbox # непрочитанное во всех чатах, ничего не отмечая
max personal setup за пять минут проводит через вход: вы сканируете QR-код в приложении MAX, и max
становится ещё одним вашим устройством. Навык можно поставить и самим setup: --agent claude, codex,
cursor, gemini, all или none. Войти можно и по SMS через web.max.ru — max personal setup --help.
Нужен Node 22.16+ (ветка 22.x) или 24+, либо Bun 1.3+; работает в Windows, macOS и Linux.
Попробовать без установки — npx @wirecat/max-cli --help. Если max не находится,
npx @wirecat/max-cli personal doctor скажет почему (personal — имя профиля, которое вы выбрали; у вас оно может быть другим).
Глобальная установка (npm install -g) навык агента не ставит: его ставит max personal setup или max skill install --for all. MAX_INSTALL_AGENT=all при установке ставит его сразу, в ~/.claude/skills и ~/.agents/skills, если npm запускает сценарий установки. npm 11.17 и новее по умолчанию его не запускает и пишет об этом (allow-scripts) — это безвредно. В Windows, если max не находится, откройте новый терминал или выполните восстановление из установки.
Подробнее: установка (wirecat.dev), вход и профили (wirecat.dev).
Что можно сделать
Разобрать, что пришло. «Используй max CLI: кто ждёт моего ответа и что срочно?»
max personal inbox
Найти что угодно. «Когда мы договорились о встрече с Алисой?» — ответ с датой и самим сообщением, по локальной копии и без запросов к MAX.
max personal search messages "встреча Алиса"
Понять, кто кому что должен. «Что я обещал и чего жду от других?» — вся переписка с прошлого обзора, ваши сообщения и голосовые текстом.
max personal review 'date>3d' --transcribe
Ещё: сводки утром и вечером, итог недели по рабочему чату, кому вы обещали ответить, черновики ответов, которые отправляете вы или агент с вашего разрешения.
Подробнее: рецепты для агентов (wirecat.dev).
Для ИИ-агентов
Ваш агент. Ваш MAX. Ваши правила.
- Агент с терминалом — Claude Code, Codex, Cursor, Gemini CLI. Он сам вызывает
max, а навык (skill) — инструкция для агента — объясняет ему команды и ограничения.max personal setupставит навык сам; отдельно —max skill install. - Приложение без терминала — Claude Desktop, Cursor и другие клиенты MCP. Подключите
MCP-сервер
max personal mcp serve; готовые просьбы/catch-up,/review,/replyи/findуже внутри. - ChatGPT или Claude в браузере — через HTTPS-туннель и вход по коду.
max personal mcp add claude-code # или codex
max personal mcp config # запись для Claude Desktop, Cursor и других
Профиль по умолчанию может отправлять, поэтому mcp add сначала останавливается. Проверьте права
профиля и повторите команду с --allow-writes.
С --json каждая команда отдаёт только данные, а ошибка приходит отдельно, с постоянным кодом
завершения.
Подробнее: MCP-сервер (wirecat.dev), браузер (wirecat.dev), контракт для скриптов (wirecat.dev).
Почему max
- Весь аккаунт, а не только бот. Чаты, история, группы, контакты, файлы и голосовые — почти всё, что умеет приложение; кружков и настройки пароля двухэтапной проверки пока нет. И отдельно бот через официальный Bot API.
- Своя копия переписки. Всё прочитанное хранится на вашем компьютере: быстрый поиск и чтение
без интернета (
--offline), выгрузка в JSONL или Markdown. - Сделан для агентов. Навык, MCP-сервер, одна форма JSON и коды ошибок, по которым скрипт решает, что делать дальше.
- Безопасен по умолчанию. Чтение не ставит отметку «прочитано». Есть профиль только для чтения,
список чатов для записи и лимит сообщений в час. Если имя подходит к двум чатам,
maxне выбирает сам. Если связь оборвалась при отправке,maxтак и скажет, а повтор не создаст второе сообщение. - Порядок в группах, которые вы ведёте. Вопросы без ответа, кто вступил, проверка по вашим правилам: спам, чужие ссылки, флуд. По умолчанию проверка только отмечает.
Чем отличается от других
Для MAX есть и другие хорошие проекты; PyMax — самая полная библиотека для личного аккаунта, и её код помог разобрать протокол. Коротко, для личного аккаунта:
| max-cli | PyMax | max-mcp | |
|---|---|---|---|
| что это | программа и MCP-сервер | библиотека на Python | MCP-сервер на PyMax |
| готовые команды, навык и MCP для агентов | ✅ | — | MCP |
| ограничения для агента: только чтение, список чатов, лимит в час | ✅ | — | — |
| локальная копия с поиском без интернета | ✅ | — | — |
| расшифровка голосовых на вашем компьютере | ✅ | — | — |
| реакции, правка, пересылка, опросы, отложенная отправка | ✅ | ✅ | — |
| для админа группы: вопросы без ответа, проверка по правилам | ✅ | — | — |
Подробнее: полная таблица (wirecat.dev). Сравнение с другими инструментами MAX: сравнение (wirecat.dev).
Личный аккаунт
max без слова bot работает с вашим аккаунтом как ещё одно ваше устройство.
⚠️ Для личного аккаунта max-cli использует неофициальный внутренний API MAX. API может измениться без предупреждения, а использование инструмента может нарушать условия сервиса. Вы используете max-cli на свой риск; авторы и контрибьюторы не несут ответственности за блокировки аккаунтов, потерю данных или другие последствия. Бот работает через официальный API, и к нему это не относится.
- Читать. Чаты, история, сообщение вместе с соседними, непрочитанное во всех чатах (
max personal inbox), разбор «кто кому должен» (max personal review), новые сообщения по мере прихода (max personal watch), вложения, голосовые — текстом на вашем компьютере. - Писать. Текст и разметка, ответы, фото, видео, файлы и голосовые, правка, пересылка, закрепление, реакции, опросы, отложенная отправка, удаление — у себя или у всех.
- Группы и каналы. Создать, вступить по ссылке, выйти, участники и админы, настройки, ссылка-приглашение, папки.
- Контакты и аккаунт. Найти по номеру, добавить, переименовать, заблокировать, свои заметки о людях; профиль и фото; другие сеансы.
max personal inbox # непрочитанное, ничего не отмечая
max personal messages list "Алиса Пример" --limit 20
max personal messages send "Алиса Пример" "Созвонимся в 15:00?" --reply-to <id>
max personal reactions add "Алиса Пример" <id> 👍
max personal messages send 0 "Позвонить Борису" --at-time 2h # напоминание себе в «Избранное»
max personal chats mark-read "Алиса Пример" # отметить прочитанным, когда нужно
Подробнее: личный аккаунт (wirecat.dev), один человек (wirecat.dev), ответы (wirecat.dev).
Бот
max sales bot работает через официальный Bot API MAX по токену бота.
Ботов может быть несколько: каждый хранится под именем, которое вы выбираете, и это имя — первое
слово команды. Бота создают на business.max.ru; MAX выдаёт их
подтверждённым организациям, ИП и самозанятым.
max sales bot auth set # токен — в скрытом вводе, MAX его проверит
max sales bot recipients add "Команда продаж" # писать только сюда
max sales bot messages send "Команда продаж" "**Сборка готова**" --md --file report.pdf
max sales bot messages pin "Команда продаж" <mid> # id сообщения — из ответа на send
max sales bot watch --events # всё, что происходит в чатах бота
max sales bot chats moderate "Команда продаж" --dry-run # что нарушает правила — без действий
max sales bot api get-updates --limit 10 # любой метод Bot API
max sales bot list --check # все боты на этом компьютере
- Полный Bot API. Каждый метод официальной схемы —
max <бот> bot api <операция>: параметры — флаги, тело — JSON, который сверяется со схемой до отправки. - Сообщения и чаты. Чат называют по номеру, по названию, если бот его видел, или человека как
user:<номер>. Файлы, участники, комментарии, кнопки, меню команд, вебхуки. - Модерация.
bot chats rulesиbot chats moderateудаляют спам и людей по вашим правилам. - Копия переписки бота.
bot contacts show,bot search messages --from,bot messages between— без запросов к MAX. - Бот не напишет лишнего. Свой список чатов для записи, журнал отправленного без текста,
permissionsи MCP-серверmax <бот> bot mcp serve. Токен — в системном хранилище паролей, отдельно от вашего.
Подробнее: бот MAX (wirecat.dev).
Группы, которые вы ведёте
max personal review chat:"Поход" --unanswered # вопросы, на которые сутки никто не ответил
max personal chats events "Поход" # кто вступил и вышел
max personal chats members list "Поход" --all # все участники: когда заведён аккаунт
max personal chats rules set "Поход" invites delete # приглашения в чужие чаты — удалять
max personal chats moderate "Поход" --dry-run # что нарушает правила — без действий
Проверка сверяет новое в группе с вашими правилами: заблокированные люди, приглашения, ссылки, пересланное, флуд, совсем новые аккаунты. По умолчанию она только отмечает. Для каждого действия вы решаете сами: никогда, только с флагом, с вашим подтверждением или сразу. Не больше 10 действий за раз, и ничего не следит за группой в фоне.
Подробнее: группы (wirecat.dev), рейтинги (wirecat.dev).
Локальная копия и поиск
Всё прочитанное сохраняется на вашем компьютере. По копии работают поиск и чтение без интернета; историю чата можно скачать глубже и выгрузить.
max personal search messages "договор" # только сообщения
max personal search all "договор" # шире, по просьбе: и заметки (для почты есть отдельный CLI memo)
max personal search messages 'договор chat:"Проект Альфа"' # только один чат
max personal messages sync "Проект Альфа" --last 500 # последние 500 сообщений — в копию
max personal store export "Проект Альфа" --format markdown --output alfa.md
max personal chats list --offline # без подключения к MAX
Поиск понимает слова, людей, даты, файлы, ссылки и ваши метки; есть поиск по темам и сохранённые
запросы. Текст из сохранённых вложений ищется через content:.
Подробнее: локальная копия (wirecat.dev), поиск (wirecat.dev), язык запросов (wirecat.dev), поиск по темам (wirecat.dev), вложения (wirecat.dev), голосовые (wirecat.dev).
Агенты: навык и MCP
Навык ставится одной командой и всегда той же версии, что и max: в ~/.claude/skills/max-cli/
для Claude Code и в ~/.agents/skills/max-cli/ для Codex, Gemini CLI и Cursor. После обновления
max запустите установку ещё раз.
max skill show # прочитать до входа
max skill install --for all # или --for claude, --for agents
MCP-сервер работает с тем же аккаунтом. Права профиля проверяются при каждом вызове; формы
подтверждения на сервере нет — подтверждение вызовов настраивается в приложении агента. Навык
доступен ресурсом max://skill.
max personal mcp check # проверить локальный MCP
max personal mcp serve --http --public-url https://<имя>.ts.net # для ChatGPT и Claude в браузере
max personal mcp serve --permission messages.send=deny # запретить отправку этому серверу
Подробнее: MCP-сервер (wirecat.dev), браузер (wirecat.dev), внешние модели (wirecat.dev).
Для скриптов
С --json команда печатает только данные; так же она работает, когда её вывод читает другая
программа (max … | jq). Любой список приходит в одной форме:
{ "items": [ … ], "page": { "limit": 20, "has_more": true }, "meta": { … } }
Ошибка приходит одной строкой JSON в stderr, stdout остаётся пустым. Код завершения говорит, что
случилось: 4 — нужно войти, 5 — права не разрешают, 6 — чат или сообщение не найдены, 8 —
лимит, 9 — MAX не ответил вовремя, 14 — неизвестно, ушло ли сообщение (повторять только с тем же
--operation-id). Частичный результат может прийти с кодом 0: проверьте поля missing и next.
Подробнее: контракт (wirecat.dev), все команды и коды (wirecat.dev).
Вход и профили
max personal setup --agent codex # QR-код в терминале и навык Codex
max personal setup --method qr-chrome # QR через web.max.ru в браузере
max personal setup --method sms # номер телефона — в браузере
max personal setup --method token # готовый токен, скрытым вводом или через stdin
max personal session start qr # повторный вход, когда сессия истекла
Профиль называется первым словом в каждой команде — max personal chats list, — или
export MAX_PROFILE=personal на всю сессию оболочки. max никогда не выбирает профиль сам, даже единственный: без имени команда останавливается
и перечисляет профили этого компьютера. Имя personal — пример: любое подойдёт.
Подробнее: вход и сессии (wirecat.dev), профили (wirecat.dev).
Настройки и права
У каждого профиля свои настройки и права; без файла настроек действуют встроенные значения.
| Настройка | Что делает | По умолчанию |
|---|---|---|
permissions |
что можно: deny, readonly, ask, allow — для команды или группы команд |
всё, кроме удаления и других необратимых действий: они спрашивают |
sends_per_hour |
сколько сообщений профиль отправит за час | 30 |
requests_per_minute |
темп обращений к MAX | 20 |
limit |
сколько строк в списке | 20 |
max personal config set permissions.messages readonly # профиль только для чтения
max personal config set permissions.messages.send ask # спрашивать перед отправкой
Подробнее: настройки (wirecat.dev), права (wirecat.dev), все ключи (wirecat.dev).
Ограничения
max держит каждый профиль в одном темпе: первые 10 запросов идут сразу, дальше — 20 в минуту, и
две команды одновременно делят этот темп. Если MAX отвечает «слишком много запросов», max
останавливается и не повторяет запрос сам. Фоновый max personal serve держит одно подключение для всех
команд и сам останавливается, когда им 15 минут никто не пользуется.
Подробнее: ограничения и ожидания (wirecat.dev).
Безопасность
- Токен входа — в системном хранилище паролей, не в истории команд. Если хранилище недоступно,
maxничего не спрашивает: кладёт токен в файл, доступный только вам, и один раз говорит об этом.session start --credential-storage fileвыбирает файл сразу — не советуем, хранилище надёжнее. - Локальная копия и служебные файлы доступны только вашему пользователю; от кражи диска защищает шифрование диска целиком.
- Перед каждой отправкой, в том числе через фоновый сервер и MCP,
maxпроверяет ограничения профиля и пишет строку в журнал — без текста сообщения. --fileне отправит известные файлы с учётными данными, папкиmaxи хранилище.- Чужой текст не управляет вашим терминалом: управляющие символы из имён и сообщений показываются как текст.
- Ограничения защищают от агента, которого уговорило прочитанное сообщение, но не от агента, который хочет их обойти: для этого нужна песочница или отдельный пользователь.
Подробнее: безопасность (wirecat.dev).
Когда не работает
max personal doctor # где лежат файлы и есть ли вход; к MAX не подключается
max personal chats list --trace # каждый запрос к MAX — без текстов, имён и токена
max personal runs list # неудачные и частичные запуски сохраняются сами
Запись --trace можно приложить к сообщению об ошибке.
Подробнее: по симптому (wirecat.dev), диагностика (wirecat.dev).
Pertanyaan tentang WireCat MAX MCP
Bagaimana cara menambahkan WireCat MAX MCP ke Claude Code?
Jalankan claude mcp add max-cli -- npx -y @wirecat/max-cli di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan WireCat MAX MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara menghubungkan akun MAX saya ke AI agent?
Anda dapat menggunakan command max personal setup untuk login via QR code, yang membuat CLI menjadi perangkat tambahan untuk akun Anda.
Apakah saya bisa menggunakan ini dengan Claude Desktop atau Cursor?
Ya, Anda bisa menghubungkan client yang kompatibel dengan MCP dengan menjalankan command max personal mcp config.
Apakah membaca pesan akan menandainya sebagai sudah dibaca?
Tidak, proses membaca aman secara default dan tidak akan memicu status 'read'.
Apakah ada cara resmi untuk menggunakan bot?
Ya, command max sales bot bekerja melalui official MAX Bot API menggunakan sebuah token.