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

# Notifly Remote MCP サーバー

> Claude Code や Codex などの MCP クライアントに Notifly Remote MCP を接続する方法を説明します。

Notifly Remote MCP は、Claude Code や Codex などのクライアントがインターネット経由で呼び出すリモート MCP エンドポイントです。ローカルサーバーのインストールは不要です。クライアントに次の URL を登録します。

```text theme={null}
https://api.notifly.tech/mcp
```

> [!NOTE]
>
> このガイドでは、提供中の Remote MCP サービスを扱います。クライアントに URL を登録してから、Notifly アカウントでログインします。

> [!NOTE]
>
> Notifly には 3 つの AI ツールがあります。[AIアシスタント](https://docs.notifly.tech/ja/user-guide/analytics/ai-agent.md)はコンソール内で使用し、Pro プラン以上が必要です。[Remote MCP](https://docs.notifly.tech/ja/devtools/notifly-remote-mcp.md) は ChatGPT や Claude などの外部 AI クライアントを接続します。[Agent Skills](https://docs.notifly.tech/ja/devtools/notifly-agent-skills.md) は AI コーディングエージェントによる SDK 連携を支援します。AIアシスタントと Remote MCP は、データの参照や下書きの作成、編集に対応しています。キャンペーンとユーザージャーニーのツールは、メッセージの配信、有効化、キャンペーンやジャーニーの削除を行いません。一方、Remote MCP にはセグメントの変更や CSV アップロードの書き込みツールがあり、保存済みセグメントの削除も含まれます。使用前に各ツールの権限を確認してください。Agent Skills はプロジェクトの SDK 連携コードを変更する開発ツールです。生成されたコードと設定を確認してください。

## 仕組み

Remote MCP は、クライアントと Notifly API を標準インターフェースで接続します。クライアントはツール一覧を取得し、リクエストに必要なツールを呼び出します。アクセスできるプロジェクトは、ログインした Notifly アカウントの権限に従います。

| 項目 | 説明 |
| - | - |
| 接続 URL | `https://api.notifly.tech/mcp` |
| 接続方式 | Streamable HTTP による Remote MCP |
| 認証 | Notifly アカウントでの OAuth ログイン |
| アクセス範囲 | ログインしたアカウントがアクセスできる製品とプロジェクト |
| 書き込み操作 | キャンペーンとユーザージャーニーの下書きの作成、置換、セグメントの変更、CSV アップロード |

認証が必要になると、クライアントが Notifly のログイン画面を開きます。ログイン後は、付与された権限でプロジェクト、キャンペーン、ユーザージャーニー、ユーザーの状態を参照します。

## Claude Code に接続する

Claude Code にリモート HTTP MCP サーバーを追加します。

```bash theme={null}
claude mcp add --transport http notifly https://api.notifly.tech/mcp
claude mcp list
claude mcp get notifly
```

認証前は、`claude mcp list` や `claude mcp get notifly` に `Needs authentication` と表示されることがあります。Claude Code のセッションで Notifly ツールが必要な質問をするか、MCP 認証を開始すると、ブラウザーで OAuth 認証が始まります。Notifly アカウントでログインすると、Claude Code は発行された MCP トークンで `/mcp` を呼び出します。

```text theme={null}
自分の Notifly プロジェクト一覧を表示してください。
```

正常に接続されると、Claude Code はまず `list_products` または `list_projects` を呼び出し、アクセス可能な製品とプロジェクトを確認します。

> [!NOTE]
>
> Claude Code のバージョンによっては、`.mcp.json` を直接編集する方法もあります。この場合も、ローカルの `command` ではなくリモートの `url` を使用します。`.mcp.json` で追加したサーバーは、最初に `Pending approval` と表示されることがあります。Claude Code のセッションで承認してから使用してください。

```json theme={null}
{
  "mcpServers": {
    "notifly": {
      "type": "http",
      "url": "https://api.notifly.tech/mcp"
    }
  }
}
```

## Codex に接続する

Codex CLI では、`--url` を指定して Streamable HTTP MCP サーバーを追加します。

```bash theme={null}
codex mcp add notifly --url https://api.notifly.tech/mcp
```

最近の Codex CLI では、`codex mcp add` の直後にブラウザー認証用の URL が表示される場合があります。ブラウザーで Notifly アカウントにログインすると、Codex が接続設定を保存します。

`codex mcp add` が認証なしで終了した場合や、トークンを再発行する場合は、次のコマンドで OAuth ログインを実行します。

```bash theme={null}
codex mcp login notifly --scopes mcp:read,mcp:tools
```

設定ファイルを直接管理する場合は、`~/.codex/config.toml` に次の内容を追加します。

```toml theme={null}
[mcp_servers.notifly]
url = "https://api.notifly.tech/mcp"
```

設定を確認します。

```bash theme={null}
codex mcp get notifly
codex mcp list
```

認証済みの接続では、`codex mcp list` の `Auth` 列に `OAuth` と表示されます。

## 機能

Notifly MCP の主な機能は、次の 6 つに分類できます。

| 分類 | ツール例 | 内容 |
| - | - | - |
| 製品とプロジェクトの検索 | `list_products` など | ログインしたアカウントがアクセスできる製品とプロジェクトを確認します。 |
| プロジェクトカタログ | イベント、ユーザー属性、チャネルの参照ツール | イベント名、ユーザー属性、チャネル設定を確認します。 |
| キャンペーン | キャンペーンの参照、統計、下書きツール | 一覧、詳細、成果を参照し、キャンペーンの下書きを作成または置換します。 |
| ユーザー診断 | `identify_user` など | ユーザーの識別子、チャネルの状態、イベント、配信対象条件、配信履歴を確認します。 |
| ユーザージャーニー | ジャーニーの参照、下書きツール | 一覧、詳細、成果を参照し、無効状態の下書きを作成または置換します。 |
| ドキュメント検索 | 公式ドキュメント検索ツール | Notifly の公式ドキュメントを検索し、必要なページを読み取ります。 |

> [!WARNING]
>
> `create_campaign` と `replace_campaign` は、キャンペーンの下書きだけを作成または置換します。`create_user_journey` と `replace_user_journey` は、無効状態のユーザージャーニーの下書きだけを作成または全体置換します。ジャーニーの置換時には、既存ノードの保存済み `id` を維持します。新規ノードにはリクエスト内だけで有効な `ref` を使用し、サーバーが ID を生成します。これらのキャンペーンとジャーニーのツールは、有効化、配信、削除を行いません。Remote MCP の他のツールでは、セグメントの変更、CSV アップロード、保存済みセグメントの削除が可能です。組織のポリシーで求められる場合は、書き込みツールを承認が必要な設定にしてください。

### ユーザージャーニーを置換する

既存のジャーニーを変更するときは、次の順序を守ります。

`describe_user_journey_payload(operation: "replace")` → `describe_user_journey_node_payload(operation: "replace", ...)` を選択したノードのスキーマごとに実行 → `get_user_journey` → `replace_user_journey`

`replace_user_journey` はジャーニー全体を置換します。最新の `get_user_journey` の結果を基にリクエストを作成してください。既存ノードには保存済みの `id` を指定し、新規ノードにだけリクエスト内で有効な `ref` を指定します。既存ノードへの接続には `*_node_id`、新規ノードへの接続には `*_node_ref` を使用します。`ref` は保存されません。置換できるのは無効状態の下書きだけです。有効なジャーニーは置換できません。

## プロンプトと応答の例

以下は応答形式を示す例です。実際のアカウントデータではありません。

### アクセス可能なプロジェクトを探す

```text theme={null}
自分がアクセスできる Notifly の製品とプロジェクトを表示してください。
```

```text theme={null}
アクセス可能な製品が 1 件、プロジェクトが 2 件見つかりました。

- Product A
  - Project: commerce-prod (`project_id: ...`)
  - Project: commerce-stage (`project_id: ...`)

続けてキャンペーン、イベントカタログ、
チャネル設定を確認できます。
```

### キャンペーンの成果をまとめる

```text theme={null}
直近 5 件のアプリプッシュキャンペーンについて、配信、クリック、コンバージョンの成果をまとめてください。
```

```text theme={null}
直近 5 件のキャンペーンを取得し、
それぞれの統計ツールを呼び出しました。

- 6 月のリテンション通知: active, 配信 12,340, クリック 820, コンバージョン 113
- カートリマインダー: draft, 配信統計はまだありません

下書きのキャンペーンには配信統計がないため、成果の集計から除外しました。
```

### 特定ユーザーに届かなかった原因を確認する

```text theme={null}
user@example.com に昨日キャンペーン A が届かなかった理由を確認してください。
```

```text theme={null}
次の順序で確認しました。

1. `identify_user` でメールアドレスを canonical Notifly user ID に変換しました。
2. `get_campaign_user_eligibility` でキャンペーンの配信対象条件を確認しました。
3. `list_campaign_user_deliveries` で実際の配信記録を確認しました。

結論: ユーザーはキャンペーンのセグメント条件を満たしていましたが、
アプリプッシュチャネルが opt-out のため、配信対象から除外されました。
```

### キャンペーンの下書きを作成する

```text theme={null}
会員登録から 3 日が経過したユーザー向けに、アプリプッシュのキャンペーン下書きを作成してください。まだ配信しないでください。
```

```text theme={null}
キャンペーンの下書きを作成しました。

- キャンペーン ID: `...`
- 状態: `draft`
- チャネル: app push
- 配信: 未実行

Notifly コンソールで下書きを開き、
メッセージと条件を確認してから有効化してください。
```

### 無効状態のユーザージャーニーを変更する

```text theme={null}
既存の無効状態のユーザージャーニーに待機ノードを 1 つ追加してください。有効化や配信はしないでください。
```

```text theme={null}
次の順序で処理します。

1. `describe_user_journey_payload(operation: "replace")` で全体置換のスキーマを確認します。
2. `describe_user_journey_node_payload(operation: "replace", ...)` で追加または維持する各ノードのスキーマを確認します。
3. `get_user_journey` で最新のジャーニー全体と既存ノード ID を取得します。
4. 既存ノードの `id` を維持し、新しい待機ノードをリクエスト内の `ref` で接続して、`replace_user_journey` を呼び出します。

無効状態の下書きだけを全体置換しました。既存ノード ID は維持され、新規ノード ID はサーバーが生成しました。
```

## トラブルシューティング

| 症状 | 確認事項 |
| - | - |
| ログイン画面が開かない | クライアントのバージョンが Remote MCP と OAuth ログインに対応しているか確認します。 |
| 認証エラーが続く | Notifly に再ログインするか、クライアントの Notifly 接続を削除して再接続します。 |
| プロジェクトが表示されない | ログインした Notifly アカウントに対象の製品とプロジェクトへのアクセス権があるか確認します。 |
| 書き込みツールの呼び出し前に承認を求められる | 正常な動作です。キャンペーンやユーザージャーニーの下書きの作成、置換には、クライアントが別途承認を求める場合があります。他の書き込みツールについても、承認前に操作の影響を確認してください。 |


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