OpenConnector 用の Notion OAuth app を作成する

OpenConnector で users が workspace pages または databases を OAuth で認証する必要がある場合は、Notion public connection を使用します。Notion は internal integration secrets にも対応していますが、user authorization flow が必要な場合は OAuth を使用してください。

OpenConnector サービス

サービス ID	プロバイダー	認証方式
`notion`	Notion	OAuth2

OpenConnector の Notion OAuth provider は、read_content、insert_content、update_content などの capabilities を要求します。

前提条件

実行中の OpenConnector runtime。
Notion integrations developer portal へのアクセス。
public connection を作成する permission。
users が browser で開く OpenConnector origin（http://localhost:3000、https://connect.example.com など）。

手順 1：OpenConnector callback URL を設定する

OpenConnector origin に /oauth/callback を追加して callback URL を作成します。local test では http://localhost:3000/oauth/callback を使用します。public deployment では OOMOL_CONNECT_ORIGIN を設定して OpenConnector を再起動し、https://connect.example.com/oauth/callback などの public callback URL を使用します。

手順 2：Notion public connection を作成する

Notion integrations developer portal で次の操作を行います。

新しい public connection を作成します。
connection name と workspace details を入力します。
OAuth redirect URI configuration に OpenConnector callback URL を正確に追加します。
use case に合う installation scope を選択します。
OpenConnector actions に必要な content capabilities を設定します。
connection を保存します。

Notion の公式ガイドは Authorization です。installation scope は public connection の作成時に選択するため、慎重に選んでください。

手順 3：client credentials をコピーする

Notion public connection settings から次の値をコピーします。

Notion の値	OpenConnector のフィールド
OAuth クライアント ID	`clientId`
OAuth クライアントシークレット	`clientSecret`

手順 4：Notion client を OpenConnector に保存する

OpenConnector web console を使用します。

http://localhost:3000 などの OpenConnector web console を開きます。
Providers を開いて Notion を選択します。
Configure OAuth Client または Edit OAuth Client を選択します。
Notion client ID と client secret を貼り付けます。
Save OAuth Client を選択します。

手順 5：接続してテストする

OAuth client を保存した後、Notion provider page で Connect を選択します。共有する Notion workspace content を選び、access を承認して OpenConnector に戻り、provider page に workspace が connected と表示されることを確認します。

console action list から notion.search または notion.list_users を low-risk test action として使用します。

トラブルシューティング

症状	確認事項
Notion が redirect URI を拒否する	Notion の OAuth redirect URI が `<openconnector-origin>/oauth/callback` と完全に一致している必要があります。
共有 content が見つからない	authorization 中に connection がアクセスする pages または databases を選択します。Notion access は shared content に限定されます。
Write actions が失敗する	Notion connection に insert または update content capabilities があり、共有 page/database が操作を許可していることを確認します。
誤った workspace が接続される	対象の Notion workspace にサインインした browser profile で authorization を開始します。
Internal integration token と OAuth を混同している	このガイドでは OAuth client ID と client secret を使用します。internal integration secrets は別の setup path です。