Интеграции

В разделе button settings Администрирование → button blocks Интеграции можно определять, какие интеграции будут доступны пользователям для подключения в разделе button blocks Интеграции. А также настраивать инструменты интеграций.

Обзор раздела

admin connectors 0

Интеграции в разделе отображаются в виде карточек.
Их можно найти по названию и отфильтровать по типу, статусу и категории.

Типы интеграций:

Подробнее про собственные и встроенные интеграции.

Статусы интеграций:
  • Доступные — невидимые для пользователей интеграции, которые можно подключить и сделать видимыми.

  • Подключенные — видимые для пользователей интеграции, в которых они могут авторизоваться и использовать в чате.

  • Авторизованные — видимые и авторизованные администратором интеграции. Уже готовые к использованию в чате.

Типы интеграций

GigaCowork поставляется с комплектом предустановленных интеграций. Но также есть возможность добавить собственную интеграцию.

Предустановленные интеграции уже находятся в разделе и по умолчанию выключены. Свои интеграции добавляются из витрины, после добавления они также выключены. Чтобы интеграция стала доступна пользователям, ее нужно включить.

Типы аккаунтов: общий и индивидуальный

В GigaCowork есть два типа авторизации в интеграциях:

  • Индивидуальный, когда каждый пользователь авторизуется самостоятельно под своей учетной записью внешней системы. Сделать это можно в разделе button grid 2x2 Каталоги → button blocks Интеграции, доступном в основном меню, или в окне задачи.

  • Общий, когда в интеграции авторизуется только администратор, таким образом интеграция становится доступна всем пользователям под единой корпоративной учетной записью. Сделать это можно в разделе button settings Администрирование → button blocks Интеграции.

    При этом кнопка авторизации и выхода из аккаунта недоступна обычным пользователям.

Для встроенных интеграций способ авторизации выбирается при включении интеграции. Для собственных интеграций он задается на этапе добавления из витрины.

Добавление собственной интеграции

admin connectors 2

GigaCowork позволяет добавить собственную интеграцию в систему через витрину интеграций.

Способ авторизации (общий или индивидуальный аккаунт) выбирается на этапе добавления из витрины — до того, как интеграция появится в разделе Интеграции. Он определяет порядок дальнейшего включения интеграции.
Для добавления собственной интеграции:
  1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию — откроется Витрина интеграций.

  2. Нажмите Добавить свою интеграцию — откроется мастер добавления интеграции, где пошагово потребуется указать ее данные.

  3. Шаг Подключение к MCP-серверу — укажите URL удаленного MCP-сервера — в формате https://mcp.example.ru/mcp.

  4. Шаг Основная информация — укажите Название и Описание. В описании коротко опишите возможности и инструменты интеграции, какие основные задачи она решает. По этим ключевым фразам ИИ-агент будет понимать, что необходимо подключить данную интеграцию. Например, Добавь событие в календарь — для интеграции календаря. Описание отображается в карточке интеграции.

    После ввода основной информации могут идти индивидуальные шаги с настройками, которые передал MCP-сервер.
  5. Шаг Настройка авторизации — настройте авторизацию.

    • Тип аутентификации — способ авторизации подключаемого MCP-сервера:

      • Никакой — пользователь авторизуется в интеграции без ввода данных.

      • Логин и пароль— пользователь указывает логин и пароль.

      • Токен доступа — пользователь указывает токен доступа.

      • Пользовательские заголовки — позволяет добавить произвольные поля на форму авторизации. Для добавления нового поля нажмите button plus Добавить заголовок.

      • OAuth 2.0 — открытый стандарт авторизации, который позволяет приложениям получать ограниченный доступ к защищенным ресурсам от имени пользователя, не передавая ему логин и пароль. Набор полей зависит от выбранного сценария.

        Нажмите, чтобы раскрыть

        После выбора типа аутентификации OAuth2.0 необходимо указать сценарий регистрации, который определяет поток получения токенов доступа.

        Authorization Code (Код авторизации)

        Пользователь самостоятельно проходит процедуру авторизации через браузер. Этот сценарий рекомендуется для интерактивных приложений, где требуется явное согласие пользователя на предоставление прав доступа.

        • Идентификатор приложения — уникальный идентификатор клиента (Client ID), выданный провайдером OAuth2.0.

        • Секретный ключ приложения — секретный ключ клиента (Client Secret) для аутентификации приложения.

        • Адрес авторизации — URL конечной точки авторизации провайдера (Authorization Endpoint).

        • Адрес получения токена — URL конечной точки для получения токена (Token Endpoint).

        • Запрашиваемые права — список scope’ов (областей доступа), запрашиваемых у провайдера (например: read, write, offline_access).

        • Адрес отзыва токена — URL конечной точки для отзыва токена (Revocation Endpoint).

        • Защита входа (PKCE) — механизм Proof Key for Code Exchange для дополнительной защиты от перехвата кода авторизации.

        Client Credentials (Учетные данные клиента)

        Аутентификация происходит без участия пользователя. Приложение использует свои учетные данные для получения токена доступа. Подходит для сервер-серверных интеграций и фоновых задач.

        • Идентификатор приложения — уникальный идентификатор клиента (Client ID), выданный провайдером OAuth2.0.

        • Секретный ключ приложения — секретный ключ клиента (Client Secret) для аутентификации приложения.

        • Адрес получения токена — URL конечной точки для получения токена (Token Endpoint).

        • Запрашиваемые права — список scope’ов (областей доступа), запрашиваемых у провайдера.

        • Адрес отзыва токена — URL конечной точки для отзыва токена (Revocation Endpoint).

        Логин/пароль (ROPC — Resource Owner Password Credentials)

        Приложение напрямую передает логин и пароль пользователя провайдеру для получения токена. Не рекомендуется к использованию из-за сниженной безопасности — приложение получает доступ к учетным данным пользователя.

        • Идентификатор приложения — уникальный идентификатор клиента (Client ID), выданный провайдером OAuth2.0.

        • Секретный ключ приложения — секретный ключ клиента (Client Secret) для аутентификации приложения.

        • Адрес получения токена — URL конечной точки для получения токена (Token Endpoint).

        • Запрашиваемые права — список scope’ов (областей доступа), запрашиваемых у провайдера.

        • Адрес отзыва токена — URL конечной точки для отзыва токена (Revocation Endpoint).

        • Параметры запроса — дополнительные параметры, передаваемые в теле запроса (query parameters).

        • Заголовки запроса — пользовательские HTTP-заголовки для запроса токена.

        Сценарий ROPC передает учетные данные пользователя непосредственно приложению, что:
        • Нарушает принцип разделения ответственности.

        • Не поддерживает многофакторную аутентификацию.

        • Требует высокого уровня доверия к приложению.

        • Может быть заблокировано некоторыми провайдерами.

    • Способ авторизации.

      • Индивидуальный — каждый пользователь авторизуется в интеграции с собственной учетной записью.

      • Общий — администратор авторизуется в интеграции, и она становится доступна всем пользователям под его учетной записью.

  6. Шаг Проверка данных — проверьте данные подключаемой интеграции.

