PushEngage

@pushengage/mcp

あらゆる AI アシスタントから、自然な言葉でPushEngageアカウントを管理できます。

PushEngageは、ウェブプッシュ通知、モバイルアプリのプッシュ通知、WhatsApp、サイト内チャットウィジェットに対応したプッシュ通知プラットフォームです。購読者の増加や、カート放棄、値下げ、再入荷などによる収益の回復に活用されています。

このパッケージは、Model Context Protocol（MCP）サーバーです。Claude Desktop、Claude Code、CursorなどのMCP対応アシスタントをPushEngageアカウントに接続することで、チャットから離れることなく、通知の送信やスケジュール設定、A/B テストの実施、オーディエンスの作成、分析データの確認、サイト設定の管理を依頼できます。

ブラウザーで一度ログインすれば、アシスタントが選択したPushEngageサイトに対して、あなたに代わって操作します。

目次

• できること
• 必要条件
• インストール
• 初回実行：ログイン
• ツール
• 設定
• セキュリティとトークンの保存
• トラブルシューティング
• ライセンス

できること

接続したら、希望する操作を伝えるだけです。たとえば、次のように依頼できます。

送信とスケジュール設定

• 「タイトルを『セールは今夜終了』、メッセージを『最後のチャンス、50％オフ』にして、https://example.com/sale にリンクする通知を送信してください。」
• 「各購読者の現地時間の午前9時に送信するようスケジュールしてください。」
• 「月末まで、毎週月曜日と木曜日の午前8時に定期ダイジェストを設定してください。」
• 「2種類の見出しでA/B テストを実施し、クリック率が高いほうを自動的に配信してください。」

適切なユーザーをターゲットにする

• 「/pricing の訪問者向けのセグメントを作成してください。」
• 「米国のゴールドプランの顧客を対象にしたオーディエンスを作成して、その人たちだけに送信してください。」

パフォーマンスを把握する

• 「購読者は何人いますか？過去30日間のクリック率も教えてください。」
• 「アクティブなドリップキャンペーンを、送信数、閲覧数、クリック数とともに一覧表示してください。」

サイトを設定する

• 「通知のデフォルトの有効期限を7日に設定してください。」
• 「サイトのタイムゾーンをAsia/Kolkataに変更して、位置情報を有効にしてください。」

必要条件

• PushEngageアカウント（無料または有料）と、少なくとも1つのサイト。
• Node.js 18以降（アシスタントはnpx経由でサーバーを実行します）。
• MCP対応クライアント（Claude Desktop、Claude Code、Cursorなど）。

インストール

クライアントのMCP設定にサーバーを追加します。グローバルインストールは不要です。npxが必要に応じて取得します。

Claude Desktop（ワンクリックバンドル）

Claude Desktopでは、MCP Bundleを使うのが最も簡単です。

1. GitHubリリースページから最新のpushengage-mcp-<version>.mcpbファイルをダウンロードします。
2. Claude Desktopでファイルを開き（ダブルクリックするか、ウィンドウにドラッグします）、インストールをクリックします。

すべてがバンドルされているため、JSONの編集は不要です。インストールダイアログでは、PushEngageの認可画面に表示するラベルと、カスタムのトークンファイルパス（複数アカウントを実行する場合）を任意で設定できます。

Claude Desktop（手動設定）

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）またはお使いのプラットフォームに対応するファイルを編集します。

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Claude Desktopを再起動します。「pushengage」サーバーがツール一覧に表示されます。

Cursor

~/.cursor/mcp.jsonを編集します。

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

その他のMCPクライアント

stdio経由でMCPを使用するクライアントであれば、どれでも利用できます。コマンドnpx -y @pushengage/mcpを実行するように設定してください。

初回実行：ログイン

認証はブラウザー経由で行われるため、認証情報がアシスタントに渡ることはありません。

