> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSignal MCPサーバー

> リモートMCPサーバーに対応するあらゆるAIツールやエージェントを、ホスト型MCPサーバーのURLでOneSignalに接続します。Claude Code、Codex CLI、Cursor、VS Code、カスタムコネクタでのセットアップと、Journeyツールを含むサーバーが対応するすべてのツールを説明します。

OneSignal MCPサーバーのURLを追加すると、リモートModel Context Protocol（MCP）サーバーに対応するあらゆるAIツールやエージェントをOneSignalに接続できます。このページでは、Cursor、Claude Code、Codex CLI、VS Code、または独自のエージェントを接続する方法と、ツールの全一覧を紹介します。ClaudeまたはChatGPTのディレクトリからOneSignalをインストールするには、[ClaudeとChatGPTでOneSignalを使用する](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md)を参照してください。

[MCP](https://modelcontextprotocol.io/docs/getting-started/intro)は、AIアプリを外部システムに接続するためのオープン標準です。OneSignal MCPサーバーは、ユーザーの検索やメッセージの送信などのOneSignalのアクションを、AIツールが呼び出せるツールとして公開します。

## 前提条件 \\

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

## 接続の詳細 \\

すべてのAIツールは同じホスト型エンドポイントに接続します：

```text theme={null}
https://api.onesignal.com/mcp/oauth
```

ブラウザでOneSignalにサインインしてアクセスを承認することで認証します。設定が必要なREST APIキーはありません。OAuthクライアントIDとクライアントシークレットの欄は空欄のままにしてください。OneSignalがAIツールを自動的に登録するため、値を入力すると接続に失敗します。

## AIツールをセットアップする \\

### Cursor \\

Cursor MarketplaceからOneSignalをインストールします。

**1. OneSignalプラグインを開く**

[Cursor MarketplaceのOneSignal](https://cursor.com/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を追加します：

```json theme={null}
{
  "mcpServers": {
    "onesignal": {
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

### Claude Code \\

**1. OneSignal MCPサーバーを追加する**

ターミナルで次のコマンドを実行します：

```bash theme={null}
claude mcp add --transport http onesignal https://api.onesignal.com/mcp/oauth
```

**2. Claude Code内で認証する**

`claude`を起動し、`/mcp`と入力してMCPパネルを開きます。**onesignal**を選択し、**Authenticate**を選んでブラウザでOneSignalのサインインページを開きます。

**3. アクセスを承認する**

サインインして**Agree & Allow Access**をクリックします。Claude Codeに戻ります。サーバーのステータスが**connected**に変わります。

ツール数を確認するには、`claude mcp list`を実行するか、Claude Code内で`/mcp`を実行します。

### Claudeのカスタムコネクタ \\

カスタムコネクタは、[Claudeディレクトリ](https://claude.ai/directory/connectors/onesignal)から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**を実行します：

```json theme={null}
{
  "servers": {
    "onesignal": {
      "type": "http",
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

CopilotがOneSignalのツールを初めて必要とするとき、VS Codeが認証を求め、OneSignalのサインインページを開きます。

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

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

## 接続を確認する \\

新しいチャットまたはセッションを開始し、次のメッセージを送信します：

```text theme={null}
Use the list_apps tool to list the OneSignal apps I can access.
```

応答にOneSignalアプリが一覧表示されれば、接続は機能しています。"tool access is not enabled for this application"が返された場合は、[トラブルシューティング](#troubleshooting)を参照してください。

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ツール） \\

| アクション | ツール |
| - | - |
| 認証済みユーザーがアクセスできるアプリを一覧表示する | `list_apps` |
| アプリで有効になっているメッセージングチャネルを確認する | `get_app_channel_availability` |

### Journeys（9ツール） \\

| アクション | ツール |
| - | - |
| アプリのJourneysを一覧表示する | `list_journeys` |
| Journeyの構造と現在の同時実行キーを表示する | `get_journey` |
| Journey、ステップ、分岐、メッセージの統計を表示する | `get_journey_stats` |
| Journeyまたはステップの作成、複製、更新用のJSON Schemaを取得する | `get_journey_schema` |
| Journeyを下書きとして作成する | `create_journey_draft` |
| Journeyを新しい下書きとして複製する | `duplicate_journey` |
| Journeyのフィールドを更新する、または状態を変更する | `update_journey` |
| Journeyの個々のステップを更新する | `update_journey_node` |
| Journeyを完全に削除する | `delete_journey` |

> [card] [MCPでJourneysを管理する](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> ツールリクエストの組み立て方、スキーマの取得、Journeyの変更を安全に適用する方法を説明します。

### メッセージング（3ツール） \\

| アクション | ツール |
| - | - |
| プッシュ通知、メール、SMSを送信する | `send_message` |
| 最近の通知を一覧表示する | `list_messages` |
| 通知の詳細と配信統計を表示する | `view_message` |

Live Activityを開始または更新するには、下記の[Live Activities](#live-activities-2-tools)を参照してください。

### ユーザーとサブスクリプション（12ツール） \\

| アクション | ツール |
| - | - |
| エイリアスでユーザーを検索する | `view_user` |
| ユーザーのIDエイリアスを取得する | `get_user_identity` |
| サブスクリプションIDからIDを取得する | `get_user_identity_by_subscription` |
| プロパティを指定して新しいユーザーを作成する | `create_user` |
| ユーザープロパティ（タグ、言語など）を更新する | `update_user` |
| IDエイリアスを追加または更新する | `create_or_update_alias` |
| サブスクリプションIDでエイリアスを追加する | `create_alias_by_subscription` |
| プッシュ、メール、SMSのサブスクリプションを追加する | `create_subscription` |
| 既存のサブスクリプションを更新する | `update_subscription` |
| トークンでサブスクリプションを更新する | `update_subscription_by_token` |
| メールアドレスの配信を停止する | `unsubscribe_email` |
| サブスクリプションを別のユーザーに移行する | `transfer_subscription` |

### テンプレート（4ツール） \\

| アクション | ツール |
| - | - |
| テンプレートを一覧表示する | `list_templates` |
| テンプレートを表示する | `get_template` |
| テンプレートを作成する | `create_template` |
| テンプレートを更新する | `update_template` |

### セグメント（4ツール） \\

| アクション | ツール |
| - | - |
| セグメントを一覧表示する | `list_segments` |
| セグメントとフィルターを表示する | `get_segment` |
| セグメントを作成する | `create_segment` |
| セグメントを更新する | `update_segment` |

### Live Activities（2ツール） \\

| アクション | ツール |
| - | - |
| iOSのLive Activityを開始する | `start_live_activity` |
| Live Activityを更新または終了する | `update_live_activity` |

### エクスポート（2ツール） \\

| アクション | ツール |
| - | - |
| サブスクリプションをCSVにエクスポートする | `export_subscriptions_csv` |
| 通知のオーディエンスアクティビティをCSVにエクスポートする | `export_audience_activity_csv` |

### カスタムイベント（2ツール） \\

| アクション | ツール |
| - | - |
| ユーザーのカスタムイベントを作成する | `create_custom_events` |
| インデックス化されたカスタムイベント定義を一覧表示する | `get_custom_events` |

### メール到達性（4ツール） \\

| アクション | ツール |
| - | - |
| メールドメインのDNS検証ステータス（SPF、DKIM、DMARC）を確認する | `get_email_domains` |
| アプリ全体のバウンス率とスパム苦情率を表示する | `get_email_reputation` |
| ドメインの受信プロバイダーごとの到達性指標を取得する | `get_provider_metrics` |
| プロバイダーの到達性指標の時系列を取得する | `get_provider_metrics_timeseries` |

### メールのウォームアップ（5ツール） \\

| アクション | ツール |
| - | - |
| 送信にIPまたはドメインのウォームアップが必要かどうかを確認する | `check_send_volume` |
| セグメントとフィルターから受信者数を見積もる | `estimate_recipient_count` |
| 推奨される段階的なウォームアップスケジュールを取得する | `recommended_warm_up_schedule` |
| 下書きのキャンペーンにウォームアップスケジュールを適用する | `apply_warm_up_schedule` |
| 現在進行中のウォームアップスケジュールを一覧表示する | `get_active_warm_up_schedules` |

### 分析とユーティリティ（4ツール） \\

| アクション | ツール |
| - | - |
| 成果の分析を表示する | `view_outcomes` |
| サーバーの状態を確認する | `onesignal_health` |
| サーバーの設定を表示する | `onesignal_config` |
| 全ツールのリファレンス概要を表示する | `onesignal_reference_overview` |

## 安全性とガードレール \\

* OneSignalは`send_message`を影響の大きいツールとしてマークしているため、ツールアノテーションに従うAIツールは実行前に確認を求める場合があります。
* `send_message`は送信前にターゲティングを検証します。1回のリクエストで使用できるターゲティング方法は1つだけで、フィルターには上限があります。
* OneSignalは、識別子、メールアドレス、電話番号を含む入力を実行前に検証します。
* Journeyの同時実行要件、ライフサイクル制御、結果が不確かな書き込み後の復旧については、[Journeyリクエストガイド](https://documentation.onesignal.com/docs/en/mcp-journeys.md)を参照してください。
* 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](https://dashboard.onesignal.com/settings/connected-apps)** に移動し、接続を取り消します。接続を取り消してもチームメイトの接続には影響しません。

## 関連ページ \\

> [card] [ClaudeとChatGPTでOneSignalを使用する](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md)
>
> ClaudeまたはChatGPTのディレクトリからOneSignalをインストールします。

> [card] [MCPでJourneysを管理する](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> MCPクライアントから下書きの作成、Journeyステップの更新、Journeyの状態管理を行います。

> [card] [REST APIの概要](https://documentation.onesignal.com/reference/rest-api-overview.md)
>
> OneSignal MCPサーバーが呼び出すエンドポイントのリファレンスです。

> [card] [メッセージ作成API](https://documentation.onesignal.com/reference/create-message.md)
>
> `send_message`の基盤となるエンドポイントのリファレンスです。

> [card] [AIデータの取り扱い](https://documentation.onesignal.com/docs/en/ai-data-practices.md)
>
> AI機能と接続されたAIツールにおけるOneSignalのデータの取り扱いについて説明します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.