> ## 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.

# Claude に Notifly コネクターを接続する

> Claude のカスタムコネクターに Notifly Remote MCP を追加し、OAuth で接続する方法を説明します。

Claude のコネクターは、Claude ウェブアプリにリモート MCP サーバーを接続する機能です。Notifly コネクターを追加すると、Claude の会話の中でプロジェクト、キャンペーン、ユーザージャーニー、ユーザーの状態を参照し、下書きを作成できます。

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

> [!NOTE]
>
> カスタムコネクターには Notifly Remote MCP の URL を登録します。OAuth クライアント ID やシークレットを手動で登録する必要はありません。

## 接続する

1. Claude で **プラグイン** を開きます。以前の画面では **Customize → Connectors** を開きます。
2. **Add → Add custom connector** を選択します。以前の画面では **+ Add** と表示されます。
3. 次の値を入力します。

| 入力項目 | 値 |
| - | - |
| 名前 | `Notifly` |
| MCP server URL | `https://api.notifly.tech/mcp` |

**OAuth クライアント ID** と **OAuth クライアントシークレット** が表示された場合は、両方を空欄のままにします。

4. **Continue** が表示された場合は、検出された認証設定を確認して進みます。OAuth ログインを使用し、OAuth クライアントの選択肢が表示された場合は **Register automatically** を選択します。
5. **Add** が表示されるバージョンでは、このボタンを選択します。
6. まだログインが始まっていない場合は、コネクター一覧で **Notifly** を選択し、**Connect** を選択します。
7. ログイン画面が開いたら、Notifly アカウントでログインします。
8. Claude に戻り、Notifly の **概要** に **接続済み** と表示されていることを確認します。**権限** を開くと、ツールの権限を確認できます。以前の画面では **Disconnect** とツール一覧が一緒に表示されます。

組織で管理している場合は、権限を持つオーナーや管理者がコネクターを利用可能にしてから、各メンバーが自分のアカウントを接続します。現在のロール要件は、[Claude のカスタムコネクター設定ガイド](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)を参照してください。

![Claude で Notifly カスタムコネクターの接続が完了した画面](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/devtools/claude-notifly-connector-connected.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=a08db5994deb6ea749e777ef77e44741)

## OAuth 認証の流れ

Claude は `https://api.notifly.tech/mcp` に接続するとき、Notifly の OAuth ディスカバリーメタデータを確認します。Notifly は動的クライアント登録と PKCE に対応しているため、OAuth クライアント ID やシークレットを手動で入力する必要はありません。

通常は次の順序で認証します。

1. Claude が `/mcp` にアクセスします。
2. Notifly が Claude にログインが必要であることを通知します。
3. Claude がブラウザーで Notifly のログイン画面を開きます。
4. Notifly アカウントでログインします。
5. Claude が接続したアカウントの権限でツール一覧を取得し、必要なツールを呼び出します。

## ツールの権限

Claude は Notifly のツールを **Read-only tools** と **Write/delete tools** に分けて表示します。接続時に検出されたツール一覧を確認してください。サービスの更新に伴い、利用可能なツールは変わる場合があります。

| 権限グループ | ツール例 | 操作内容 |
| - | - | - |
| Read-only tools | 参照、検索ツール | プロジェクト、キャンペーン、ユーザー、ドキュメントのデータを参照します。 |
| Write/delete tools | 下書き、セグメント、CSV の書き込みツール | キャンペーンや無効状態のユーザージャーニーの下書きの作成、置換、保存済みセグメントの変更、CSV アップロードを行います。セグメントの削除ツールも含まれます。 |

Claude で、各ツールグループのポリシーを **Ask for approval** などに設定します。組織で機密性の高いプロジェクトを扱う場合は、書き込みツールを承認が必要な設定にしてください。

> [!WARNING]
>
> Claude の **Write/delete tools** には、影響の異なる操作が含まれます。Notifly のキャンペーンツールは下書きだけを作成または置換し、ユーザージャーニーのツールは編集可能な無効状態の下書きだけを作成または置換します。これらのツールは、配信、有効化、キャンペーンやジャーニーの削除を行いません。他の MCP ツールでは、保存済みセグメントの変更や削除、CSV アップロードが可能です。書き込みを承認する前に、対象のツールと入力内容を確認してください。

