メインコンテンツへスキップ
OneSignal MCPサーバーのURLを追加すると、リモートModel Context Protocol(MCP)サーバーに対応するあらゆるAIツールやエージェントをOneSignalに接続できます。このページでは、Cursor、Claude Code、Codex CLI、VS Code、または独自のエージェントを接続する方法と、ツールの全一覧を紹介します。ClaudeまたはChatGPTのディレクトリからOneSignalをインストールするには、ClaudeとChatGPTでOneSignalを使用するを参照してください。 MCPは、AIアプリを外部システムに接続するためのオープン標準です。OneSignal MCPサーバーは、ユーザーの検索やメッセージの送信などのOneSignalのアクションを、AIツールが呼び出せるツールとして公開します。

前提条件 \

  • 管理したいOneSignalアプリにアクセスできるOneSignalアカウント。
  • OneSignalが使用するブラウザベースのサインインであるOAuthを通じて、OneSignalへのアクセスを承認する権限。
  • OAuthを使用したHTTP経由のリモートMCPサーバーに対応するAIツール。

接続の詳細 \

すべてのAIツールは同じホスト型エンドポイントに接続します:
ブラウザでOneSignalにサインインしてアクセスを承認することで認証します。設定が必要なREST APIキーはありません。OAuthクライアントIDとクライアントシークレットの欄は空欄のままにしてください。OneSignalが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アプリの一覧表示など、読み取り専用のチェックを実行するよう依頼します。
Cursorを手動で設定する場合は、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をクリックします。
Codex IDE拡張機能はプラグインに対応していません。CodexでOneSignalを使用するには、Codex CLIまたはChatGPTデスクトップアプリのPluginsタブからインストールしてください。

VS CodeのGitHub Copilot \

チームで共有するにはワークスペースの.vscode/mcp.jsonにOneSignalを追加します。ユーザープロファイルにインストールするには、コマンドパレットからMCP: Open User Configurationを実行します:
CopilotがOneSignalのツールを初めて必要とするとき、VS Codeが認証を求め、OneSignalのサインインページを開きます。

その他のAIツールとエージェント \

AIツールのリモートMCPサーバー設定にhttps://api.onesignal.com/mcp/oauthを追加します。AIツールが初めてOneSignalのツールを呼び出すと、ブラウザでOneSignalのサインインページが開きます。サインインしてAgree & Allow Accessをクリックします。接続に成功すると、AIツールにOneSignalのツールが一覧表示されます。

接続を確認する \

新しいチャットまたはセッションを開始し、次のメッセージを送信します:
応答にOneSignalアプリが一覧表示されれば、接続は機能しています。“tool access is not enabled for this application”が返された場合は、トラブルシューティングを参照してください。 AIツールがサーバーに到達できるかどうかだけを確認するには、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のデータの取り扱いについて説明します。