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

# Notion をアプリに接続する

> アプリから Notion のページとデータベースを読み書きし、コメントを追加し、ワークフローを実行します。1 つの共有 Notion アカウントか、各ユーザー自身の Notion アカウントを使います。

アプリを Notion に接続して、ページとデータベースを読み書きし、コメントを追加し、Notion のワークスペースで何かが変わったときにワークフローを実行します。アプリ全体で 1 つの共有アカウントを使うことも、各ユーザーが自分の Notion アカウントを接続することもできます。

***

## できること

Notion のページとデータベースを、アプリのワークフローに組み込みます。

> [card] データベースを同期
>
> Notion のデータベースの行をアプリに表示したり、データベースをアプリのレコードと同期したりします。

> [card] ページを作成
>
> 新しいクライアントごとのページなど、アプリから Notion のページを作成します。既存のページに更新を追加することもできます。

> [card] コメントを扱う
>
> ページのコメントを読み、アプリから新しいコメントを追加します。

> [card] [ワークフローを実行](https://docs.base44.com/ja/Building-your-app/Creating-workflows.md#connector)
>
> ページやデータベースが作成、更新、移動、削除されたときや、誰かがコメントしたときに、ワークフローを開始します。

**プロンプト例**

AI チャットで、ページまたはデータベース、アクションのきっかけ、動的フィールドを指定します。例:

```text wrap theme={null}
Notion のデータベースを私の CRM のレコードと同期して。
```

```text wrap theme={null}
このアプリのプロジェクトの更新を Notion のページに書き込んで。
```

```text wrap theme={null}
チームのオンボーディング用の Notion チェックリストの進捗をダッシュボードに表示して。
```

```text wrap theme={null}
アプリに新しいクライアントが追加されるたびに、Notion のページを作成して。
```

***

## Notion を接続する

接続方法を選びます。アプリ全体で 1 つの共有アカウントを使うか、各ユーザーが自分のアカウントを使います。

> [tab] 共有コネクタ
>
> 1 つの Notion アカウントを接続します。その接続を使うすべてのアプリと、それらのアプリを使う全員が、接続と、接続から見えるページを共有します。
>
> **共有 Notion コネクタを追加するには:**
>
> 1. ワークスペースのサイドバーで **コネクタ** をクリックします。
>
> 2. **コネクターを追加** をクリックします。
>
> 3. **Notion** を検索し、クリックします。
>
> 4. **共有コネクター** を選択し、**次へ** をクリックします。
>
> 5. **接続名** を入力します。
>
> 6. **アクセスできる対象** で、接続を使える場所を選択します:
>    * **アプリと Super Agent:** アプリと Superagent の両方が使えます。これがデフォルトです。
>    * **アプリのみ:** アプリだけが使えます。
>    * **Super Agent のみ:** Superagent だけが使えます。
>
> 7. **権限** で、アプリができることを選択します。**read content** と **read comment** はあらかじめ選択されています。アプリに必要なものを追加します:
>
>    * **insert content:** ページを作成し、データベースの行を追加します。
>    * **update content:** 既存のページとデータベースの行を変更します。
>    * **insert comment:** コメントを追加します。
>
>    ![Connection name、Who can access と、read content と read comment が選択された Permissions が表示された共有 Notion コネクタの設定](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-shared-setup.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=4613834e2b9b1e12620ed0d4c2e5a189)
>
>    共有 Notion コネクタを設定する
>
> 8. **コネクターを追加** をクリックします。
>
> 9. Notion にサインインし、アプリで使えるページを選びます。詳しくは、Notion の [接続のインストール](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth) に関するガイドを参照してください。

> [tab] アプリユーザーコネクタ
>
> 各ユーザーが自分の Notion アカウントを接続します。アプリは、そのユーザーが共有を選んだページを扱えます。
>
> > [!WARNING]
> >
> > これを設定できるのは、ワークスペースのオーナーと管理者のみです。
>
> > [!TIP]
> >
> > **設定する前に:** 公開 Notion インテグレーションと、その Client ID と Client Secret が必要です。[独自の OAuth クライアントを使う](https://docs.base44.com/ja/Integrations/Connectors.md#using-your-own-oauth-client) を参照してください。
>
> **アプリユーザー Notion コネクタを追加するには:**
>
> 1. ワークスペースのサイドバーで **コネクタ** をクリックします。
>
> 2. **コネクターを追加** をクリックします。
>
> 3. **Notion** を検索し、クリックします。
>
> 4. **アプリユーザーコネクター** を選択し、**次へ** をクリックします。
>
> 5. **コールバック URL** をコピーします。
>
> 6. Notion インテグレーションの設定で、コールバック URL をリダイレクト URI として追加します。
>
> 7. **Add Notion Connection** フォームに入力します:
>
>    * **コネクタ名:** 後で識別できる名前。
>    * **クライアントID** と **クライアントシークレット:** Notion インテグレーションの設定からコピーします。
>
>    ![Callback URL、Connector name、Client ID、Client Secret がある Add Notion Connection フォーム](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-app-user-credentials.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=2d7f3ef817379a121bb34c45ca966c6a)
>
>    Notion インテグレーションの認証情報を入力する
>
> 8. **コネクタを追加** をクリックします。
>
> 9. アプリエディターでアプリを開きます。
>
> 10. 各ユーザーが自分の Notion アカウントを接続できる仕組みを追加するよう AI チャットに依頼します。

***

## スコープと権限

アプリの Notion へのアクセスは、2 か所で制御します。Base44 では、アプリができることを選びます。Notion では、サインインする人が、アプリから見えるページを選びます。

> [card]
>
> **1. Base44 で選ぶもの**
>
> 共有コネクタでは、**権限** でアプリができることを選びます。アプリはデフォルトで、ページ、データベース、コメントを読み取れます。ページ、行、コメントの作成や変更も必要な場合は、書き込みの権限を追加します。
>
> アプリユーザーコネクタでは、アプリができることは Notion インテグレーションに設定された機能によって決まります。
>
> **2. Notion で選ぶもの**
>
> Notion にサインインする人が、アプリで使えるページを選びます。共有コネクタではあなたが、アプリユーザーコネクタでは各ユーザーが選びます。詳しくは、Notion の [接続のインストール](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth) に関するガイドを参照してください。
>
> **アクセス:** アプリは、サインインした人の Notion ワークスペースで、サインイン時に共有されたページとデータベースを扱います。各接続には Notion ワークスペース名が表示されるため、接続を区別できます。

***

## バックエンド関数を使う

Notion を接続すると、バックエンド関数がアクセストークンを取得して Notion API を直接呼び出せます。サインインは Base44 が処理します。

* 共有接続の場合は、`getConnection()` でトークンを取得します。
* アプリユーザー接続の場合は、`getCurrentAppUserConnection()` を使い、各リクエストがサインイン中のユーザーのトークンを使用するようにします。

`api.notion.com` で Notion API を呼び出します。`Authorization` ヘッダーでトークンを、`Notion-Version` ヘッダーで API のバージョンを渡します:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("notion");

const response = await fetch("https://api.notion.com/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Notion-Version": "2025-09-03",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Clients" }),
});
const { results } = await response.json();
```

> [card] [共有コネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/shared-connectors.md)
>
> バックエンド関数から共有接続を設定、デプロイ、呼び出します。

> [card] [アプリユーザーコネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/app-user-connectors.md)
>
> ユーザーごとのトークンを取得し、サインイン中のユーザーとして API を呼び出します。

***

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

アプリで Notion が動作しなくなった場合は、接続と、接続から見えるページを確認してください。

> [accordion] 接続の再接続が必要になる
>
> アプリが Notion へのアクセスを失ったり、サインインの期限が切れたりすると、接続に **この接続は再接続が必要です** セクションが表示されます。
>
> * **共有コネクタ:** [再接続](https://docs.base44.com/ja/Integrations/Connectors.md#managing-your-connectors) し、同じ Notion アカウントでサインインします。その接続を使うすべてのアプリが再び動作します。
> * **アプリユーザーコネクタ:** 各ユーザーがアプリ内から自分の Notion アカウントを再接続します。

> [accordion] アプリでページやデータベースが見つからない
>
> アプリから見えるのは、接続と共有されたページだけです。再接続して Notion でそのページを選ぶか、Notion で [ページに接続を追加](https://www.notion.com/help/add-and-manage-connections-with-the-api#add-connections-to-pages) してください。

> [accordion] ワークフローの実行回数が多すぎる
>
> Notion はページの内容が変わるたびにイベントを送信するため、更新の多いワークスペースではワークフローが何度も開始されることがあります。ワークフローが 1 つのページまたはデータベースに対してだけ実行されるように、条件の追加を AI チャットに依頼してください。

> [!NOTE]
>
> このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


## Related topics

- [Snowflake をアプリに接続する](https://docs.base44.com/ja/Integrations/snowflake-connector.md)
- [Slack をアプリに接続する](https://docs.base44.com/ja/Integrations/slack-connectors.md)
- [Databricks をアプリに接続する](https://docs.base44.com/ja/Integrations/databricks-connector.md)
- [Wix をアプリに接続する](https://docs.base44.com/ja/Integrations/wix-connector.md)
- [Google Maps をアプリに接続する](https://docs.base44.com/ja/Integrations/google-maps-connector.md)


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