## 機能

| 分類 | ツール例 | 説明 |
| - | - | - |
| 製品とプロジェクト | `list_products` など | アカウントの権限内で製品とプロジェクトを探します。 |
| キャンペーン | 参照、統計ツール | キャンペーン一覧、詳細、統計、バリアントを参照します。 |
| キャンペーンの下書き | `create_campaign` など | Notifly コンソールで開けるキャンペーンの下書きを作成または置換します。 |
| ユーザー診断 | `identify_user` など | 特定ユーザーのチャネル状態、イベント、配信対象条件、配信記録を確認します。 |
| ユーザージャーニー | ジャーニー参照ツール | 一覧、詳細、成果、ユーザーセッションを参照します。 |
| ユーザージャーニーの下書き | ジャーニー下書きツール | 無効状態のユーザージャーニーの下書きを作成または置換します。 |
| ドキュメント | 公式ドキュメント検索ツール | 公式ドキュメントを検索し、ページの内容を読み取ります。 |

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

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

### プロジェクトとキャンペーンを探す

```text theme={null}
Notifly コネクターで自分がアクセスできるプロジェクトを探し、
最初のプロジェクトの最近のキャンペーンを表示してください。
```

```text theme={null}
アクセス可能なプロジェクトを確認しました。

- commerce-prod
- onboarding-demo

commerce-prod の最近のキャンペーン:

- 6 月のリテンション通知: active, app_push, scheduled
- カートリマインダー: draft, app_push, event_based
```

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

```text theme={null}
user@example.com にカートリマインダーのキャンペーンが届かなかった原因を確認してください。
推測と実際の照会結果を分けて説明してください。
```

```text theme={null}
実際の照会結果:

1. ユーザーの識別: `identify_user` で canonical Notifly user ID を取得しました。
2. チャネル状態: アプリプッシュが opt-out でした。
3. 配信対象条件: セグメント条件は満たしていましたが、チャネルの配信可能条件を満たしていませんでした。
4. 配信記録: このキャンペーンとユーザーの配信記録はありません。

結論: セグメントの不一致ではなく、アプリプッシュの受信同意に問題があると判断できます。
トークンの状態をまだ照会していない場合は、別途確認が必要です。
```

### 無効状態のユーザージャーニーの下書きを作成する

```text theme={null}
会員登録イベントの後に 1 日待ってから
アプリプッシュを配信するユーザージャーニーの下書きを作成してください。
有効化せず、作成した下書きの構造を説明してください。
```

```text theme={null}
無効状態のユーザージャーニーの下書きを作成しました。

- 状態: inactive draft
- entry: 会員登録イベントを基に開始
- nodes:
  1. delay node: 1 日待機
  2. message node: アプリプッシュメッセージ
- 有効化 / 配信: 未実行

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

## 接続を解除する、再接続する

* 接続を解除するには、Notifly コネクターを開き、接続の操作項目で **Disconnect** を選択します。以前の画面では **Customize → Connectors → Notifly → Disconnect** を選択します。
* アカウントを切り替えるには、**Disconnect** の後に再度 **Connect** を選択します。
* ツールが表示されない場合や OAuth 認証に失敗する場合は、カスタムコネクターを削除し、同じ URL で再追加します。

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

| 症状 | 確認事項 |
| - | - |
| **Add** の後に **Connect** が表示されない | 名前とリモート MCP サーバー URL を確認します。URL は `https://api.notifly.tech/mcp` です。設定中にログイン済みの場合は、**Disconnect** が表示されているか確認します。 |
| OAuth クライアント ID やシークレットが必須に見える | Notifly は動的クライアント登録に対応しています。両方を空欄にするか、OAuth クライアントの選択肢がある場合は **Register automatically** を選択します。 |
| ログイン後に Claude に戻らない | ブラウザーがポップアップやリダイレクトをブロックしていないか確認し、再度 **Connect** を選択します。 |
| ツールを呼び出すたびに承認を求められる | Claude の **Tool permissions** ポリシーによる動作です。必要に応じて **Read-only tools** のポリシーだけを調整してください。 |
| プロジェクトが取得されない | 接続した Notifly アカウントの製品とプロジェクトへのアクセス権を確認します。 |


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