Как повторить
- Скачайте Beeper Desktop с beeper.com/download и войдите в аккаунт. Аккаунт бесплатный.
- Подключите мессенджеры в разделе управления аккаунтами. Пункт ищите по словам «Connect a chat network» или «Add account». В каждый мессенджер вы входите так же, как в его обычный клиент: для WhatsApp это QR-код, как в WhatsApp Web. Бесплатно можно подключить до пяти мессенджеров по одному аккаунту в каждом. Если нужно больше мессенджеров или несколько аккаунтов в одном (до трёх в мессенджере, до десяти всего), понадобится Beeper Plus за $9.99 в месяц или $99.99 в год. Безлимит для команды даёт Plus Plus, от $49.99 в месяц.
- Не закрывайте Beeper Desktop. Его API работает по адресу
http://localhost:23373, только пока приложение запущено. - Подключите официальный MCP:
- Claude Code:
claude mcp add beeper http://localhost:23373/v0/mcp -t http -s user. С-s userсервер будет доступен во всех проектах, с-s localтолько в текущем. Путь/v0/mcpбыл актуален на 25.08.2026. В октябре 2025 REST API Beeper уже переезжал с/v0на/v1, и если такой переезд затронет MCP, команда перестанет работать. Актуальный путь ищите на developers.beeper.com. - Claude Desktop: скачайте файл расширения и установите его через Settings, Extensions, Install from file. Это стандартный способ установки файлов .dxt, но названия пунктов сверьте в своём приложении.
- При первом запросе Beeper должен открыть отдельное окно, где вы разрешаете Claude доступ к переписке. Если окно не появилось, создайте токен вручную: Settings, Developers, Generate Access Token. Этот путь описан в документации beeperbox, а не в официальной, поэтому сверьте его в своём приложении. Затем добавьте в настройки MCP заголовок
Authorization: Bearer <токен>. - Если официальный MCP не работает с вашим агентом, есть beeperbox, неофициальная обёртка от стороннего разработчика. Версия пока ниже 1.0, с Beeper проект не связан. Без Docker её запускают командой
BEEPER_TOKEN=токен npx beeperbox, при этом нужны запущенный Beeper Desktop и Node 18+. В настройки агента она добавляется как stdio-сервер, то есть локальная программа, командойnpx beeperbox --stdio. Есть и вариант с Docker: Beeper работает внутри контейнера без окна, а первый вход делается через noVNC (удалённый экран в браузере) наlocalhost:6080. Токен открывает доступ ко всей переписке, поэтому, если вы сами не проверяли код beeperbox, используйте официальный MCP.
Как проверить результат
Попросите Claude: «покажи мои непрочитанные чаты». Если всё работает, в ответе будут настоящие названия чатов и фрагменты сообщений. Если Claude пишет, что не может подключиться, проверьте, что Beeper открыт и после запуска успел поднять API. Если список аккаунтов пустой, мессенджер не подключён в самом Beeper. Ошибка 401 означает, что токен не выдан или истёк: повторите шаг 5. Если мессенджер виден, а нужный чат не находится, подождите: WhatsApp и Instagram догружают историю в фоне.
Как это устроено
Beeper входит в каждый мессенджер как обычный клиент через открытые мосты mautrix и собирает переписку в одном месте. Поэтому Claude работает с одним локальным адресом и не разбирается с каждым мессенджером по отдельности. В официальном MCP всего два инструмента: поиск по документации и выполнение кода. Claude сам пишет код на TypeScript для SDK Beeper, а сервер выполняет его в изолированной среде. В beeperbox вместо этого 12 готовых команд, например read_chat и send_message.
Сообщения уходят от вашего имени. Документация Beeper предупреждает, что из-за частой отправки через API мессенджер может заблокировать аккаунт. Особенно строго к автоматизации относится WhatsApp.
Ссылки
- Расширение Beeper для Claude Desktop: файл .dxt для установки.