> For the complete documentation index, see [llms.txt](https://docs.wicle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wicle.io/ai/mcp.md).

# MCPで外部AIサービスと連携する

外部AIからWicleのデータを分析し、検索条件や通知などの設定を操作するためのMCPの接続方法、権限、データの取り扱い、レート制限を説明します。

普段使っているAIサービスから、Wicleのデータを分析したり、設定を参照・変更したりできます。MCP（Model Context Protocol）は、AIサービスと外部のツールやデータをつなぐための仕組みです。接続先には、MCPに対応したAIサービスを使用します。

たとえば、「先月と今月でCVが減った流入元を調べて」「この条件に合うユーザーのセグメントを作成して」と依頼できます。Wicle内で質問したい場合は、[チャットエージェント](/ai/agent.md)を利用します。

## 接続方法を選ぶ <a href="#connection-types" id="connection-types"></a>

接続先はプロジェクトごとに異なります。複数のプロジェクトを利用する場合は、それぞれの接続を追加します。

| 接続方法             | 使う場面                                  | アカウントとの関係                                     |
| ---------------- | ------------------------------------- | --------------------------------------------- |
| Wicleアカウントで接続    | 自分が使うAIサービスから接続する。通常はこちらを選びます         | Wicleにログインして利用します。組織から外れると利用できなくなります          |
| プロジェクト専用tokenで接続 | 共有のSaaSや自動処理など、個人のWicleアカウントを使わずに接続する | 対象プロジェクト専用の認証情報（token）を設定します。作成者が組織から外れても有効です |

## 利用前に確認すること <a href="#before-you-start" id="before-you-start"></a>

MCPを通じて取得した設定情報、分析結果、来訪者データは、接続先の外部AIサービスに送信されます。送信後の保存・利用・共有範囲や、AIモデルの学習に使われるかどうかは、接続先の規約・設定を確認してください。

来訪者データの送信・利用に必要な権限や同意、社内ルールへの適合は、貴社で確認してください。AIによるデータ取得や設定変更は、接続したアカウントまたはtokenの権限で実行され、貴社による操作として扱われます。実行内容と結果を確認して利用してください。

## MCPを有効にする <a href="#enable-mcp" id="enable-mcp"></a>

有効化はプロジェクトごとに行います。操作には組織の`owner`権限が必要です。

MCPの利用に追加料金はかからず、Freeプランでも利用できます。組織設定の`Wicle AI`とは別の設定で、Wicle AIの有効化は必要ありません。接続先のAIサービスの料金や、操作する個別機能の契約条件は別途確認してください。

1. 分析画面の左メニューから`プロジェクト / 組織設定`を開き、対象の組織・プロジェクトを選択します。
2. `プロジェクト設定`の`MCP`を開き、ページ上部の対象プロジェクト名を確認します。
3. `ご利用前の注意事項`を確認します。
4. `ユーザープロファイルの取得を許可する`のチェックを確認し、必要に応じて外します。初期状態ではオンです。ユーザープロファイル・グループプロファイルの値を外部AIで利用するかどうかに応じて選択します。
5. `注意事項を確認して有効にする`を選択します。

### プロファイルデータの取得範囲 <a href="#profile-data" id="profile-data"></a>

有効化後は、`プロファイルデータの取得`にある`ユーザープロファイル・グループプロファイルの取得を許可`で変更できます。操作には`owner`権限が必要です。

オフにすると、`user_id`・`group_id`以外のプロファイルデータは、MCPでの出力や分析条件に使用できません。ユーザーID・グループIDや行動データは引き続き利用できるため、オフにしても、外部AIへの来訪者データの送信がすべて止まるわけではありません。

プロファイルの値の取得をオフにしても、項目名やデータ型などの項目定義は取得できます。`Full`権限でのカスタム項目定義の作成・変更・削除も可能です。

## 接続の権限を選ぶ <a href="#permissions" id="permissions"></a>

Wicleアカウントで接続する場合は認可画面で、専用tokenを使う場合は作成時に権限を選びます。

| 権限          | 許可する操作                      | 選ぶ場面                       |
| ----------- | --------------------------- | -------------------------- |
| `Read only` | データの分析、データと設定の読み取り          | 分析や設定の確認だけを依頼する            |
| `Full`      | 読み取りに加え、MCPで対応する設定の作成・更新・削除 | AIにセグメントやダッシュボードの作成なども依頼する |

`Full`では、今後MCPに追加される作成・更新・削除の操作も許可します。利用する機能の契約条件や作成数などの上限は、MCPから操作する場合も適用されます。

通知設定は、接続方法や組織の権限によって操作できる範囲が異なります。[通知設定の操作条件](#notification-settings)をご覧ください。

### Fullで変更できるもの <a href="#writable-settings" id="writable-settings"></a>

| 対象                                                                                                                                                  | 操作                                                                    |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [セグメント](/segment/segment.md)                                                                                                                        | 作成・編集・削除                                                              |
| [カスタムダッシュボード](/analytics/dashboard/custom-dashboard.md)                                                                                             | 作成・名前変更・削除、ウィジェットの追加・編集・削除・配置やサイズの変更                                  |
| [ファネル](/analytics/funnel.md)                                                                                                                        | 作成・編集・削除                                                              |
| [キー行動](/visualizing-retention/key-behavior/edit-key-behavior.md)                                                                                    | 作成・編集・削除                                                              |
| [ライフサイクル](/visualizing-retention/lifecycle/edit-lifecycle.md)                                                                                       | 設定の取得・更新、再集計状態の確認。取得・確認は`Read only`でも可能                               |
| [ユーザープロファイル](/data-extension/user-profile.md#custom-field-settings)・[グループプロファイル](/group-analytics/group_analytics/implementation.md#field-settings) | カスタム項目定義の作成・表示名やデータ型の更新・削除。標準項目・カスタム項目の定義の取得は`Read only`でも可能          |
| [保存したユーザー・グループの検索条件](/analytics/user/save-condition.md)                                                                                             | 作成・編集・削除                                                              |
| [保存したイベント検索条件](/analytics/event/search-event.md#save-conditions)                                                                                    | 作成・編集・削除                                                              |
| [コードレスイベント](/data-extension/codeless-event.md)・[カスタムイベント](/data-extension/custom-event.md)                                                          | イベント定義の作成・編集・削除                                                       |
| 分析設定のフォルダ                                                                                                                                           | イベント・セグメント・ダッシュボード・ファネル・キー行動・保存した検索条件のフォルダの作成・名前変更・移動・並べ替え・配下の項目を含む削除 |
| [A/Bテスト](/action/experiment.md)                                                                                                                     | 下書きの作成、既存テストの状態に応じた編集・削除                                              |
| [メール通知](/organization-project/notification.md#setup-email)                                                                                          | ログインした本人のメール通知、週次・月次AIレポートの受信設定の変更。Wicleアカウントでの接続のみ                   |
| [Slack通知](/organization-project/notification.md#setup-slack)                                                                                        | 設定済みの連携の解除。組織の`owner`によるWicleアカウントでの接続のみ                              |

保存した検索条件の操作は、条件の保存・変更です。検索結果や人数を固定したり、新しいイベントや計測データを生成したりする操作ではありません。分析結果も必要な場合は、条件の保存とは別に、対象期間を指定して集計を依頼します。

ほかの保存済み検索条件やファネルなどで使用中の検索条件は、削除できない場合があります。変更する場合も、その条件を参照している分析への影響を確認してください。

キー行動の対象イベントや判定条件を変更すると、非同期で再集計されます。保存の完了と集計の完了は異なるため、集計状態を確認してから分析します。ライフサイクルで使用中のキー行動は削除できません。ほかの保存済み条件で参照している場合は、削除しても参照先が自動で修正されないため、先に影響を確認してください。

ライフサイクルの更新は、設定全体を置き換えます。ユーザー用・グループ用で共通の設定で、過去のフェーズも新しい条件で非同期に再集計されます。現在の設定を取得し、維持する条件も含めて確認してから変更し、保存後は集計状態を確認してください。追加のファン条件を省略すると、その条件は解除されます。同じ設定を再送しても再集計状態が変わるため、結果が不明な場合は保存結果を確認してから再試行します。

プロファイルの操作対象は項目定義です。保存済みの属性値を送信・変換・消去したり、過去データを再集計したりする操作ではありません。標準項目の変更・削除や、カスタム項目のキー変更はできません。A/Bテストの条件で参照している項目も削除できません。グループの項目定義の操作には、グループ分析が有効であることが必要です。

ダッシュボードの配置・サイズ変更は、Wicleアカウントでの接続・専用tokenのどちらも`Full`権限で利用できます。例えば「CV数のウィジェットを上段に大きく配置して」と依頼できます。配置だけの変更では、SQL・チャート種別・集計期間・パラメータは変わりません。ほかのメンバーが構成や配置を変更して保存できなかった場合は、最新の配置を確認してから変更案を見直します。

A/Bテストの配信開始・停止には対応していません。計測タグや契約プランなど、上記以外の設定を自由に変更できる権限ではありません。分析用のデータ取得で、保存済みの計測データを書き換えることもできません。

設定の変更・削除を依頼する際は、対象と変更内容を確認してください。削除は取り消せません。通信エラーなどで結果が分からない場合は、同じ操作を繰り返す前に、Wicleの画面で現在の状態を確認します。

### 通知設定の操作条件 <a href="#notification-settings" id="notification-settings"></a>

メール通知設定の取得・変更と、Slack連携の解除にはWicleアカウントでの接続が必要です。専用tokenでは、`Full`でもこれらを操作できません。

| 対象      | 設定の確認                                                                                  | 設定の変更                                       |
| ------- | -------------------------------------------------------------------------------------- | ------------------------------------------- |
| メール通知   | 接続時にWicleへログインした本人の設定のみ。Wicleアカウントで接続し、`Read only`または`Full`を許可                         | Wicleアカウントで接続し、`Full`を許可。本人の設定のみ            |
| Slack通知 | Wicleアカウントでの接続・専用tokenの`Read only`または`Full`で、設定の有無を確認できます。Webhook URLや通知先チャンネルは取得できません | 連携の解除のみ。組織の`owner`がWicleアカウントで接続し、`Full`を許可 |

メール通知をオフにしても、ほかのメンバーのメールやSlack通知は止まりません。Slack連携の解除は、プロジェクト全体のSlack通知を停止します。

MCPからSlack通知先の登録・変更やテスト送信はできません。通知先を登録・変更する場合は、Wicleの[Slack通知設定](/organization-project/notification.md#setup-slack)で操作します。

たとえば、メール通知なら「このプロジェクトの週次メール通知だけをオフにして」、Slack通知なら「このプロジェクトのSlack連携を解除して」と依頼できます。操作前に、対象プロジェクトと変更の影響を確認してください。通知設定の変更は、AIレポートの送信・再送を行う操作ではありません。

## Wicleアカウントで接続する <a href="#personal-connection" id="personal-connection"></a>

対象プロジェクトの組織に所属するWicleアカウントを使用します。接続先のAIサービスは、Wicleへのログインによる認証に対応している必要があります。

1. 対象プロジェクトの`MCP`設定を開き、`接続方法`の`Wicleアカウントで接続`タブを選択します。
2. `アカウント接続の設定`で、AIに登録を依頼できる場合は`指示をコピー`を選択し、接続先のAIに貼り付けます。設定JSONを直接登録する場合は、`JSONのみコピー`を選択し、接続先のMCP設定に追加します。
3. 接続先でWicleへの接続を開始し、ブラウザでWicleにログインします。
4. `Wicleへの接続`画面で、[接続の権限](#permissions)を選び、接続内容を確認して許可します。
5. 接続先のAIに、対象プロジェクトと調べたい期間・条件を伝えて分析を依頼します。たとえば「先月の流入元別のユーザー数とCV数を比較して」と質問します。

設定の登録場所や接続の開始方法は、接続先のAIサービスによって異なります。

既存のMCP設定は残して追加してください。接続名の`wicle`は例です。同じURLの接続があれば再利用し、別のプロジェクトのURLが登録されている場合は、未使用の接続名で追加します。

## プロジェクト専用tokenで接続する <a href="#project-token" id="project-token"></a>

tokenの作成・失効には組織の`owner`権限が必要です。接続先は、HTTPヘッダーにtokenを設定する認証方式に対応している必要があります。

{% hint style="warning" %}
tokenを持つ人やサービスは、そのtokenの権限で対象プロジェクトを操作できます。接続先の認証情報の設定欄に保存し、チャット本文や共有ドキュメントには貼り付けないでください。
{% endhint %}

1. 対象プロジェクトの`MCP`設定で、`接続方法`の`プロジェクト専用tokenで接続`タブを選択し、`tokenを作成`を選択します。
2. `用途名`に接続先や目的が分かる名前を入力し、[接続の権限](#permissions)を選んで`tokenを作成`を選択します。
3. `tokenをコピー`でtokenを控え、`閉じる`を選択します。tokenの全文が表示されるのは作成時だけです。
4. `URLをコピー`で接続先URLをコピーし、接続先のMCP設定に登録します。認証情報には、次のHTTPヘッダーを設定します。`<token>`はコピーしたtokenで置き換えます。

   ```http
   Authorization: Bearer <token>
   ```
5. 接続先から分析や設定の参照を依頼し、対象プロジェクトの情報を取得できることを確認します。

tokenは同じ組織の別プロジェクトには使えません。専用tokenによる作成・更新では、作成者・更新者名は`MCP`になります。

### tokenを管理・失効する <a href="#manage-tokens" id="manage-tokens"></a>

一覧では用途名、権限、状態、最終使用日時、作成者、作成日時を確認できます。用途名は、対象行の`…`から`用途名を編集`で変更できます。

不要になった場合や、tokenが漏れた可能性がある場合は、`owner`が対象行の`…`から`tokenを失効`を選び、確認画面で`失効する`を選択します。そのtokenを使っている連携が停止します。失効したtokenは再利用できません。

tokenの全文を確認できなくなった場合は、新しいtokenを作成して接続先の設定を入れ替え、古いtokenを失効してください。

## レート制限を確認する <a href="#query-limits" id="query-limits"></a>

`MCP`設定の`プロジェクトのレート制限`で、一定時間内に実行できるquery数の上限を確認できます。1 queryは、AIがデータを集計・分析する処理を1回実行する単位です。質問数とは異なり、1つの質問で複数queryを使う場合があります。

録画一覧の検索も1回につき1 queryを消費し、分析と同じ上限を共有します。録画の状態・ページ情報などの詳細取得ではquery数を消費しません。

レート制限は、プロジェクト内のメンバー・token・接続先AIサービスで共有します。Wicle内の分析アシスタントなどの利用回数とは別です。上限に達すると、接続先のAIに待機時間と再実行方法を案内します。AIが待機後に分析を再開するか、利用者による再実行が必要かは、接続先によって異なります。

Growthプラン以上、またはAI Analytics mini以上の契約では、query実行数の上限が緩和されます。適用中の上限は、各プロジェクトの画面で確認してください。

## MCP経由の操作履歴を確認する <a href="#audit-log" id="audit-log"></a>

組織の`owner`は、`組織設定`の`監査ログ`で、MCP経由の操作の実行者・日時・結果を確認し、CSVで出力できます。Wicleアカウントによる操作と、プロジェクト専用tokenによる操作を区別できます。

記録範囲と保持期間はメインプランによって異なります。詳しくは[組織の監査ログ](/organization-project/organization-setting/audit-log.md)をご覧ください。

## MCPを無効にする <a href="#disable-mcp" id="disable-mcp"></a>

組織の`owner`が`MCP`設定の`MCPを無効にする`を選択し、確認画面で`無効にする`を選択します。プロジェクトへの新しいMCP操作を受け付けなくなります。

無効化してもtokenは保持され、再度有効にすると失効していないtokenを利用できます。特定のtokenによる接続を止めたい場合は、[tokenを失効](#manage-tokens)してください。

関連する疑問は、[AI機能のFAQ](/other/faq/how-to-use/ai-features.md#mcp-vs-chat-agent)をご覧ください。