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

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

Обновлено: 2026-11-02
Источник: https://docs.nevel.sh/platform/integrations/


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

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

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

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

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

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

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

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

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

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

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

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

| Тип | Что ввести |
| --- | --- |
| Bearer | Ключ, который сервер ожидает как Bearer-токен |
| Header | Имя и значение заголовка, предусмотренные сервером |
| Несколько заголовков | Добавьте необходимые пары через «Добавить заголовок» |

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

| Симптом | Следующий шаг |
| --- | --- |
| «Сессия подключения истекла» | Начните подключение заново из карточки, не используйте старую вкладку авторизации |
| Ошибка проверки MCP | Проверьте точный MCP URL, тип авторизации и доступность сервера из среды Nevel |
| Инструменты есть, нужный объект не найден | Проверьте аккаунт, права в исходном сервисе и точность имени или ссылки |
| После изменения сервера нет нового действия | Выполните «Обновить тулы» и повторите задачу |
| Действие вернуло ошибку после отправки | Сначала посмотрите состояние объекта в исходном сервисе, затем решайте, нужен ли повтор |
| Карточки не загрузились | Обновите страницу; при повторении передайте администратору время и текст ошибки без токена |