У вас уже открыты Claude Desktop, Claude Code или Cursor больше часов в день, чем панель управления PushEngage. Каждый раз, когда вам нужно проверить коэффициент кликов или отправить уведомление, вы переключаетесь из окна, где происходит основная работа. Настройка PushEngage MCP устраняет этот разрыв: одна команда npx, вход в браузер, и инструменты PushEngage находятся в той же сессии чата, которую вы уже используете для написания кода, отладки рабочего процесса или ответа на вопрос от вашей команды.
Это полное руководство по настройке: установка, две переменные среды, которые стоит знать, первый вход и три конкретные вещи, которые нарушают соединение, когда оно не работает с первой попытки. К концу вы получите аутентифицированную сессию с выбранным сайтом, а не просто зеленый индикатор «подключено».
Что вы сможете делать после подключения
@pushengage/mcp предоставляет 27 инструментов в 10 областях, и после аутентификации на сайте все они находятся на расстоянии одного предложения, а не одного клика по панели управления. Вот несколько примеров того, как это выглядит после завершения настройки:
- Отправьте push-уведомление немедленно, запланируйте его на определенное время или настройте периодическую отправку — в локальном часовом поясе каждого подписчика, если вы об этом попросите.
- Запустите A/B-тест между двумя заголовками и позвольте ассистенту сообщить о коэффициенте кликов после получения результатов.
- Создайте сегмент или группу аудитории на основе описания на обычном языке вместо пользовательского интерфейса правил.
- Получите аналитику в виде сводки за весь период или в виде ежедневных временных рядов.
- Перечислите ваши кампании-рассылки, триггерные кампании и рабочие процессы, чтобы проверить, что именно запущено.
- Прочитайте настройки вашего сайта, конфигурацию service worker и настройку виджета чата.
Ничто из этого не требует, чтобы у ассистента был ваш пароль от PushEngage, и ничто из этого не требует, чтобы вы покидали свой редактор или терминал. PushEngage использует эту интеграцию для 25 000+ владельцев бизнеса в 150+ странах, отправляя 15,2 миллиарда уведомлений за последние 30 дней. Сервер MCP взаимодействует с тем же производственным API, на котором работает этот объем, а не с песочницей для демонстрации.
Прежде чем начать: что вам нужно
Три вещи, и у вас, вероятно, уже есть как минимум две из них:
- Учетная запись PushEngage — бесплатная или платная, с добавленным как минимум одним сайтом. Сервер MCP не создает сайт для вас; он работает с сайтами, которые вы уже настроили на своей панели управления PushEngage.
- Node.js 18 или новее — ассистент запускает сервер через
npx, который поставляется с Node. Проверьте с помощьюnode -vв терминале. - Клиент с поддержкой MCP — Claude Desktop, Claude Code, Cursor или любой другой клиент, который обменивается данными по протоколу MCP через стандартный ввод/вывод (stdio).
Прежде чем приступить к редактированию конфигурационных файлов, стоит четко прояснить один момент: @pushengage/mcp работает локально на вашем компьютере через stdio. Удаленного сервера или размещенного URL-адреса коннектора нет. Клиент запускает процесс, и этот процесс общается с API PushEngage от вашего имени. Если в руководстве по настройке для другого инструмента вам предлагают вставить удаленный конечный узел, то это другой тип сервера MCP, нежели этот.
Настройка сервера в Claude Desktop, Claude Code и Cursor
Глобальная установка не требуется. npx загружает @pushengage/mcp по запросу при первом запуске клиентом, используя команду npx -y @pushengage/mcp. Вы добавляете эту команду в конфигурацию MCP вашего клиента, перезапускаете клиент, и сервер появляется в списке ваших инструментов.
Каждый клиент хранит свою конфигурацию в разных местах.
Claude Desktop
Отредактируйте файл ~/Library/Application Support/Claude/claude_desktop_config.json на macOS (или эквивалентный путь на вашей платформе):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Перезапустите Claude Desktop. Сервер "pushengage" должен появиться в списке ваших инструментов.
Курсор
Отредактируйте файл ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code обменивается данными по протоколу MCP через stdio так же, как Claude Desktop и Cursor, поэтому та же структура command/args будет работать, если вы напрямую отредактируете его конфигурационный файл MCP. Если вы предпочитаете не редактировать JSON вручную, Claude Code также принимает серверы через свою команду CLI claude mcp add, что является общим поведением Claude Code, а не чем-то специфичным для PushEngage. Обратитесь к собственной документации Claude Code для получения точного синтаксиса флагов, если вы выберете этот путь.
Любой другой клиент MCP
Если ваш клиент не входит в число трех вышеперечисленных, основное требование остается прежним: настройте его на запуск npx -y @pushengage/mcp в качестве сервера stdio. Это весь шаг установки, независимо от того, какой клиент читает конфигурацию.
Именование соединения и изоляция токенов: PE_MCP_CLIENT_NAME и PE_MCP_CONFIG_PATH
Помимо шага установки, дополнительная конфигурация не требуется. Сервер по умолчанию взаимодействует с производственным API PushEngage; существуют две переменные среды для менее распространенных настроек:
| Переменная среды | По умолчанию | Назначение |
|---|---|---|
PE_MCP_CLIENT_NAME | ИИ-ассистент | Метка, отображаемая на экране авторизации PushEngage как приложение, запрашивающее доступ. Установите ее, если хотите указать что-то более конкретное, например "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Место хранения токена доступа. Установите это значение, чтобы одновременно использовать несколько учетных записей PushEngage. Должен быть абсолютным путем — без сокращения ~. |
Большинству настроек с одной учетной записью никогда не нужно изменять ни одну из этих переменных. PE_MCP_CLIENT_NAME — это косметическое удобство, полезное, если вы хотите, чтобы на экране авторизации отображалось что-то более читаемое, чем "ИИ-ассистент", когда вы нажимаете "Авторизовать". PE_MCP_CONFIG_PATH имеет значение в тот момент, когда вам нужен второй, отдельный файл токена, что как раз и рассматривается далее.
Первый запуск: вход в систему и выбор сайта
Аутентификация происходит через браузер, поэтому помощник никогда не видит ваш пароль PushEngage. Процесс состоит из трех шагов, и стоит разобраться, что именно происходит на каждом этапе:
- Попросите помощника войти в систему. Простыми словами: «Войди меня в PushEngage». Это вызывает
pushengage_auth_login, который открывает вкладку браузера на странице авторизации PushEngage. - Нажмите «Авторизовать». Панель управления отправляет токен на сервер POST-запросом — он никогда не появляется в URL, истории браузера или журнале доступа. Токен сохраняется локально с правами доступа
0600, доступными только вашему пользователю. - Попросите помощника показать ваши сайты, затем выберите один. «Показать мои сайты PushEngage» вызывает
pushengage_list_sites; «Использовать сайт 12345» вызываетpushengage_select_site. Выбор сохраняется при перезапусках, и каждый инструмент, связанный с сайтом, действует на него, если вы явно не передаете другойsite_id.
Задействованные инструменты по именам:
| Инструмент | Назначение |
|---|---|
pushengage_auth_login | Открывает браузер на PushEngage и сохраняет токен в случае успеха. |
pushengage_auth_status | Показывает, аутентифицированы ли вы и какой сайт выбран в данный момент. |
pushengage_list_sites | Перечисляет сайты PushEngage, к которым имеет доступ ваша учетная запись. |
pushengage_select_site | Устанавливает текущий сайт, на который будут действовать другие инструменты. |
После выбора сайта запустите pushengage_auth_status (достаточно спросить «каков мой статус аутентификации PushEngage») и убедитесь, что он сообщает как об аутентифицированном сеансе, так и о выбранном сайте, прежде чем пробовать что-либо еще. Это фактическая финишная черта настройки, а не момент, когда клиент впервые показывает сервер как подключенный.
Устранение неполадок по причинам
Большинство проблем с подключением связаны с одной из трех конкретных причин. Диагностируйте в этом порядке.
Сервер вообще не подключается, и ваш клиент показывает «Соединение закрыто». Это почти всегда проблема с PATH, а не ошибка в сервере. Claude Desktop, Cursor и аналогичные клиенты запускаются из Dock или Finder, а не из терминала, поэтому они никогда не загружают файлы запуска вашей оболочки. Если Node был установлен через менеджер версий (nvm, fnm, volta), клиент вообще не может найти npx. Процесс никогда не запускается, и вы получаете общую ошибку соединения вместо четкого сообщения «команда не найдена». Выполните which npx в терминале, чтобы получить абсолютный путь, затем укажите его напрямую в клиенте:
{
"mcpServers": {
"pushengage": {
"command": "/absolute/path/from/which-npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PATH": "/absolute/folder/containing/that/npx:/usr/bin:/bin:/usr/sbin:/sbin"
}
}
}
}Перезапустите клиент после редактирования. Если which npx вместо этого выводит путь в /usr/local/bin или /opt/homebrew/bin, менеджер версий, вероятно, не является вашей проблемой; проверьте журналы MCP самого клиента на наличие фактической ошибки.
[AUTH_EXPIRED]. Ваш токен истек. Попросите помощника войти в систему снова — это все исправит.
[NO_SITE_SELECTED]. Вы аутентифицированы, но сайт еще не выбран. Вызовите pushengage_list_sites, затем запросите использование одного из возвращенных сайтов, прежде чем снова пытаться использовать любой инструмент, привязанный к сайту.
Еще один случай, о котором стоит знать, хотя это и не ошибка: если браузер не открывается автоматически, вы, вероятно, находитесь в сеансе без графического интерфейса или в удаленном сеансе (SSH, контейнер). URL авторизации выводится в терминал, где запущен сервер. Откройте его вручную.
Использование более чем одной учетной записи или клиента PushEngage
Если вы управляете PushEngage для более чем одного бренда или вы агентство, управляющее MCP для нескольких клиентских учетных записей, решением является PE_MCP_CONFIG_PATH из предыдущего раздела: зарегистрируйте сервер под двумя разными именами, каждое со своим путем, чтобы токены не конфликтовали.
{
"mcpServers": {
"pushengage-client-a": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-a.json",
"PE_MCP_CLIENT_NAME": "Claude Desktop (Client A)"
}
},
"pushengage-client-b": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-b.json",
"PE_MCP_CLIENT_NAME": "Claude Desktop (Client B)"
}
}
}
}Войдите отдельно под каждым именем сервера, авторизуя в браузере любую учетную запись PushEngage, которую вы выберете каждый раз. Каждая запись сервера хранит свой собственный файл токенов, поэтому переключение между клиентскими учетными записями зависит от того, какое имя инструмента вы вызываете, а не от повторного входа каждый раз. Если это ваш реальный сценарий использования, в серии есть полное руководство по управлению несколькими клиентскими учетными записями PushEngage из одного ИИ-ассистента.
Что делать после подключения
После завершения аутентификации и выбора сайта 27 инструментов разбиваются на несколько практических групп, которые стоит знать по названиям, а не только по количеству.
Для повседневной работы по управлению кампаниями серия охватывает, как отправлять и планировать push-уведомления из вашего ИИ-ассистента вместо панели управления, и как A/B-тестировать push-уведомления и позволять ИИ выбирать победителя по количеству кликов. Для создания списка есть полное руководство по созданию сегментов подписчиков на простом английском языке.
Для аналитики чтение аналитики push-уведомлений через ваш ИИ-ассистент охватывает сводки за весь срок службы и ежедневные временные ряды. Это те же инструменты аналитики, которые делают результат A/B-теста или отправку кампании достойными отчета, а не просто выполнения. Серия также охватывает аудит drip-кампаний и рабочих процессов для проверки того, что активно, и управление виджетом чата, который отображает WhatsApp и другие каналы на сайте.
Для работы на уровне сайта изменение настроек сайта PushEngage из ИИ-ассистента охватывает настройку часового пояса, геолокации и сервис-воркера. И если вы настраиваете это для более чем одной учетной записи PushEngage, пост для агентств по управлению несколькими клиентскими учетными записями PushEngage из одного ИИ-ассистента (ссылка выше) углубляется в пример конфигурации в этом руководстве.
Если вы настраиваете это для кого-то менее технически подкованного (основателя, который хочет, чтобы ИИ-ассистент ежедневно управлял PushEngage, не касаясь файла конфигурации самостоятельно), первая неделя основателя без технических знаний с PushEngage MCP — это повествовательная версия той же настройки, написанная для этого читателя.
Настройка сама по себе работает одинаково независимо от вашего плана PushEngage. Каждый план PushEngage, включая бесплатный уровень, поддерживает сервер MCP. Если вы решаете, какой план подходит вам, прежде чем подключать что-либо, на странице цен PushEngage есть информация о текущих уровнях.
