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

# Notion 連携

> Notion をナレッジソースとして接続し、AI エージェントが Notion のページやデータベースを検索・参照できるようにする手順

Notion をナレッジソースとして接続すると、AI エージェントが問い合わせへの回答時に Notion のページやデータベースを検索・参照できるようになります。

Notion アカウントでサインインし、OAuth で接続します。
取り込まれるのは、認可の際、AIヘルプデスクに共有したページとデータベース（そのサブページを含む）です。共有していないページにはアクセスしません。

<Note>
  AIヘルプデスクが要求するのは読み取り専用のアクセスだけで、Notion のコンテンツを変更することはありません。
</Note>

## 前提条件

<Info>
  * AIヘルプデスクの **管理者（Admin）** ロールが必要です
  * 取り込むページとデータベースにアクセスできる Notion アカウントが必要です
  * ナレッジソースが初期化されている必要があります。**ナレッジソース** セクションに **ナレッジソースを初期化** ボタンが表示されている場合は、クリックして初期化が終わるまで待ってください
</Info>

<Warning>
  Notion 側のページの共有範囲は考慮されません。AIヘルプデスクに共有したページは、AIヘルプデスクを利用する組織内のすべての従業員への回答に使われることがあります。

  機密性の高いページやデータベースは、認可のときに共有しないでください。取り込む範囲は、初回同期を開始する前に、**データベースの行を含める** をオフにしたり、**同期するページID（任意）** を指定したりして絞り込むこともできます（[取り込む範囲を設定する](#crawl-scope)）。
</Warning>

<h2 id="connect">
  Notion を接続する
</h2>

<Steps>
  <Step title="ソースの接続を始める">
    左のナビゲーションから **設定** を選択し、**連携** タブを開きます。
    **ナレッジソース** セクションの **ソースを接続** ボタンをクリックし、**Notion** を選択します。
  </Step>

  <Step title="接続方法を選ぶ">
    **Notion で認証** を選択します。
  </Step>

  <Step title="Notion で認証する">
    **Notion で認証** ボタンをクリックすると、Notion の認証ページに移動します。
    Notion アカウントでサインインし、AIヘルプデスクに共有するページとデータベースを選んで、アクセスを許可します。
  </Step>

  <Step title="取り込む範囲を設定する">
    認証が終わると AIヘルプデスクに戻り、**Notion を設定** の画面が表示されます。
    取り込む範囲を設定して **設定を保存** をクリックします（[取り込む範囲を設定する](#crawl-scope)）。
    あとで設定する場合は **後で設定する** をクリックします。
  </Step>

  <Step title="初回同期を開始する">
    **初回同期を開始** をクリックします。
    同期を後で実行する場合は **今はスキップ** をクリックします。
  </Step>

  <Step title="接続を確認する">
    **ナレッジソース** セクションに Notion の行が追加されます。
    同期が終わると、行のバッジが **同期済み** になります。
  </Step>
</Steps>

<h2 id="crawl-scope">
  取り込む範囲を設定する
</h2>

初期状態では、AIヘルプデスクに共有したすべてのページと、共有したデータベースのすべての行が取り込まれます。
取り込む範囲を変える場合は、接続時の **Notion を設定** の画面で、以下を設定します。
接続後に変更する場合は、Notion の行のメニュー（**…**）で **設定を編集** をクリックします。

1. **データベースの行を含める** のオン・オフを選びます（初期状態はオン）。オンの場合は、共有したデータベース・Wiki の各行が、それぞれ 1 つのドキュメントとして取り込まれます
2. Wiki のうち検証済みのページだけを取り込む場合は、**検証済みのWikiページのみ同期** をオンにします
3. 特定のページだけを取り込む場合は、**同期するページID（任意）** に、ページ ID を 1 行 1 件で入力します
4. **設定を保存** をクリックします

<Info>
  * **検証済みのWikiページのみ同期** は、Notion で「検証済み」とマークされていない Wiki のページを取り込みません。Wiki 以外のページには影響しません
  * **同期するページID（任意）** が空欄の場合は、共有したすべてのページが対象です
  * **同期するページID（任意）** を指定すると、指定していないページは取り込まれません。配下のページも取り込む場合は、そのページの ID も指定してください
  * **データベースの行を含める** がオンの場合は、**同期するページID（任意）** を指定しても、共有したデータベースの行が取り込まれます。指定したページだけを取り込む場合は、**データベースの行を含める** をオフにしてください
</Info>

<Warning>
  1 回の同期で取り込めるのは最大 3,000 件です。対象がこれを超えると、同期は失敗します。共有するページを減らすか、**データベースの行を含める** をオフにしたり、**同期するページID（任意）** を指定したりして、対象を絞り込んでください。
</Warning>

## AI エージェントでの利用

Notion を接続すると、AI エージェントがナレッジ検索時に自動的に Notion を検索対象に含めます。

AI エージェントは、質問のたびに Notion を参照するのではなく、同期で取り込んでインデックス化した内容を検索します。Notion で追加・更新したページは、次の同期の後で検索結果に反映されます。

同期スケジュールの初期設定は **手動（デフォルト）** です。手動の場合は、**ナレッジソース** セクションの Notion の行のメニュー（**…**）で **今すぐ同期** をクリックしたときだけ同期されます。自動で同期する場合は、同じメニューの **同期スケジュール** を開き、**1時間ごと**・**6時間ごと**・**毎日**・**毎週** のいずれかに変更してください。同期の操作と同期スケジュールの変更には、AIヘルプデスクの **管理者（Admin）** ロールが必要です。

プレイブックのステップで明示的に参照する場合は、`{{document_search}}` ツールを使用します。

```markdown theme={null}
### Step 2: 社内ドキュメントを検索する

{{document_search}} で関連手順を検索する。
Notion の社内 Wiki も検索対象に含めてください。
```

## 同期履歴の確認

Notion の行の同期状態を示すバッジ（**同期済み** など）をクリックするか、行のメニュー（**…**）で **同期履歴** をクリックすると、同期履歴が開きます。
同期履歴に表示される件数の意味は、Confluence 連携の「[同期履歴の見方](/ai-helpdesk/integrations/confluence#sync-history)」をご覧ください。

## 連携を切断する

<Steps>
  <Step title="ナレッジソースを開く">
    **設定** > **連携** タブの **ナレッジソース** セクションを開きます。
  </Step>

  <Step title="切断する">
    切断する Notion の行のメニュー（**…**）で **切断** をクリックします。
    確認ダイアログで **切断** をクリックしてください。

    確認ダイアログのボタンをクリックしてから 5 秒間は、表示される通知の **元に戻す** をクリックすると切断を取り消せます。

    <Warning>
      切断すると、AI エージェントは Notion を参照しなくなります。同期で取り込んだコンテンツは、次回の更新時に削除されます。
    </Warning>
  </Step>
</Steps>

切断しても、Notion 側でアクセスを許可した記録は残ります。不要な場合は、Notion 側で取り消してください。

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

**行のバッジが「接続エラー」や「同期失敗」になる**

同期履歴でエラーの内容を確認してください。認証に関する問題の場合は、行のメニュー（**…**）で **認証情報を編集** をクリックし、確認ダイアログで **再認証** をクリックして、Notion で認証し直してください。

**特定のページが検索結果に出てこない**

* 認可の際、AIヘルプデスクに共有していないページは取り込まれません
* **同期するページID（任意）** を設定している場合は、指定していないページは取り込まれません
* **検証済みのWikiページのみ同期** がオンの場合は、検証済みでない Wiki のページは取り込まれません

行のメニュー（**…**）の **設定を編集** で、設定を確認してください。

## 関連ページ

* [AIヘルプデスクの連携の概要](/ai-helpdesk/integrations/index)
* [Confluence 連携](/ai-helpdesk/integrations/confluence)
* [ナレッジの追加](/ai-helpdesk/knowledge/adding)
* [プレイブックの登録](/ai-helpdesk/playbooks/creating)


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