前提条件 \
- 管理したいOneSignalアプリにアクセスできるOneSignalアカウント。
- OneSignalが使用するブラウザベースのサインインであるOAuthを通じて、OneSignalへのアクセスを承認する権限。
- OAuthを使用したHTTP経由のリモートMCPサーバーに対応するAIツール。
接続の詳細 \
すべてのAIツールは同じホスト型エンドポイントに接続します:AIツールをセットアップする \
Cursor \
Cursor MarketplaceからOneSignalをインストールします。1
OneSignalプラグインを開く
Cursor MarketplaceのOneSignalにアクセスするか、CursorのマーケットプレイスでOneSignalを検索します。
2
プラグインをインストールする
Add to Cursorをクリックします。CursorがMCPサーバーを含むOneSignalプラグインをインストールします。
3
OneSignalにサインインする
Settings > MCP & Integrationsを開き、OneSignalの横にあるAuthenticateをクリックします。ブラウザでサインインし、Agree & Allow Accessをクリックします。
4
AgentチャットでOneSignalを使用する
新しいAgentチャットを開始し、OneSignalアプリの一覧表示など、読み取り専用のチェックを実行するよう依頼します。
mcp.jsonにOneSignalを追加します:
Claude Code \
1
OneSignal MCPサーバーを追加する
ターミナルで次のコマンドを実行します:
2
Claude Code内で認証する
claudeを起動し、/mcpと入力してMCPパネルを開きます。onesignalを選択し、Authenticateを選んでブラウザでOneSignalのサインインページを開きます。3
アクセスを承認する
サインインしてAgree & Allow Accessをクリックします。Claude Codeに戻ります。サーバーのステータスがconnectedに変わります。
claude mcp listを実行するか、Claude Code内で/mcpを実行します。
Claudeのカスタムコネクタ \
カスタムコネクタは、ClaudeディレクトリからOneSignalをインストールできない場合にのみ使用してください。リモートMCPサーバーは、ローカルのstdioサーバー専用であるclaude_desktop_config.jsonからは追加できません。
1
カスタムコネクタを追加する
Customize > Connectorsに移動し、Add custom connectorをクリックします。
2
サーバーの詳細を入力する
Nameを
OneSignalに、Remote MCP server URLをhttps://api.onesignal.com/mcp/oauthに設定します。Advanced settingsのOAuth Client IDとOAuth Client Secretは空欄のままにします。3
OneSignalにサインインする
Addをクリックし、ブラウザでOneSignalのサインインを完了してAgree & Allow Accessをクリックします。
Codex CLI \
1
プラグインブラウザを開く
codexを実行し、/pluginsと入力します。2
OneSignalをインストールする
OneSignalを見つけて開き、インストールします。
3
新しいセッションを開始してサインインする
新しいセッションを開始します。Codexから認証を求められたら、ブラウザでOneSignalにサインインし、Agree & Allow Accessをクリックします。
VS CodeのGitHub Copilot \
チームで共有するにはワークスペースの.vscode/mcp.jsonにOneSignalを追加します。ユーザープロファイルにインストールするには、コマンドパレットからMCP: Open User Configurationを実行します:
その他のAIツールとエージェント \
AIツールのリモートMCPサーバー設定にhttps://api.onesignal.com/mcp/oauthを追加します。AIツールが初めてOneSignalのツールを呼び出すと、ブラウザでOneSignalのサインインページが開きます。サインインしてAgree & Allow Accessをクリックします。接続に成功すると、AIツールにOneSignalのツールが一覧表示されます。
接続を確認する \
新しいチャットまたはセッションを開始し、次のメッセージを送信します:onesignal_healthを呼び出します。これはAIツールアクセスが有効になる前でも応答するため、正常な結果が返っても他のツールが機能することの確認にはなりません。
トラブルシューティング \
- 再認証する。 AIツールのMCPまたはコネクタの設定からOneSignalを再接続し、新しいセッションを開始します。
-
サーバーURLを確認する。 URLは正確に
https://api.onesignal.com/mcp/oauthである必要があり、余分なパスや末尾の文字を含めてはいけません。 - OAuthクライアントの欄を空にする。 AIツールにOAuthクライアントIDまたはシークレットの欄がある場合は、空欄のままにします。
- AIツールアクセスを確認する。 ツールが”tool access is not enabled for this application”を返す場合: OneSignalはまだお使いのOneSignalログインに対してAIツールアクセスを有効にしていません。OneSignalサポートにお問い合わせください。
- AIツールを再起動し、新しいセッションを開始します。これで一時的な接続の問題のほとんどが解決します。
ツール \
以下のツールを確認してください。ツールの検出は、OneSignalアプリまたはアカウントでMCPが有効になっているかどうかによって異なります。各操作では、OneSignalアプリの権限もチェックされます。アプリ(2ツール) \
Journeys(9ツール) \
MCPでJourneysを管理する
ツールリクエストの組み立て方、スキーマの取得、Journeyの変更を安全に適用する方法を説明します。
メッセージング(3ツール) \
Live Activityを開始または更新するには、下記のLive Activitiesを参照してください。
ユーザーとサブスクリプション(12ツール) \
テンプレート(4ツール) \
セグメント(4ツール) \
Live Activities(2ツール) \
エクスポート(2ツール) \
カスタムイベント(2ツール) \
メール到達性(4ツール) \
メールのウォームアップ(5ツール) \
分析とユーティリティ(4ツール) \
安全性とガードレール \
- OneSignalは
send_messageを影響の大きいツールとしてマークしているため、ツールアノテーションに従うAIツールは実行前に確認を求める場合があります。 send_messageは送信前にターゲティングを検証します。1回のリクエストで使用できるターゲティング方法は1つだけで、フィルターには上限があります。- OneSignalは、識別子、メールアドレス、電話番号を含む入力を実行前に検証します。
- Journeyの同時実行要件、ライフサイクル制御、結果が不確かな書き込み後の復旧については、Journeyリクエストガイドを参照してください。
- OneSignalは、OneSignalログインごとにAIツールアクセスをオンまたはオフにします。
- MCPサーバーはお客様のデータ(サブスクライバー、メッセージ、エクスポート)を保存しません。
制限と使用量 \
OneSignalの接続は無料です。各アクションは通常のOneSignal API使用制限にカウントされます。AIプロバイダーのプランには別途費用がかかる場合があります。- ツール呼び出しには、ツールの暴走ループを防ぐためのレート制限があります。
- 接続はサインインしたユーザーの権限に従い、そのユーザーが管理できるすべてのOneSignalアプリにアクセスできます。
- ユーティリティツール以外のツールを使用するには、OneSignalがお使いのログインに対してAIツールアクセスを有効にする必要がある場合があります。
FAQ \
REST APIキーは必要ですか? \
いいえ。すべての接続でOneSignal OAuthを使用します。ブラウザでサインインしてアクセスを承認するため、コピー、保存、ローテーションするAPIキーはありません。複数のOneSignalアプリを扱うにはどうすればよいですか? \
1つの接続で、OneSignalアカウントが管理できるすべてのアプリをカバーします。list_appsを呼び出してアプリIDを確認してください。アプリごとに個別の設定は必要ありません。
ローカルのstdioサーバーにしか対応していないAIツールを接続できますか? \
いいえ。OneSignal MCPサーバーはHTTP経由のリモートサーバーです。AIツールはOAuthを使用したリモートMCPサーバーに対応している必要があります。AIツールのアクセスを取り消すにはどうすればよいですか? \
OneSignalで Settings > Account settings > Connected apps に移動し、接続を取り消します。接続を取り消してもチームメイトの接続には影響しません。関連ページ \
ClaudeとChatGPTでOneSignalを使用する
ClaudeまたはChatGPTのディレクトリからOneSignalをインストールします。
MCPでJourneysを管理する
MCPクライアントから下書きの作成、Journeyステップの更新、Journeyの状態管理を行います。
REST APIの概要
OneSignal MCPサーバーが呼び出すエンドポイントのリファレンスです。
メッセージ作成API
send_messageの基盤となるエンドポイントのリファレンスです。AIデータの取り扱い
AI機能と接続されたAIツールにおけるOneSignalのデータの取り扱いについて説明します。