Skip to main content

​
Notion

ShanoneのNotion連携では、ページ、データベース、ブロック、コメント、ビューを扱う45のツールをエージェントが利用できるようになります——Markdownネイティブな読み書きも含まれており、多くの場合これがエージェントがNotionのコンテンツを扱う最も便利な方法です。

​
はじめに

1

OAuthで接続する

エージェントにNotionで何か作業をしてもらう(例:「Q3 Roadmapという名前のページを作成して」)か、ShanoneダッシュボードのIntegrationsから事前に接続します。
2

連携アプリにページを共有する

Notionの権限モデルでは、各ページ・データベースを接続済みの連携アプリに明示的に共有する必要があります——OAuth接続後であっても、共有していないページはnotion_searchやnotion_read_pageから見えません。対象のNotionページでShare → Inviteを使って共有してください。
3

リクエストを再試行する

共有が完了すると、エージェントはそのコンテンツを読み取り・書き込み・検索できるようになります。

​
利用可能なツール

ShanoneはNotion用に45のツールを提供しており、以下のカテゴリに分類されています。
notion_create_page, notion_create_page_from_markdown, notion_read_page, notion_read_page_markdown, notion_update_page, notion_update_page_markdown, notion_delete_page, notion_duplicate_page, notion_move_page, notion_get_page_property, notion_batch_update_pages
notion_append_markdown, notion_replace_content — 生のブロックオブジェクトを組み立てる代わりに、プレーンなMarkdownでNotionページに書き込む。ほとんどのエージェント主導の編集ではこちらが推奨される方法
notion_append_block, notion_update_block, notion_delete_block
notion_create_database, notion_update_database, notion_get_database_schema, notion_query_database, notion_update_database_pages, notion_set_relation
notion_create_view, notion_update_view, notion_delete_view, notion_list_views, notion_retrieve_view, notion_create_view_query, notion_get_view_query_results
notion_add_comment, notion_add_block_comment, notion_reply_to_comment, notion_list_comments
notion_search, notion_query_meeting_notes — 連携アプリに共有されているすべてのページ/データベースを横断検索する、またはNotionが自動生成する議事録を特定して表示する
notion_add_file, notion_create_file_upload, notion_send_file_upload, notion_complete_file_upload, notion_retrieve_file_upload, notion_list_file_uploads
notion_get_me, notion_get_user, notion_get_users, notion_list_custom_emojis

​
よくある使い方

議事録からタスクへ

Notionの議事録ページを読み取り、フォローアップ事項を別の場所(例: Linearのissue)に整理する

常時更新されるドキュメント

ブロックツリーを手作業で組み立てる代わりに、Markdown経由でドキュメントの一部を追記・置換する

データベース駆動のレポート

フィルタ/ソートを指定してデータベースを照会し、結果を要約する

ナレッジ検索

Shanoneに共有されているすべてのコンテンツを横断検索して「Xはどこで決まった?」に答える

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

そのページ(またはその親データベース)がNotion上でShanoneの連携アプリに共有されていません。Notionでページを開き、Shareをクリックして連携アプリを明示的に追加してください——OAuthだけではページ単位のアクセス権は付与されません。
notion_append_markdown / notion_update_page_markdownはNotionの一般的なブロックタイプ(見出し、リスト、コード、コールアウト、テーブル)をサポートしていますが、特殊なブロックタイプすべてには対応していません。サポートされていない場合は、ブロックレベルのツール(notion_append_block、notion_update_block)にフォールバックしてください。
まずnotion_get_database_schemaと照らし合わせてフィルタ/ソートのペイロードを確認してください——プロパティ名と型は大文字小文字を含めて完全に一致している必要があります。