После добавления интеграция появляется в разделе button settings Администрирование → button blocks Интеграции со статусом Доступные и остается выключенной.

Включение интеграции

Включить (подключить) интеграцию — значит сделать ее видимой и доступной пользователям.

Для включения интеграции, в разделе button settings Администрирование → button blocks Интеграции:
  1. Выберите фильтр Доступные — отобразятся доступные для добавления интеграции.

  2. На карточке интеграции выберите:

    • button ellipsis vertical → button power Включить — чтобы включить интеграцию, в которой пользователи будут авторизовываться самостоятельно в разделе button blocks Интеграции.

    • button ellipsis vertical → button power Включить и авторизоваться — чтобы включить интеграцию и авторизоваться под общим аккаунтом. После авторизации администратором интеграция автоматически становится доступна всем пользователям — им не нужно авторизовываться.

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

Авторизация в интеграции

Для авторизации в интеграции под единой учетной записью для всех пользователей:
  1. В разделе button settings Администрирование → button blocks Интеграции выберите фильтр Доступные и нажмите на карточку нужной интеграции.

  2. Нажмите Подключить и войти в аккаунт — откроется форма авторизации. У каждой интеграции своя форма авторизации.

  3. Укажите данные для авторизации и нажмите Продолжить.

Во время авторизации могут появляться всплывающие окна. Убедитесь, что ваш браузер не блокирует их.
После авторизации администратором под единой учетной записью, все пользователи переходят на использование интеграции под этой учетной записью — даже те, кто до этого авторизовывался индивидуально. Снова авторизоваться индивидуально в такой интеграции получится только после выхода администратора из учетной записи интеграции.

Выход из аккаунта интеграции

Для выхода из аккаунта интеграции, в разделе button settings Администрирование → button blocks Интеграции откройте карточку интеграции и нажмите Выйти из аккаунта.

Отключение интеграции

Для того чтобы отключить подключенную для пользователей интеграцию, в разделе button settings Администрирование → button blocks Интеграции, в карточке интеграции выберите button ellipsis vertical → button power off Отключить.

Отключенную интеграцию затем снова можно включить. Пользователям при этом придется заново авторизоваться в ней.

Что видит пользователь после включения

  • Если интеграция работает под индивидуальным аккаунтом, каждый пользователь авторизуется в ней самостоятельно — в разделе button grid 2x2 Каталоги → button blocks Интеграции, доступном в основном меню, или в окне задачи.

  • Если интеграция работает под общим аккаунтом, пользователям ничего делать не нужно: после авторизации администратором интеграция сразу готова к использованию в чате. Кнопки авторизации и выхода из аккаунта обычным пользователям недоступны.

Настройка инструментов интеграции

admin connectors 1

Инструменты — это список доступных действий конкретной интеграции, которые находятся в ее карточке. С помощью инструментов можно ограничивать права интеграции, запретив совершать через нее определенные действия.

При этом интеграция не расширяет права учетной записи: доступны только те действия, которые разрешены во внешней системе. Например, если в CRM разрешен только просмотр, то и через интеграцию возможно только чтение, даже при включенном инструменте редактирования.

Инструменты предустановленных интеграций отображаются после их подключения, инструменты созданных MCP-интеграций отображаются после авторизации.
Настройка инструментов интеграции выполняется на двух уровнях:
  • Администратор (в разделе button settings Администрирование → button blocks Интеграции) задает общий набор инструментов, доступных пользователям, и может отключать любые из них.

  • Пользователь (в разделе button grid 2x2 Каталоги → button blocks Интеграции) настраивает только те инструменты, которые администратор включил. Если инструмент выключен администратором, пользователь не может его активировать.

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