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

# NotionをCognoに連携する

> Notionを連携すると、共有したページやデータベースをCognoが読み取り、ナレッジベースを手元に置けます。

![Notion](https://mintcdn.com/genaxis/oMT3YnoHFDqPiaPK/images/integrations/notion-mono.svg?fit=max\&auto=format\&n=oMT3YnoHFDqPiaPK\&q=85\&s=3092cd2ce17c3cefa960c68600e9abbe)

## 概要

| | |
| - | - |
| **方向** | 双方向 — 許可したページとデータベースをCognoが読み、その配下でページの作成・編集やコメントもできます。 |
| **接続方法** | Notion OAuth — ワンクリック。 |
| **設定できる人** | **設定** を開けるワークスペース memberなら誰でも。 |
| **必要なもの** | 共有したいページが入っているNotionアカウント。 |

Notionを接続すると、選んで共有したページとデータベースでCognoが働けるようになります。ページを読む、データベースの行を検索する、ページや行を書く、ページを編集する、コメントに返信する、ができます。書き込みを許すかどうかは **エージェントツール** で決めます。

## 事前確認

* 対象ワークスペースで **設定** を開ける。
* 共有したいページが入っているNotionアカウントにサインインしている。

## CognoでNotionを接続する

**1. Notion連携を開く**

**連携** を開き、**Notion** を選択します。

**2. Notionを認可する**

**接続** を押します。Notionの認可画面が別ウィンドウで開くので、共有するページ・データベースを選んで承認します。

**3. 接続を確認する**

Cognoに戻ると、**Connection** にNotion ワークスペースが表示されます。

## Cognoが見られるページを選ぶ

**連携済みページ** セクションに、共有したページとデータベースが、**Page**・**Database**・**Data source** の種別と最終更新日つきで表示されます。選択を変えるには **ページを変更** を押し、Notionの認可画面で共有内容を調整します。

> [!NOTE]
>
> Cognoが読むのは、明示的に共有したページとデータベースだけです。共有の管理はNotion側の認可で行います。

## CognoがNotionでできること

Project内では、Projectで選んだページとデータベース**およびその配下**(子ページやデータベースの行。後から作られたものも含む)に届きます。Notionを絞り込んでいないProjectは、Cognoに共有された全ページに届きます。

| | |
| - | - |
| **読む** | ページ検索、ページを今の状態で読む、データベースの列を読む、フィルターと並び替えで行を検索する、コメントを読む、Notionのユーザーを探す。 |
| **書く** | ページとデータベース行の作成、プロパティの変更、本文の部分置換・追記・全置換、ページをゴミ箱へ移動、コメントとディスカッションへの返信。 |

Projectで選んだページそのものは、Cognoからゴミ箱へ移せません。

## エージェントツール

Notion連携ページの **エージェントツール** に **Notionを読み取る** と **Notionに書き込む** の2行があります。それぞれ「常に許可・事前に確認・拒否」を選べ、次の実行から反映されます。

> [!NOTE]
>
> 一部の操作には、Notion側の権限(コメントの読み取り・追加、本文の挿入・更新、ユーザー情報の読み取り)も必要です。Cognoが権限不足を報告したら、ワークスペース管理者がCognoのNotion接続で有効にし、**ページを変更** から接続し直します。

## ページ本文の更新

実行中にCognoがページを扱うときはNotionをその場で読みます。それとは別に、CognoはNotionから本文の更新通知を受けたときや、Projectのページフィルターにページを追加したときに、対象ページの保存本文を個別に更新します。アクセスできる全ページの本文を定期的に読み直すことはありません。通知の取り逃しや取得の失敗により、保存本文が古いまま、または未取得のままになる場合があります。最新の本文はNotionで確認してください。**ページを同期**で更新されるのは、ページ一覧とその情報だけです。

## 接続を解除する

接続行の **⋯** メニューから **接続を解除** を選び、確認します。

## よくある状態

| State | Meaning | Next action |
| - | - | - |
| **連携済みページ** が空 | 認可時にページを共有していない | **ページを変更** で共有するページを選びます |
| 期待したページが無い | Notionの認可に含まれていなかった | **ページを変更** で追加します |
| 一部しか表示されない | 連携対象の先頭分が表示されている | 必要なページだけに共有を絞ります |
| 保存されたページ本文が古い | 個別の更新が未完了、または取り逃されている | 最新の本文はNotionで確認します。**ページを同期**で更新されるのは一覧だけです |

## 参照URL

* [Notion: connectionと連携の管理](https://www.notion.so/help/add-and-manage-connections-with-the-api)

## 関連docs

* [Troubleshooting](/docs/ja/troubleshooting.md)


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