Permet à un client IA de lire, rechercher et envoyer des messages via votre compte MAX ou vos bots.
Aussi connu sous WireCatLabs/max-cli, max-cli, @wirecat/max-cli
- Étoiles
- 13
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.115.0
- Dernier commit
- 14 nov. 2026
- Licence
- Apache-2.0
Qu'est-ce que WireCat MAX MCP ?
WireCat MAX est un serveur MCP. Permet à un client IA de lire, rechercher et envoyer des messages via votre compte MAX ou vos bots.
Résumé généré à partir du README du projet
À propos du MCP server WireCat MAX
WireCat MAX fournit une passerelle entre votre compte MAX ou vos bots et les agents IA. Il permet aux utilisateurs d'intégrer leur historique de messagerie, leurs discussions et leurs contacts dans des outils tels que Claude Code, Cursor et Gemini CLI. Le serveur peut être utilisé localement via un terminal ou comme MCP server pour des clients de bureau comme Claude Desktop. La configuration s'effectue par un scan de code QR dans l'application MAX ou via SMS, faisant du CLI un appareil supplémentaire sur votre compte.
Cet outil est conçu pour les développeurs et les utilisateurs avancés qui souhaitent automatiser des tâches de messagerie ou utiliser l'IA pour résumer des conversations. Il maintient une copie locale de votre correspondance pour une recherche rapide hors ligne et inclut une transcription intégrée pour les messages vocaux. Bien qu'il supporte un accès complet au compte, y compris les groupes et les fichiers, il inclut des fonctionnalités de sécurité telles que des profils en lecture seule et des limites de messages pour éviter toute action involontaire. Les utilisateurs peuvent choisir entre interagir avec leur compte personnel via une API non officielle ou gérer des bots officiels via l'API Bot standard.
Ce que vous pouvez faire avec
- 1Résumer les engagements récentsDemandez à un agent IA d'examiner vos discussions récentes pour retrouver ce que vous avez promis à d'autres personnes.
- 2Rechercher l'historique des messages hors ligneEffectuez des recherches rapides dans votre historique de chat sans avoir besoin d'une connexion internet active.
- 3Transcrire les messages vocauxConvertissez les notes vocales entrantes en texte localement sur votre machine pour une lecture plus facile.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer WireCat MAX MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller WireCat MAX MCP dans Claude Code
$ claude mcp add max-cli -- npx -y @wirecat/max-cliInstaller WireCat MAX MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Installer WireCat MAX MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"max-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Installer WireCat MAX MCP dans VS Code CLI
$ code --add-mcp '{"name":"max-cli","type":"stdio","command":"npx","args":["-y","@wirecat/max-cli"]}'Installer WireCat MAX MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Installer WireCat MAX MCP dans Codex
$ codex mcp add max-cli -- npx -y @wirecat/max-cliInstaller WireCat MAX MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.max-cli] command = "npx" args = ["-y", "@wirecat/max-cli"]
Installer WireCat MAX MCP dans Gemini CLI
$ gemini mcp add -s user max-cli npx -- -y @wirecat/max-cliInstaller WireCat MAX MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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).
Questions sur WireCat MAX MCP
Comment ajouter WireCat MAX MCP à Claude Code ?
Exécutez claude mcp add max-cli -- npx -y @wirecat/max-cli dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter WireCat MAX MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment connecter mon compte MAX à un agent IA ?
Vous pouvez utiliser la commande max personal setup pour vous connecter via un code QR, ce qui fait du CLI un appareil supplémentaire pour votre compte.
Puis-je utiliser cela avec Claude Desktop ou Cursor ?
Oui, vous pouvez connecter des clients compatibles MCP en exécutant la commande max personal mcp config.
La lecture des messages les marque-t-elle comme lus ?
Non, la lecture est sécurisée par défaut et ne déclenche pas de statut « lu ».
Existe-t-il un moyen officiel d'utiliser des bots ?
Oui, la commande max sales bot fonctionne via l'API officielle MAX Bot à l'aide d'un token.