Выбор пути интеграции

Выбирайте путь в зависимости от владельца подключённого аккаунта, места выполнения вызовов и оператора границы credentials.

Сравнение четырёх путей

Путь	Владелец подключённого аккаунта	Маршрут вызовов	Чем вы управляете
Настройка Agent	Вы	oo CLI или OOMOL MCP	Окружение Agent
Hosted Connector SDK	Вы	Hosted gateway OOMOL	Код backend
Проект Connector SaaS	Каждый пользователь продукта	Hosted gateway OOMOL	Продукт и сопоставление пользователей
Самостоятельно размещённый OpenConnector	Вы или ваша организация	Ваш runtime OpenConnector	Runtime, хранилище, безопасность и обновления

Использование OOMOL из Agent

Выберите этот путь, если хотите, чтобы Codex, ChatGPT, Claude Code или другой поддерживаемый Agent работал с подключёнными вами Apps.

Вам потребуется:

Подключить App в OOMOL.
Установить oo CLI в Agent или настроить MCP-клиент.
Попросить Agent использовать подключённое App.

Начните с Быстрого старта.

Вызов собственных подключений из backend-кода

Выберите hosted-клиент Connector, когда доверенному backend нужно вызывать Apps, подключённые к вашему аккаунту OOMOL.

Этот путь использует personal API key вида api_…. Ключ хранится на backend и разрешает вызовы в ваших подключениях.

Прочитайте руководство по OOMOL Connector SDK.

Подключение аккаунтов конечных пользователей

Выберите Connector for SaaS, когда каждому пользователю продукта нужно авторизовать собственный аккаунт Gmail, Slack, Notion или другого провайдера.

Backend создаёт authorization links, хранит ваш ID пользователя рядом с полученным ID подключённого аккаунта и выполняет actions для этого пользователя. Этот путь использует project API key вида oo_proj_….

Прочитайте руководство Connector for SaaS.

Самостоятельный запуск OpenConnector

Выберите self-hosting, когда ваша команда должна управлять runtime, базой данных, шифрованием credentials, сетевым доступом, журналами и процессом обновления.

Runtime clients могут использовать токен вида oct_…. OAuth apps провайдеров, ключи шифрования, хранилище, резервные копии и политика actions остаются вашей ответственностью.

Прочитайте руководство по самостоятельному размещению OOMOL OpenConnector.

Scope credentials по продуктам

Credential	Используется	Scope
`api_…`	Hosted-клиент `Connector`	Ваши personal connections
`oo_proj_…`	`ProjectConnector` и API SaaS	Один проект Connector и его конечные пользователи
`oct_…`	Клиент `OpenConnector`, HTTP или MCP	Один самостоятельно размещённый runtime

Храните все три типа credentials в доверенном backend, менеджере секретов или защищённом окружении Agent. Не помещайте их в browser bundles, публичные репозитории или prompts.

Три вопроса для выбора

Кому принадлежит подключаемый аккаунт? Для вашего аккаунта подходит настройка Agent или personal SDK. Для аккаунтов конечных пользователей — проект SaaS.
Кто должен управлять хранением credentials и обновлением токенов? Используйте hosting OOMOL, чтобы сократить операционную нагрузку; выбирайте self-hosting, когда команда должна владеть этой границей.
Где будут вызываться actions? Для интерактивной работы Agent используйте его настройку, а для вызовов backend продукта — SDK или HTTP.

После выбора пути выполните его Быстрый старт, прежде чем добавлять других провайдеров или production policy.