Создание Notion OAuth app для OpenConnector

Используйте публичное подключение Notion, когда пользователи OpenConnector должны авторизовать страницы или базы данных workspace через OAuth. Notion также поддерживает internal integration secrets, но для процесса авторизации пользователя используйте OAuth.

Сервис OpenConnector

ID сервиса	Провайдер	Тип авторизации
`notion`	Notion	OAuth2

OAuth-провайдер Notion в OpenConnector запрашивает capabilities read_content, insert_content и update_content.

Предварительные требования

Запущенный runtime OpenConnector.
Доступ к developer portal интеграций Notion.
Разрешение на создание публичного подключения.
Origin OpenConnector, который пользователи открывают в браузере, например http://localhost:3000 или https://connect.example.com.

Шаг 1. Настройте callback URL OpenConnector

Добавьте /oauth/callback к origin OpenConnector. Для локального тестирования используйте http://localhost:3000/oauth/callback. Для публичного deployment задайте OOMOL_CONNECT_ORIGIN, перезапустите OpenConnector и используйте публичный callback URL, например https://connect.example.com/oauth/callback.

Шаг 2. Создайте публичное подключение Notion

На developer portal интеграций Notion:

Создайте новое публичное подключение.
Укажите название подключения и сведения о workspace.
Добавьте точный callback URL OpenConnector в конфигурацию OAuth redirect URI.
Выберите installation scope для своего сценария.
Настройте content capabilities, необходимые actions OpenConnector.
Сохраните подключение.

Официальное руководство Notion: Authorization. Installation scope выбирается при создании публичного подключения, поэтому выбирайте его внимательно.

Шаг 3. Скопируйте client credentials

В настройках публичного подключения Notion скопируйте:

Значение Notion	Поле OpenConnector
Идентификатор клиента OAuth	`clientId`
Секрет клиента OAuth	`clientSecret`

Шаг 4. Сохраните клиент Notion в OpenConnector

Используйте web console OpenConnector:

Откройте web console OpenConnector, например http://localhost:3000.
Откройте Providers и выберите Notion.
Выберите Configure OAuth Client или Edit OAuth Client.
Вставьте client ID и client secret Notion.
Выберите Save OAuth Client.

Шаг 5. Подключите и проверьте

После сохранения OAuth client выберите Connect на странице провайдера Notion. Выберите содержимое workspace Notion для общего доступа, подтвердите доступ, вернитесь в OpenConnector и убедитесь, что workspace отображается как подключённый.

Используйте notion.search или notion.list_users как безопасный тестовый action из списка actions в console.

Устранение неполадок

Симптом	Что проверить
Notion отклоняет redirect URI	OAuth redirect URI в Notion должен точно совпадать с `<openconnector-origin>/oauth/callback`.
Общее содержимое отсутствует	Во время авторизации выберите страницы или базы данных, доступные подключению. Доступ Notion ограничен общим содержимым.
Actions записи не выполняются	Убедитесь, что у подключения Notion есть capabilities вставки или обновления содержимого, а общая страница или база разрешает операцию.
Подключён неверный workspace	Начните авторизацию в профиле браузера, где выполнен вход в нужный workspace Notion.
Путаница между internal integration token и OAuth	В этом руководстве используются OAuth client ID и client secret. Internal integration secrets настраиваются иначе.