1. **「PushEngageにログインして」**と依頼します。サーバーがPushEngageの認証ページをブラウザーのタブで開きます。
2. **「Authorize」**をクリックします。タブに成功の確認が表示され、アクセストークンがローカルに保存されます。
3. **「PushEngageのサイトを表示して」と依頼し、続けて「サイト12345を使って」**と依頼して、作業するサイトを選びます。この選択は再起動後も保持されます。

サイト単位のツールは、明示的なsite_idを渡さない限り、現在のサイトに対して動作します。トークンの有効期限が切れると、AUTH_EXPIREDメッセージが表示されます。その場合は、もう一度ログインを依頼してください。

ツール

サイト単位のツールはすべて、デフォルトで現在のサイトを使用します。

認証とサイト

ツール	用途
pushengage_auth_login	ブラウザーでPushEngageを開き、認証に成功するとトークンを保存します。
pushengage_auth_status	認証済みかどうかと、選択中のサイトを表示します。
pushengage_auth_logout	ローカルに保存されたトークンを削除します。
pushengage_list_sites	アクセス可能なPushEngageのサイトを一覧表示します。
pushengage_select_site	他のツールで使用する現在のサイトを設定します。

サイト設定

ツール	用途
pushengage_get_site_details / pushengage_update_site_details	サイト名、URL、タイムゾーン、ジオロケーション、および「Powered By PushEngage」のブランディング切り替えを扱います。
pushengage_get_campaign_defaults / pushengage_update_campaign_defaults	UTMパラメーター、フォールバック通知、フォールバック属性、デフォルトの通知有効期限を扱います。更新内容は現在の値にマージされるため、一部の項目だけを編集できます。
pushengage_get_service_worker_settings / pushengage_update_service_worker_settings	サービスワーカーの登録、サブフォルダーのサポート、ワーカーファイルのパスを扱います。

オーディエンス

ツール	用途
pushengage_list_segments / pushengage_create_segment	URLルールに基づく購読者セグメントを扱います。
pushengage_list_audience_groups / pushengage_create_audience_group	保存済みのターゲティンググループ（デバイス、国、セグメント、エンゲージメント、日付、属性）を扱います。送信ツールのaudience_groupsで参照されます。
pushengage_list_attributes / pushengage_create_attribute	オーディエンスグループのルールで使用する、カスタム購読者属性キーを扱います（サイトあたり最大50個）。

キャンペーンと自動化

ツール	用途
pushengage_list_drip_campaigns	ドリップ自動返信を扱います。ステータスで絞り込み、キャンペーンごとの統計にはinclude_analyticsを設定します。
pushengage_list_triggered_campaigns	トリガー型キャンペーン（カート放棄／閲覧放棄、価格低下など）を扱います。ステータスで絞り込み、アナリティクスは任意で指定できます。
pushengage_list_rss_campaigns	RSS自動プッシュキャンペーンを扱います。ステータスで絞り込みます。
pushengage_list_workflows	ワークフロー自動化を扱います。ステータスで絞り込み、流入数／アクティブ数／完了数／失敗数と目標の統計にはinclude_analyticsを設定します。

チャットウィジェット

ツール	用途
pushengage_list_chat_widgets	WhatsApp、Messenger、その他のチャネルを表示するサイト上のウィジェットを扱います。ステータス、チャネル、デバイス、営業時間の制限、ターゲティングが表示されます。

アナリティクス

ツール	用途
pushengage_get_analytics_summary	累計値（購読者数、送信通知数、閲覧数、クリック数、目標数／目標値）を表示します。
pushengage_get_analytics_timeseries	日／週／月単位で集計した購読者数、送信数、閲覧数、クリック数、CTR、配信停止数を、指定した日付範囲で表示します。

通知の送信

