Notion連携

StarnionをNotionに接続すると、AIエージェントがNotionページを検索したり、新しいページを作成したり、コンテンツを読み込んだり追記したりできます — すべて自然言語で操作できます。ミーティングメモの作成、アイデアのメモ、ナレッジベースの検索に活用できます。

概要

Notion連携では以下のことができます：

  • 検索：自然言語を使用してワークスペース内のページやデータベースを検索する
  • ページ作成：タイトルと本文コンテンツで新しいページを作成する
  • コンテンツの読み込み：ページIDまたはURLでページのコンテンツを取得して要約する
  • コンテンツの追記：既存のページに新しいテキストブロックを追加する

オプトイン機能： Notion連携はデフォルトで無効になっています。以下のセットアップ手順を完了し、スキルを有効にしてから使用してください。

対応機能

機能 説明
notion_search ページとデータベースを検索する
notion_page_create 新しいページを作成する（本文コンテンツはオプション）
notion_page_read ページコンテンツを読み込む
notion_block_append 既存のページにブロックを追加する

前提条件：Notionインテグレーションの作成

Notion連携はインテグレーショントークンを使用します。Notionワークスペースにインテグレーションを作成し、AIがアクセスしたいページに個別にアクセス権を付与します。

ステップ1：Notionインテグレーションを作成する

  1. https://www.notion.so/my-integrationsにアクセスします。
  2. + 新しいインテグレーションをクリックします。
  3. インテグレーションの名前を入力します（例：Starnion）。
  4. 接続するワークスペースを選択します。

  5. 機能タブで必要な権限を確認して有効にします。

    権限 説明 必須
    コンテンツの読み取り ページとデータベースを読み込む 必須
    コンテンツの更新 ページコンテンツを編集する 推奨
    コンテンツの挿入 新しいページとブロックを作成する 推奨
  6. 保存をクリックします。
  7. シークレット（内部インテグレーションシークレット）をコピーします。
secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

セキュリティに関する注意： インテグレーショントークンはパスワードのようなものです。公開しないでください。

ステップ2：インテグレーションをページに接続する

デフォルトでは、Notionインテグレーションはどのページにもアクセスできません。AIがアクセスする必要のある各ページまたはデータベースに個別にアクセス権を付与する必要があります。

  1. Notionでアクセスを許可したいページを開きます。
  2. 右上の…（その他）をクリック → 接続（または接続先）。
  3. 作成したインテグレーション名を検索して選択します（例：Starnion）。
  4. 確認をクリックします。

ヒント： 親ページにインテグレーションを接続すると、すべての子ページに自動的にアクセスが付与されます。ワークスペース全体にアクセスするには、最上位のページに接続してください。

セットアップ

Web UIでインテグレーショントークンを登録する

  1. Starnion Web UIにログインします。
  2. 左メニューで設定 → 連携タブをクリックします。
  3. Notionセクションでインテグレーショントークン入力フィールドを見つけます。
  4. コピーしたシークレットキー（secret_...）を貼り付けます。
  5. 保存をクリックします。
  6. Notionスキルを有効にするトグルをオンにします。

保存後、トークンはデータベースに保存され、以降のすべてのNotionリクエストに使用されます。

使い方

Notion連携が設定されたら、自然言語でAIにリクエストします。

ページを検索する

ワークスペース内のページとデータベースを検索します。

私: Notionで「Q2計画」を探して
Bot: 「Q2計画」の検索結果（2件）：
    📄 [ページ] 2026年Q2事業計画 | ID: abc123
    📄 [ページ] Q2マーケティング計画 | ID: def456

私: Notionでデータベースのみ（プロジェクト）を検索して
Bot: 「プロジェクト」の検索結果（1件）：
    🗄️ [データベース] プロジェクト管理ボード | ID: ghi789

フィルターオプション：

  • すべて（デフォルト）：ページとデータベースの両方を検索
  • page フィルター：ページのみを検索
  • database フィルター：データベースのみを検索

ページを作成する

タイトルと本文コンテンツで新しいページを作成します。

私: 「2026年3月ミーティングメモ」というNotionページを作成して
Bot: Notionページを作成しました！
    タイトル：2026年3月ミーティングメモ
    URL：https://notion.so/2026-abc123...

私: 「読書リスト」というNotionページを作成して以下の内容を書いて：
    1. The One Thing
    2. Atomic Habits
Bot: Notionページを作成しました！
    タイトル：読書リスト
    URL：https://notion.so/def456...

指定した親ページの下にサブページを作成することもできます。

私: ページabc123の下に「ミーティングメモ 2026-03-08」ページを作成して
Bot: Notionページを作成しました！
    タイトル：ミーティングメモ 2026-03-08
    URL：https://notion.so/...

ページコンテンツを読み込む

ページIDまたはURLでコンテンツを取得します。

