Интеграции и MCP

Интеграции дают агенту инструменты подключённых сервисов: искать сведения, читать доступные документы, создавать и изменять объекты. Набор действий зависит от конкретного подключения и прав учётной записи. Интеграция с корпоративным сервисом и API-ключ Nevel работают в противоположных направлениях: интеграция позволяет агенту обратиться к сервису, а API-ключ позволяет вашему приложению обратиться к Nevel.#

Откройте интеграции нужного пространства#

Выберите пространство в боковой панели, откройте «Управление» и вкладку «Интеграции». Используйте поиск по названию. В зависимости от конфигурации каталога вы увидите подключённые сервисы и доступные варианты подключения, категории или фильтр «Мои интеграции». Отсутствующий раздел или сообщение «Интеграции недоступны для этого рабочего пространства» означает, что возможность не включена для текущего рабочего пространства.#

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

Подключите сервис из каталога#

1. Найдите карточку сервиса и нажмите «Подключить» или откройте его настройки.
2. Пройдите предложенный способ авторизации. Для OAuth откроется страница сервиса; для других подключений форма запросит ключ или учётные данные.
3. На странице внешнего сервиса выберите нужную учётную запись и прочитайте запрашиваемые права.
4. Завершите авторизацию и вернитесь в Nevel.
5. Убедитесь, что появилась отметка «Подключено» или уведомление об успешном подключении.
6. Выполните в чате короткую задачу чтения: «Найди задачу с таким-то названием и покажи её статус и ссылку».

Каталог может включать корпоративную почту, календари, системы задач, базы знаний и другие сервисы. Наличие названия в описании продукта не заменяет карточку в вашем интерфейсе: конкретный список зависит от установки и подключённых провайдеров. Для нужного сервиса используйте доступный в каталоге вариант или собственный MCP-сервер.#

Проверочная задача чтения помогает отделить три проблемы: авторизация завершилась, инструмент доступен агенту, учётная запись действительно видит нужный объект. Сообщение «Подключено» подтверждает соединение, но не даёт аккаунту дополнительных прав в исходной системе.#

Подключите собственный MCP-сервер#

MCP — способ предоставить агенту именованные инструменты вашего сервиса. Для настройки нужен адрес сервера и предусмотренный его владельцем способ авторизации. Адрес обычной веб-страницы, REST-метода или главной страницы сервиса не становится MCP-адресом автоматически.#

Откройте «Создать свою». В диалоге «MCP-интеграция» заполните «Имя интеграции», понятное «Описание интеграции» и URL сервера. Название «Каталог оборудования» полезнее, чем «MCP 2»: агент и пользователи смогут отличить назначение подключения.#

Выберите способ передачи секрета:#

Не придумывайте названия заголовков по аналогии с другим сервисом. Ключ, выданный для Nevel API, не заменяет ключ корпоративного MCP. Секреты вводятся в поля подключения; их не нужно помещать в описание интеграции, системные инструкции или обычное сообщение чата.#

Прочитайте предупреждение в форме. Отметка «Я доверяю этому MCP-серверу» относится к выбранному вами серверу и его инструментам. Затем нажмите «Проверить соединение». Успешный ответ показывает число найденных инструментов. Ноль инструментов или ошибка означают, что полезное подключение ещё не подтверждено. Сохраните интеграцию после успешной настройки.#

Если владелец сервера изменил набор инструментов, откройте подключение и используйте «Обновить тулы». Это обновляет доступные описания действий; переименование карточки само по себе не меняет возможности сервера.#

Поставьте агенту задачу#

Укажите сервис, объект, действие и ожидаемый результат. Например:#

В подключённой системе задач найди открытые задачи проекта «Обновление каталога», изменённые за последнюю неделю. Составь таблицу: задача, ответственный, статус, ссылка. Ничего не меняй в исходной системе.#

Для изменения объектов задайте точные границы: «В задаче с указанной ссылкой замени срок на 15 сентября; остальные поля не меняй». Если сначала нужен просмотр результата, прямо попросите подготовить черновик и дождаться вашего сообщения перед записью. Интеграции могут содержать действия создания, отправки и удаления, поэтому не рассчитывайте, что любая задача автоматически ограничена чтением.#

После выполнения откройте исходный сервис и проверьте объект по ссылке. Ответ агента полезен как отчёт о работе, но для важной операции окончательным результатом является состояние в системе, где выполнялось действие. При ошибке записи сначала проверьте это состояние: повторение запроса может создать второй объект, если первая попытка частично завершилась.#

Повторная авторизация и отключение#

Если истёк доступ, используйте «Повторная авторизация» в настройках подключения. При смене корпоративного аккаунта завершите новую авторизацию под нужной учётной записью и повторите задачу чтения. Для сервиса из блока подключений доступны «Управлять» и «Отключить»; отключение лишает агента соответствующих инструментов.#

Отключение в Nevel не удаляет созданные письма, задачи или документы во внешней системе. Если требуется отозвать разрешение самого провайдера, используйте также настройки подключённых приложений в этом сервисе. Перед отключением проверьте автоматизации, использующие данное соединение: их следующий запуск может завершиться ошибкой.#

Размещение платформы и маршруты обработки#

В облаке сервис должен быть доступен из маршрута выполнения Nevel. Адрес, который открывается только с ноутбука сотрудника в VPN, не обязательно доступен серверу интеграций. Для внутреннего сервиса используйте предусмотренный организацией канал подключения.#

При установке Platform в контуре подключение может вести к внутреннему MCP-серверу и системе заказчика либо к разрешённому внешнему сервису. Для каждого подключения важны адрес, сетевой маршрут, способ авторизации, права аккаунта и передаваемые данные. Размещение самой Platform не запрещает внешнюю интеграцию и не разрешает её автоматически.#

В изолированном профиле агент использует только внутренние сервисы и внутреннюю авторизацию. Внешние OAuth-провайдеры и публичные каталоги в этот профиль не входят. Маршрут выбранной модели рассматривается отдельно от маршрута интеграции: прочитанные агентом данные могут попасть в контекст разрешённой модели. Pro и Advanced предоставляют одинаковый набор инструментов интеграции; лимиты и административные разрешения проверяются отдельно.#

Если подключение не работает#