Интеграции

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

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

admin connectors 0

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

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

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

  • Авторизована — интеграция с общим типом авторизации, которая авторизована администратором.

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

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

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

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

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

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

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

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

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

admin connectors 2

Добавление интеграций происходит в витрине интеграция (Открывается по кнопке Добавить интеграцию).

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

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

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

  2. Нажмите на карточку интеграции — откроется мастер добавления интеграции.

  3. Шаг Основная информация — укажите Название и Описание.

  4. Шаг Настройка авторизации — настройте авторизацию.

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

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

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

  5. Шаг Проверка данных — проверьте данные добавляемой интеграции.

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

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

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 Интеграции:
  1. На карточке интеграции выберите:

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

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

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

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

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

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

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

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

admin connectors 1

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

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

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

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

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