Интеграции
В разделе
Администрирование →
Интеграции можно определять, какие интеграции будут доступны пользователям для подключения в разделе
Интеграции. А также настраивать инструменты интеграций.
Обзор раздела
Интеграции в разделе отображаются в виде карточек.
Их можно найти по названию и отфильтровать по типу, статусу и категории.
-
Собственные — подключенные собственные MCP-интеграции.
-
Встроенные — предустановленные интеграции.
Подробнее про собственные и встроенные интеграции.
-
Доступные — невидимые для пользователей интеграции, которые можно подключить и сделать видимыми.
-
Подключенные — видимые для пользователей интеграции, в которых они могут авторизоваться и использовать в чате.
-
Авторизованные — видимые и авторизованные администратором интеграции. Уже готовые к использованию в чате.
Типы интеграций
GigaCowork поставляется с комплектом предустановленных интеграций. Но также есть возможность добавить собственную интеграцию.
Предустановленные интеграции уже находятся в разделе и по умолчанию выключены. Свои интеграции добавляются из витрины, после добавления они также выключены. Чтобы интеграция стала доступна пользователям, ее нужно включить.
Типы аккаунтов: общий и индивидуальный
В GigaCowork есть два типа авторизации в интеграциях:
-
Индивидуальный, когда каждый пользователь авторизуется самостоятельно под своей учетной записью внешней системы. Сделать это можно в разделе
Каталоги →
Интеграции, доступном в основном меню, или в окне задачи. -
Общий, когда в интеграции авторизуется только администратор, таким образом интеграция становится доступна всем пользователям под единой корпоративной учетной записью. Сделать это можно в разделе
Администрирование →
Интеграции.При этом кнопка авторизации и выхода из аккаунта недоступна обычным пользователям.
Для встроенных интеграций способ авторизации выбирается при включении интеграции. Для собственных интеграций он задается на этапе добавления из витрины.
Добавление собственной интеграции
GigaCowork позволяет добавить собственную интеграцию в систему через витрину интеграций.
| Способ авторизации (общий или индивидуальный аккаунт) выбирается на этапе добавления из витрины — до того, как интеграция появится в разделе Интеграции. Он определяет порядок дальнейшего включения интеграции. |
-
В разделе
Администрирование →
Интеграции нажмите Добавить интеграцию — откроется Витрина интеграций. -
Нажмите Добавить свою интеграцию — откроется мастер добавления интеграции, где пошагово потребуется указать ее данные.
-
Шаг Подключение к MCP-серверу — укажите URL удаленного MCP-сервера — в формате
https://mcp.example.ru/mcp. -
Шаг Основная информация — укажите Название и Описание. В описании коротко опишите возможности и инструменты интеграции, какие основные задачи она решает. По этим ключевым фразам ИИ-агент будет понимать, что необходимо подключить данную интеграцию. Например, Добавь событие в календарь — для интеграции календаря. Описание отображается в карточке интеграции.
После ввода основной информации могут идти индивидуальные шаги с настройками, которые передал MCP-сервер. -
Шаг Настройка авторизации — настройте авторизацию.
-
Тип аутентификации — способ авторизации подключаемого MCP-сервера:
-
Никакой — пользователь авторизуется в интеграции без ввода данных.
-
Логин и пароль— пользователь указывает логин и пароль.
-
Токен доступа — пользователь указывает токен доступа.
-
Пользовательские заголовки — позволяет добавить произвольные поля на форму авторизации. Для добавления нового поля нажмите
Добавить заголовок. -
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 передает учетные данные пользователя непосредственно приложению, что:-
Нарушает принцип разделения ответственности.
-
Не поддерживает многофакторную аутентификацию.
-
Требует высокого уровня доверия к приложению.
-
Может быть заблокировано некоторыми провайдерами.
-
-
-
Способ авторизации.
-
Индивидуальный — каждый пользователь авторизуется в интеграции с собственной учетной записью.
-
Общий — администратор авторизуется в интеграции, и она становится доступна всем пользователям под его учетной записью.
-
-
-
Шаг Проверка данных — проверьте данные подключаемой интеграции.
После добавления интеграция появляется в разделе
Администрирование →
Интеграции со статусом Доступные и остается выключенной.
Включение интеграции
Включить (подключить) интеграцию — значит сделать ее видимой и доступной пользователям.
Администрирование →
Интеграции:-
Выберите фильтр Доступные — отобразятся доступные для добавления интеграции.
-
На карточке интеграции выберите:
-
→
Включить — чтобы включить интеграцию, в которой пользователи будут авторизовываться самостоятельно в разделе
Интеграции. -
→
Включить и авторизоваться — чтобы включить интеграцию и авторизоваться под общим аккаунтом. После авторизации администратором интеграция автоматически становится доступна всем пользователям — им не нужно авторизовываться.
-
| В зависимости от типа авторизации коннектора, может быть доступен только один способ включения. |
Авторизация в интеграции
-
В разделе
Администрирование →
Интеграции выберите фильтр Доступные и нажмите на карточку нужной интеграции. -
Нажмите Подключить и войти в аккаунт — откроется форма авторизации. У каждой интеграции своя форма авторизации.
-
Укажите данные для авторизации и нажмите Продолжить.
| Во время авторизации могут появляться всплывающие окна. Убедитесь, что ваш браузер не блокирует их. |
| После авторизации администратором под единой учетной записью, все пользователи переходят на использование интеграции под этой учетной записью — даже те, кто до этого авторизовывался индивидуально. Снова авторизоваться индивидуально в такой интеграции получится только после выхода администратора из учетной записи интеграции. |
Что видит пользователь после включения
-
Если интеграция работает под индивидуальным аккаунтом, каждый пользователь авторизуется в ней самостоятельно — в разделе
Каталоги →
Интеграции, доступном в основном меню, или в окне задачи. -
Если интеграция работает под общим аккаунтом, пользователям ничего делать не нужно: после авторизации администратором интеграция сразу готова к использованию в чате. Кнопки авторизации и выхода из аккаунта обычным пользователям недоступны.
Настройка инструментов интеграции
Инструменты — это список доступных действий конкретной интеграции, которые находятся в ее карточке. С помощью инструментов можно ограничивать права интеграции, запретив совершать через нее определенные действия.
При этом интеграция не расширяет права учетной записи: доступны только те действия, которые разрешены во внешней системе. Например, если в CRM разрешен только просмотр, то и через интеграцию возможно только чтение, даже при включенном инструменте редактирования.
| Инструменты предустановленных интеграций отображаются после их подключения, инструменты созданных MCP-интеграций отображаются после авторизации. |
-
Администратор (в разделе
Администрирование →
Интеграции) задает общий набор инструментов, доступных пользователям, и может отключать любые из них. -
Пользователь (в разделе
Каталоги →
Интеграции) настраивает только те инструменты, которые администратор включил. Если инструмент выключен администратором, пользователь не может его активировать.
Для настройки инструментов интеграции администратором, откройте подключенную интеграцию и включите или выключите необходимые инструменты.
WARNING: При этом инструменты интеграции поменяются и у пользователей, независимо от того, авторизованы они в интеграции или нет.
