---
author: OOMOL
author_url: https://oomol.com/ru/about/
title: Обзор Connector
description: Вызывайте Apps, подключённые к вашему аккаунту OOMOL, из
  доверенного backend-кода через hosted gateway Connector.
lang: ru
canonical_url: https://oomol.com/ru/docs/connector/
markdown_url: https://oomol.com/ru/docs/connector.md
---

# Обзор Connector

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

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

Если нужно приглашать коллег, назначать роли или управлять доступом к подключениям, см. [Управление Teams](/ru/docs/team-management/).

## Зачем использовать 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](/ru/docs/saas/) |
| Самостоятельно управлять runtime и хранением credentials | [OpenConnector](/ru/docs/openconnector/) |

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

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

Backend получает результаты операций, не читая необработанный OAuth-токен провайдера. Для получения метаданных выполнения используйте executeRaw; execute возвращает только результат операции.

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

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

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

Следуйте руководству [Вызов подключённых Apps через SDK](/ru/docs/connector-client/), чтобы установить package, создать API key, выполнить первый вызов и выбрать подключение. Общая конфигурация, обработка ошибок и полный API описаны в [справочнике TypeScript SDK](/ru/docs/connector-sdk/).

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

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