あなたはすでに、PushEngageダッシュボードよりも多くの時間をClaude Desktop、Claude Code、またはCursorで費やしています。クリック率を確認したり、通知を送信したりする必要があるたびに、実際の作業が行われているウィンドウからタブを切り替えます。PushEngage MCPセットアップは、そのギャップを埋めます。1つのnpxコマンド、ブラウザでのサインインで、PushEngageのツールは、コードの記述、ワークフローのデバッグ、またはチームからの質問への回答に使用しているのと同じチャットセッション内に配置されます。
これは完全なセットアップガイドです。インストール、知っておくべき2つの環境変数、最初のログイン、そして最初にうまくいかない場合に接続が切断される3つの具体的な問題。最後までには、単なる緑色の「接続済み」インジケーターだけでなく、サイトが選択された認証済みセッションが利用できるようになります。
接続後にできるようになること
@pushengage/mcpは10のドメインにわたる27のツールを提供しており、サイトに対して認証されると、それらのすべてがダッシュボードのクリックから1文の距離になります。セットアップが完了した後の例をいくつか示します。
- プッシュ通知をすぐに送信したり、特定の時間にスケジュールしたり、定期的な送信を設定したりできます。要求に応じて、各購読者のローカルタイムゾーンで送信できます。
- 2つのヘッドライン間でA/Bテストを実行し、結果が出たらアシスタントにクリック率を報告させます。
- UIのルールではなく、プレーンな言語の説明からセグメントまたはオーディエンスグループを構築します。
- 分析情報を生涯サマリーまたは日ごとの時系列として取得します。
- ドリップキャンペーン、トリガーキャンペーン、ワークフローを一覧表示して、実際に実行されているものを確認します。
- サイトの設定、サービスワーカーの設定、チャットウィジェットの設定を読み取ります。
これらのいずれも、アシスタントがPushEngageのパスワードを必要とせず、エディターやターミナルを離れる必要もありません。PushEngageは、150か国以上の25,000以上のビジネスオーナーのアカウントベースでこの統合を実行しており、過去30日間で152億件の通知を送信しています。MCPサーバーは、サンドボックス化されたデモではなく、そのボリュームが稼働しているのと同じ本番APIと通信します。
開始する前に：必要なもの
3つのものがあり、おそらくすでに少なくとも2つは持っています：
- PushEngageアカウント - 無料または有料で、少なくとも1つのサイトが追加されていること。MCPサーバーはサイトを作成しません。既存のPushEngageダッシュボードで設定済みのサイトで動作します。
- Node.js 18以降 - アシスタントは
npxを介してサーバーを実行します。これはNodeに付属しています。ターミナルでnode -vで確認してください。 - MCP対応クライアント — Claude Desktop、Claude Code、Cursor、または標準入出力（stdio）でMCPを使用するその他のクライアント。
設定ファイルを編集する前に、はっきりと述べておくべきことがあります。@pushengage/mcpは、stdio経由でローカルマシン上で実行されます。接続先のサーバーやホストされたコネクタURLはありません。クライアントがプロセスを起動し、そのプロセスがあなたの代わりにPushEngageのAPIと通信します。別のツールのセットアップガイドでリモートエンドポイントを貼り付けるように指示されている場合、それはこのものとは異なる種類のMCPサーバーです。
Claude Desktop、Claude Code、Cursorでのサーバー設定
グローバルインストールは不要です。npxは、クライアントが最初に起動したときに@pushengage/mcpをオンデマンドで取得し、正確なコマンドnpx -y @pushengage/mcpを使用します。そのコマンドをクライアントのMCP設定に追加し、クライアントを再起動すると、サーバーがツールリストに表示されます。
各クライアントは設定を異なる場所に保持します。
Claude Desktop
macOSでは~/Library/Application Support/Claude/claude_desktop_config.json（またはお使いのプラットフォームの同等のパス）を編集します。
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Desktopを再起動します。「pushengage」サーバーがツールリストに表示されるはずです。
Cursor
~/.cursor/mcp.jsonを編集します。
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Codeは、Claude DesktopやCursorと同様にstdio経由でMCPを使用するため、MCP設定ファイルを直接編集する場合、同じcommand/argsの形式が機能します。JSONの手動編集を避けたい場合は、Claude Codeは独自のclaude mcp add CLIコマンドを通じてサーバーを受け入れることもできます。これはPushEngageに固有のものではなく、一般的なClaude Codeの動作です。この方法を選択する場合は、正確なフラグ構文についてClaude Code独自のドキュメントを確認してください。
その他のMCPクライアント
クライアントが上記の3つのいずれでもない場合、基本的な要件はどこでも同じです。npx -y @pushengage/mcpをstdioサーバーとして実行するように設定してください。これが、どのクライアントが設定を読み取るかに関係なく、インストール手順全体です。
接続の名前付けとトークンの分離: PE_MCP_CLIENT_NAMEとPE_MCP_CONFIG_PATH
インストール手順以外の設定は不要です。サーバーはデフォルトでPushEngageの本番APIと通信します。あまり一般的ではないセットアップのために、2つの環境変数が存在します。
| 環境変数 | デフォルト | 目的 |
|---|---|---|
PE_MCP_CLIENT_NAME | AIアシスタント | PushEngageの承認画面に、アクセスを要求しているアプリとして表示されるラベル。"Claude Desktop"のような、より具体的なものを表示したい場合は設定してください。 |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | アクセストークンが保存される場所。複数のPushEngageアカウントを並べて実行するには、これを設定します。絶対パスである必要があります — ~展開は使用できません。 |
ほとんどの単一アカウントのセットアップでは、どちらの変数も触れる必要はありません。PE_MCP_CLIENT_NAMEは見た目の便宜のためであり、承認をクリックしているのがあなた自身である場合に、承認画面に「AIアシスタント」よりも読みやすいものが表示されるようにしたい場合に便利です。PE_MCP_CONFIG_PATHは、2番目の別個のトークンファイルが必要になった瞬間に重要になります。これは、次に説明するケースにまさに該当します。
初回実行：ログインとサイトの選択
認証はブラウザベースで行われるため、アシスタントがPushEngageのパスワードを見ることはありません。フローは3つのステップで構成されており、それぞれのステップが実際には何を呼び出しているのかを説明する価値があります。
- アシスタントにログインを依頼します。平易な言葉で言うと、「PushEngageにログインしてください」ということです。これは
pushengage_auth_loginを呼び出し、PushEngageの承認ページへのブラウザタブを開きます。 - 承認をクリックします。ダッシュボードはトークンをPOSTリクエストとしてサーバーに送信します。URL、ブラウザの履歴、またはアクセスログには表示されません。トークンは
0600の権限でローカルに保存され、ユーザーのみが読み取ることができます。 - アシスタントにサイトを表示するように依頼し、次に1つ選択します。「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の認証ステータスは？」と尋ねるだけで十分です）。他のことを試す前に、認証されたセッションと選択されたサイトの両方が報告されていることを確認してください。これは、クライアントが最初にサーバーを接続済みとして表示した瞬間ではなく、セットアップの実際の完了ラインです。
トラブルシューティング（原因別）
ほとんどの接続問題は、3つの特定原因のいずれかに起因します。この順序で診断してください。
サーバーがまったく接続されず、クライアントに「接続が閉じられました」と表示される場合。これはほとんどの場合PATHの問題であり、サーバーのバグではありません。Claude Desktop、Cursorなどのクライアントは、ターミナルからではなく、ドックや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 を呼び出し、返されたサイトのいずれかを使用するように要求してから、サイトスコープのツールを再度試してください。
エラーではありませんが、知っておくと便利なもう1つのケース：ブラウザが自動的に開かない場合、ヘッドレスまたはリモートセッション（SSH、コンテナ）にいる可能性が高いです。認証URLは、サーバーを実行しているターミナルに出力されます。手動で開いてください。
複数のPushEngageアカウントまたはクライアントを実行する
複数のブランドに対してPushEngageを管理している場合、または複数のクライアントアカウントに対してMCPを実行しているエージェンシーの場合は、前のPE_MCP_CONFIG_PATHが解決策となります。サーバーを2つの異なる名前で登録し、それぞれに独自のパスを設定して、トークンが衝突しないようにします。
{
"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アカウントを認証します。各サーバーエントリは独自のトークンファイルを保持するため、クライアントアカウントの切り替えは、毎回再ログインするのではなく、呼び出すツール名によって決まります。これが実際のユースケースである場合は、このシリーズで1つのAIアシスタントから複数のPushEngageクライアントアカウントを実行する方法を完全に説明しています。
接続後の操作
認証が完了し、サイトが選択されると、27のツールは、数だけでなく、名前で知っておくと便利ないくつかの実用的なグループに分類されます。
キャンペーンの日常的な運用については、ダッシュボードの代わりにAIアシスタントからプッシュ通知を送信およびスケジュールする方法、およびプッシュ通知のA/Bテストを行い、AIにクリック率で勝者を選ばせる方法を説明しています。リスト構築については、プレーンな英語でサブスクライバーセグメントを構築するための完全なガイドがあります。
測定については、AIアシスタント経由でプッシュ通知分析を読むで、ライフタイムサマリーと日ごとの時系列データを説明しています。これらは、A/Bテストの結果やキャンペーン送信を単に実行するだけでなく、報告する価値のあるものにするのと同じ分析ツールです。また、このシリーズでは、実際にアクティブなものを確認するためのドリップキャンペーンとワークフローの監査、およびサイト上にWhatsAppなどのチャネルを表示するチャットウィジェットの管理についても説明しています。
サイトレベルの作業については、AIアシスタントからPushEngageサイト設定を変更するで、タイムゾーン、ジオロケーション、およびサービスワーカーの構成について説明しています。また、複数のPushEngageアカウントに対してこれを設定している場合は、1つのAIアシスタントから複数のPushEngageクライアントアカウントを実行することに特化したエージェンシー向けの投稿（上記リンク）で、このガイドの構成例よりも詳しく説明しています。
技術に詳しくない人（設定ファイルに触れることなく、AIアシスタントにPushEngageの日常業務を任せたい創業者など）のためにこれを設定している場合は、技術に詳しくない創業者のPushEngage MCPでの最初の1週間は、その読者向けに書かれた、この同じ設定の物語版です。
PushEngageのセットアップは、どのプランをご利用の場合でも同じように機能します。無料プランを含むすべてのPushEngageプランでMCPサーバーをサポートしています。何かを接続する前にどのプランが適しているか判断している場合は、PushEngageの料金ページで現在のティアを確認できます。