私: NotionページのABC123の内容を見せて
Bot: 📄 2026年Q2事業計画
    URL：https://notion.so/...

    ## 目標
    - 売上15%成長
    - 新規顧客20社以上を獲得

私: https://notion.so/project-plan-abc123 のコンテンツを要約して
Bot: （ページコンテンツを読み込んで要約します。）
    このページは2026年の新サービス計画です...

既存のページにコンテンツを追記する 

私: ページabc123に「アクションアイテム：来週までにUI改善」を追加して
Bot: Notionページにコンテンツを追加しました。

私: ミーティングメモページに今日の決定事項を追加して：
    - 4月ローンチ確定
    - 担当者：鈴木太郎
Bot: Notionページにコンテンツを追加しました。

使用例

ミーティングメモの自動整理 

私: さっきのミーティングメモをNotionに整理して。
    参加者：鈴木太郎、田中花子
    重要事項：Q2ロードマップの議論、4月ローンチ確定
    アクションアイテム：提案書の作成（鈴木太郎、3/15まで）

Bot: Notionページを作成しました！
    タイトル：2026-03-08 Q2ロードマップミーティング
    URL：https://notion.so/...

アイデアメモの保存 

私: 今思いついたアイデアをNotionに保存して。
    「AIベースのスケジュール最適化機能 — ユーザーのエネルギーパターンを学習して
    重要なイベントを最適な時間にスケジュールする」

Bot: Notionページを作成しました！
    タイトル：アイデアメモ 2026-03-08
    URL：https://notion.so/...

ナレッジベースの検索と取得 

私: NotionでAPIガイドを探して
Bot: 「APIガイド」の検索結果（2件）：
    📄 [ページ] 社内REST APIガイド v2 | ID: ...
    📄 [ページ] 外部API連携チェックリスト | ID: ...

私: 社内REST APIガイド v2の内容を要約して
Bot: （コンテンツを読み込んで要約します。）
    このドキュメントは社内REST APIの使用方法を説明しています...

重要な注意事項

インテグレーションのアクセス範囲

Notionインテグレーションは明示的にアクセス権が付与されたページとデータベースにのみアクセスできます。インテグレーションが接続されていないページを照会すると、「ページが見つかりません」エラーが返されます。

ページコンテンツの長さ制限

notion_page_read は最大3,000文字を返します。コンテンツが長い場合、先頭部分のみが表示され「コンテンツが切り詰められました」というメッセージが表示されます。

最上位ページを作成するための権限

親ページが指定されていない場合、ページはワークスペースのトップレベルに作成されます。これにはインテグレーションにワークスペースレベルの書き込み権限が必要です。

接続解除の方法

  1. 設定 → 連携 → Notionセクション。
  2. 接続解除をクリックします。
  3. 保存されたNotion APIキーは即座に削除されます。

Notionワークスペースからインテグレーション接続も削除するには：

  1. my-integrationsにアクセス → インテグレーションを選択します。
  2. インテグレーションを削除をクリックします。

トラブルシューティング

「Notion連携が設定されていません」

設定 → 連携 → NotionでインテグレーショントークンAIを登録していることを確認してください。トークンは secret_ で始まります。

「Notion APIキーが無効です」（401エラー）

  • インテグレーショントークンが正しいことを確認します。
  • my-integrationsでトークンがまだ有効であることを確認します。
  • 新しいトークンを生成して設定で更新します。

「ページが見つかりません」（404エラー）

  • インテグレーションがそのページに接続されていることを確認します。
  • Notionでページを開く → … → 接続 → インテグレーションを追加します。

「ページを作成する権限がありません」（403エラー）

  • インテグレーションにコンテンツの挿入権限が有効になっていることを確認します。
  • my-integrationsでインテグレーションの機能設定を確認します。

よくある質問

Q: Notionデータベースにレコードを追加できますか？ A: 現在、ページの作成、コンテンツの読み込み、ブロックの追加がサポートされています。データベースのプロパティを直接操作することはサポートされていません。

Q: 複数のNotionワークスペースを接続できますか？ A: 現在、ユーザーごとに1つのインテグレーショントークンのみ登録できます。回避策として、複数のワークスペースにまたがるページに同じインテグレーションを接続してください。

Q: インテグレーショントークンの有効期限はありますか？ A: Notionの内部インテグレーショントークンは、手動で再生成しない限り有効期限がありません。ただし、Notionからインテグレーションを削除すると使用できなくなります。

Q: 既存のページコンテンツを編集（上書き）できますか？ A: 現在、ページの末尾に新しいブロックを追加することのみサポートされています。既存のブロックコンテンツの編集はサポートされていません。

Q: StarnionはNotion APIキーをどのように保護しますか？ A: APIキーはサーバー側のデータベース（integration_keys テーブル）に保存され、UIには表示されません。HTTPSを通じてのみ送信されます。

Copyright © 2025 StarNion. All rights reserved.  |  v0.1.1