> 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/organization-project/organization-setting/audit-log.md).

# 組織の監査ログ

MCP経由の操作について、実行者・日時・結果を組織単位で確認する方法と、監査ログの記録範囲・保持期間・CSV出力を説明します。

MCP経由で「誰が、いつ、何を操作し、どのような結果になったか」を組織単位で確認できます。プロジェクトや実行者で絞り込み、操作の詳細を確認したり、検索結果をCSVで出力したりできます。

{% hint style="warning" %}
現在ログが記録される経路は、MCPのみです。管理画面での操作は記録されません。管理画面での操作についても、今後対応し追加予定です。
{% endhint %}

## 記録対象と保持期間 <a href="#recording-scope" id="recording-scope"></a>

本番環境のプロジェクトに対する操作が対象です。テスト環境やデモプロジェクトの操作は記録されません。記録範囲と保持期間は、操作時点のメインプランで決まります。

| メインプラン        | 記録する操作                    | 保持期間 |
| ------------- | ------------------------- | ---- |
| Free          | 書き込み（作成・更新・削除など）          | 90日  |
| Growth・Custom | 読み取り（データや設定の取得、分析など）と書き込み | 730日 |

プランの変更によって、過去に記録されなかった操作が追加されたり、記録済みログの保持期間が変わったりすることはありません。現在の記録範囲と保持期間は、監査ログ画面上部の`現在の記録範囲`で確認できます。

記録対象には、セグメント・ダッシュボード・ファネルなどの作成や変更、設定の取得、分析の実行などが含まれます。共通の定義情報・分析知識の取得や、MCPの接続初期化・ツール一覧の取得などは対象外です。

## 監査ログを開く <a href="#open-audit-log" id="open-audit-log"></a>

閲覧・検索・詳細確認・CSV出力には、対象組織の`owner`権限が必要です。

1. 分析画面の左メニューから`プロジェクト / 組織設定`を開きます。
2. 対象の組織を選択し、`組織設定`の`監査ログ`を開きます。

初期状態では、直近7日間の書き込み操作が表示されます。

## 操作を検索する <a href="#search-operations" id="search-operations"></a>

1. `開始日時`と`終了日時`を指定します。
2. 必要に応じて、対象プロジェクトや実行者などの条件を選びます。
3. `検索`を選択します。

| 検索条件     | 選び方                                                                                                              |
| -------- | ---------------------------------------------------------------------------------------------------------------- |
| 対象プロジェクト | 組織内のプロジェクトを選択します。`すべて`でプロジェクトを横断して確認できます。`組織に対する操作`も選択できますが、現在記録されるMCP操作はプロジェクトに対する操作です                          |
| 経路       | 現在の記録対象は`MCP`のみです。`管理画面`を選択しても、該当するログはありません                                                                      |
| 実行者種別    | `Wicleアカウント`または`プロジェクト専用token`を選択します。接続方法の違いは[MCPの接続方法](https://docs.wicle.io/ai/mcp.md#connection-types)をご覧ください |
| 実行者      | 特定のアカウントやtokenを選択します。名称・種別・IDで識別できます                                                                             |
| 書き込みのみ   | 作成・更新・削除などに絞り込みます。読み取りも確認する場合はチェックを外します                                                                          |

結果が複数ページに分かれる場合は、`次へ`・`前へ`で切り替えます。

## 一覧と操作の詳細を確認する <a href="#operation-details" id="operation-details"></a>

一覧では、日時、対象の`Project`、実行者、操作、読み書きの区分、結果を確認できます。

| 結果   | 意味                                                    |
| ---- | ----------------------------------------------------- |
| 成功   | 操作が正常に完了しました                                          |
| 拒否   | 権限不足や入力内容の不備などにより、操作が受け付けられませんでした                     |
| 失敗   | 対象が見つからない、データの取得に失敗したなど、操作を完了できませんでした                 |
| 成否不明 | 書き込み操作が反映されたかどうかを確定できませんでした。再実行する前に、対象の現在の状態を確認してください |

対象行の`詳細`を選択すると、操作ID、組織ID、Project ID、実行者ID、操作コード、理由コード、対象ID、`送信元IP`などを確認できます。一部のIDはコピーボタンでコピーできます。

`送信元IP`は、MCPリクエストの送信元のIPアドレスです。CSVにも出力されます。取得できない場合もあります。

Wicleアカウントでの操作では、実行者の名称として操作時点のメールアドレスが記録されます。プロジェクト専用tokenでの操作では、操作時点の用途名が記録されます。名称や対象IDを取得できない場合もあります。

`詳細`には、操作に使用した入力内容の一部が表示される場合があります。SQL本文、コード本文、検索条件の具体的な値などは保存対象から除外されます。入力内容の全体や、変更前後の状態を復元するためのログではありません。

## 検索結果をCSVで出力する <a href="#export-csv" id="export-csv"></a>

1. 出力したい期間や条件を指定し、`検索`を選択します。
2. 検索が完了したら、`全検索結果をCSV出力`を選択します。

表示中のページだけでなく、最後に検索した条件に一致するすべてのログが出力されます。条件を入力し直しただけではCSVの対象は変わらないため、条件変更後は必ず`検索`を選択してください。
