Подключите Notion к ИИ-агенту

Способы аутентификации

• OAuth 2.0
• API-ключ

Откройте локальную консоль, выберите провайдера и настройте учётные данные. Для OAuth-провайдеров нужно зарегистрировать собственное OAuth-приложение в соответствующем сервисе.

Что проверить у этого коннектора

Этот поиск возвращает только содержимое, доступное подключению Notion. Совпадение заголовка не даёт доступа к закрытой странице. Прежде чем считать пустой результат ошибкой, проверьте настройки доступа к ресурсу.

Проверьте Action перед вызовом

Назначение примера

Поиск страниц и источников данных Notion по запросу. Возвращается только доступное подключению содержимое.

Необходимые разрешения Action

• read_content

Получите схему из работающего экземпляра. Перед выполнением проверьте обязательные параметры, права и подключённый аккаунт.

curl -s http://localhost:3000/v1/actions/notion.search

После подключения аккаунта адаптируйте параметры к своим ресурсам. Если включена аутентификация runtime, добавьте его Bearer Token.

curl -s -X POST \
  http://localhost:3000/v1/actions/notion.search \
  -H 'content-type: application/json' \
  -d '{"input":{"query":"OpenConnector","pageSize":5}}'

Как читать результат

Ответы HTTP runtime содержат success, message, data и meta. Проверяйте success и выходную схему Action, а не только HTTP-статус. Если метаданные содержат executionId, по нему можно найти журнал с замаскированными секретами. Ниже показан формат ответа, а не результат реального вызова API.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Если вызов не удался

• При ошибке аутентификации проверьте адрес и тип учётных данных: административный доступ защищает /api, Bearer-токен runtime используется для /v1 и /mcp. API-ключ провайдера не заменяет токен runtime.
• При отказе в доступе проверьте scopes Action, правила Actions и разрешения на подключения. Даже действительный токен может не иметь доступа к выбранному аккаунту.
• Если результат пуст или ресурс отсутствует, проверьте аккаунт и его права на этот ресурс. Успешная авторизация не открывает все рабочие пространства, каналы и документы.
• Изучите ошибку и журнал до повтора. Если Action изменяет данные провайдера, сначала проверьте, не завершилась ли операция; не повторяйте запрос вслепую.

Дальнейшие шаги

Для поддерживаемых провайдеров OOMOL настраивает OAuth-приложения и управляет облачной средой. Вы по-прежнему выбираете аккаунт и подтверждаете его разрешения.