Обзор Connector

OOMOL Connector — это hosted-сервис подключений для отдельных пользователей и команд. Подключите Apps, например Gmail, GitHub, Notion или Slack, а затем используйте разрешённые actions из Agent или доверенного backend, пока OOMOL управляет OAuth, хранением credentials, обновлением токенов и выполнением actions.

Этот путь использует personal API key вида api_…. Храните ключ в backend environment или менеджере секретов.

Если нужно приглашать коллег, назначать роли или управлять доступом к подключениям, см. Управление Teams.

Зачем использовать OOMOL Connector

Одно подключение для нескольких сред: вызывайте одно подключение App через oo CLI, MCP или SDK и повторно используйте его в поддерживаемых Agents.
Меньше операций аутентификации: OOMOL управляет процессами OAuth, хранением credentials и обновлением токенов.
Защита credentials аккаунтов: Agents, Skills и код приложения используют разрешённые actions, не получая необработанные OAuth-токены.
Точный контроль доступа: настройте actions, разрешённые для каждого подключения, и участников Team, которые могут его использовать.
Поддержка пользователей и команд: отдельные пользователи могут подключать собственные Apps, а команды — совместно использовать подключения и управлять доступом участников.

Выберите подходящий путь Connector

Задача	Путь
Вызывать Apps, подключённые к аккаунту OOMOL	Hosted-клиент `Connector`
Позволить каждому пользователю продукта подключить собственный аккаунт	Интеграция SaaS
Самостоятельно управлять runtime и хранением credentials	OpenConnector

Как выполняется вызов

Подключите аккаунт App в OOMOL.
Создайте personal Connector API key в OOMOL Console.
Инициализируйте @oomol-lab/connector в доверенном backend-коде.
Выберите action и при необходимости именованное подключение.
Connector вызывает провайдера и возвращает результат action.

Backend получает результаты actions и execution metadata, не читая необработанный OAuth-токен провайдера.

Возможности SDK

Задача	API SDK
Выполнить смоделированную операцию	`execute` или `executeRaw`
Вызвать endpoint без смоделированного action	`proxy`
Найти провайдеров и схемы actions	`catalog`
Получить список подключённых аккаунтов	`apps.list`

Начните разработку

Следуйте руководству Вызов подключённых Apps через SDK, чтобы установить package, создать API key, выполнить первый вызов и выбрать подключение. Общая конфигурация, обработка ошибок и полный API описаны в справочнике TypeScript SDK.

Храните ключ на backend

Не включайте personal API key в browser bundles, публичные репозитории, prompts или client-side logs. Используйте проект Connector SaaS, когда запросы должны быть ограничены отдельными пользователями продукта; не передавайте один personal key несвязанным конечным пользователям.