ツール	目的
pushengage_list_notifications	送信済み、予約済み、下書きの通知を新しい順に一覧表示します。ステータス（ダッシュボードのタブと同じ意味）、送信日の範囲、またはタグで絞り込みます。A/B テストとタイムゾーン別送信の集計統計を表示するには、include_analytics を設定します。
pushengage_send_notification	通知を送信または予約します。1 つのツールで 3 種類の配信方法に対応します。今すぐ送信、1 回限りの予約（購読者ごとのタイムゾーン指定も可能）、定期配信です。audience_groups によるターゲティングは任意です。指定しない場合は、すべての購読者が対象になります。
pushengage_send_ab_notification	2 つのバリアントを使った A/B 通知です。intelligent_ab_test を指定すると、各バリアントをサンプリングし、一定時間後にクリック率に基づいて勝者を選び、残りのユーザーに配信します。

設定

設定は不要です。サーバーは、初期状態で PushEngage の本番 API に接続します。あまり一般的でない構成では、次の環境変数を使用できます。

環境変数	デフォルト	目的
PE_MCP_CLIENT_NAME	AI assistant	認証画面に、リクエスト元のアプリとして表示するラベルです。特定のラベルを表示したい場合（例："Claude Desktop"）は設定してください。
PE_MCP_CONFIG_PATH	~/.pushengage/mcp.json	トークンの保存先です。複数の PushEngage アカウントを並行して使用する場合は、これを設定してください（下記を参照）。絶対パスを指定する必要があります。指定されたパスがそのまま使用され、~ は展開されません。

複数の PushEngage アカウントを並行して使用する

サーバーを異なる 2 つの名前で登録し、それぞれに別の 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 のパスワードを見ることはありません。
• ダッシュボードはトークンを POST リクエストでサーバーに送信するため、URL、ブラウザーの履歴、アクセスログには表示されません。
• トークンは ~/.pushengage/mcp.json に 0600 の権限で保存されます（読み取り可能なのは自分だけです）。有効期限は PushEngage によって設定され、pushengage_auth_status で確認できます。
• トークンを取り消すには、pushengage_auth_logout を実行するか、PushEngage の「設定」→「セキュリティ」で全セッションからログアウトしてください。

トラブルシューティング

サーバーにまったく接続できない（「Connection closed」）

ターミナルに直接入力すると npx -y @pushengage/mcp が正常に動作するのに、クライアント（Claude Desktop、Cursor など）ではサーバーが切断済みと表示されたり、MCP error -32000: Connection closed のようなログが出たりする場合、ほとんどの場合、原因はサーバーのバグではなく PATH の問題です。

これらのクライアントはターミナルからではなく、Dock や Finder から起動されるため、シェルの起動ファイル（.zshrc、.zprofile など）を読み込みません。Node をバージョン管理ツール（nvm、fnm、volta など）経由でインストールしている場合、これらのツールは起動ファイル内でのみ node／npx を PATH に追加します。そのため、クライアントは npx を見つけられず、サーバープロセスも起動しません。その結果、「コマンドが見つかりません」という明確なエラーではなく、一般的な接続エラーが表示されます。

解決方法： クライアントの設定で npx の絶対パスを指定します（これにより、npx を見つける際の PATH 検索を回避できます）。また、npx が再実行時に #!/usr/bin/env node のシバンから node を見つけられるよう、同じフォルダーを env 内の PATH にも渡してください。ターミナルで 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 配下の場合、Node はバージョン管理ツール経由でインストールされていないため、今回の問題ではない可能性があります。その場合は、クライアント独自の MCP ログで実際のエラーを確認してください。

その他のエラー

• AUTH_EXPIRED — トークンの有効期限が切れています。アシスタントに再度ログインするよう依頼してください。
• NO_SITE_SELECTED — pushengage_list_sites を呼び出し、サイトに紐づくツールを使う前に、返されたサイトのいずれかを使うよう依頼してください。
• ブラウザーが開かない — ヘッドレス環境やリモート環境（例：SSH）で発生します。認証 URL はサーバーを実行しているターミナルに表示されるため、手動で開いてください。
• その他 — サーバーから返されるすべてのエラーは [CODE] タグと平易な説明で始まります。サポートが必要な場合は、その内容をサポートに共有してください。

ライセンス

MIT