Bir AI istemcisinin MAX hesabınız veya botlarınız üzerinden mesaj okumasına, arama yapmasına ve mesaj göndermesine olanak tanır.
Ayrıca bilinen adı WireCatLabs/max-cli, max-cli, @wirecat/max-cli
- Yıldızlar
- 13
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.115.0
- Son commit
- 14 Kas 2026
- Lisans
- Apache-2.0
WireCat MAX MCP nedir?
WireCat MAX bir MCP sunucusudur. Bir AI istemcisinin MAX hesabınız veya botlarınız üzerinden mesaj okumasına, arama yapmasına ve mesaj göndermesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
WireCat MAX MCP sunucusu hakkında
WireCat MAX, MAX hesabınız veya botlarınız ile AI agent'lar arasında bir köprü sağlar. Kullanıcıların mesaj geçmişlerini, sohbetlerini ve kişilerini Claude Code, Cursor ve Gemini CLI gibi araçlara entegre etmelerine imkan tanır. Sunucu, bir terminal aracılığıyla yerel olarak veya Claude Desktop gibi masaüstü istemcileri için bir MCP server olarak kullanılabilir. Kurulum, MAX uygulamasında bir QR kod taraması veya SMS yoluyla gerçekleştirilir; bu da CLI'nın hesabınızda ek bir cihaz gibi davranmasını sağlar.
Bu araç, mesajlaşma görevlerini otomatikleştirmek veya konuşmaları özetlemek için AI kullanmak isteyen geliştiriciler ve ileri düzey kullanıcılar için tasarlanmıştır. Hızlı ve çevrimdışı arama yapabilmeniz için yazışmalarınızın yerel bir kopyasını tutar ve sesli mesajlar için yerleşik transkripsiyon özelliği içerir. Gruplar ve dosyalar dahil olmak üzere tam hesap erişimini desteklese de, istenmeyen eylemleri önlemek için salt okunur profiller ve mesaj limitleri gibi güvenlik özellikleri sunar. Kullanıcılar, resmi olmayan bir API aracılığıyla kişisel hesaplarıyla etkileşime geçmek veya standart Bot API aracılığıyla resmi botları yönetmek arasında seçim yapabilirler.
Neler yapabilirsiniz
- 1Son taahhütleri özetleyinBaşkalarına ne söz verdiğinizi bulmak için bir AI agent'tan son sohbetlerinizi incelemesini isteyin.
- 2Mesaj geçmişinde çevrimdışı arama yapınAktif bir internet bağlantısına ihtiyaç duymadan sohbet geçmişinizde hızlı aramalar gerçekleştirin.
- 3Sesli mesajları yazıya dökünGelen sesli notları, daha kolay okuma için yerel makinenizde metne dönüştürün.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
WireCat MAX MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWireCat MAX MCP'yi Claude Code içine yükleyin
$ claude mcp add max-cli -- npx -y @wirecat/max-cliWireCat MAX MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}WireCat MAX MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"max-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}WireCat MAX MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"max-cli","type":"stdio","command":"npx","args":["-y","@wirecat/max-cli"]}'WireCat MAX MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}WireCat MAX MCP'yi Codex içine yükleyin
$ codex mcp add max-cli -- npx -y @wirecat/max-cliWireCat MAX MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.max-cli] command = "npx" args = ["-y", "@wirecat/max-cli"]
WireCat MAX MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user max-cli npx -- -y @wirecat/max-cliWireCat MAX MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"max-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/max-cli"
]
}
}
}Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
MAX 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).
WireCat MAX MCP soruları
WireCat MAX MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add max-cli -- npx -y @wirecat/max-cli komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
WireCat MAX MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
MAX hesabımı bir AI agent ile nasıl bağlarım?
QR kod ile giriş yapmak için max personal setup komutunu kullanabilirsiniz; bu işlem CLI'yı hesabınız için ek bir cihaz haline getirir.
Bunu Claude Desktop veya Cursor ile kullanabilir miyim?
Evet, max personal mcp config komutunu çalıştırarak MCP uyumlu istemcileri bağlayabilirsiniz.
Mesajları okumak onları okundu olarak işaretler mi?
Hayır, okuma işlemi varsayılan olarak güvenlidir ve 'okundu' durumunu tetiklemez.
Botları kullanmanın resmi bir yolu var mı?
Evet, max sales bot komutu, bir token aracılığıyla resmi MAX Bot API üzerinden çalışır.