Подключение AI-ассистента
MCP позволяет работать с Napulse из внешнего AI-приложения: искать сведения, читать базу знаний, готовить роботов, создавать задачи и выполнять другие разрешённые действия. Модель работает на стороне выбранного вами приложения. Для такого подключения не нужно использовать встроенного AI-ассистента CRM.
Приложение должно поддерживать удалённый MCP по Streamable HTTP и один из способов авторизации: OAuth или заголовок Authorization: Bearer. Поддержка подключения зависит от самого приложения и его настроек.
Кто может подключать
Подключать ИИ может сотрудник с правом «Подключать ИИ (MCP)» (mcp.connect). При обновлении его получили все, у кого было право «Технический блок»; руководитель может выдать его и менеджеру без технического блока, в настройках структуры (Управление → Структура → права раздела «Интеграции»). Владелец проекта, участники корневого отдела и администратор платформы имеют это право всегда.
Право «Управлять подключениями ИИ» (mcp.manage) позволяет видеть и отключать подключения всех сотрудников проекта и выключать MCP в проекте. Оно не открывает скрытые диалоги, сделки и задачи: подключение каждого сотрудника по-прежнему видит только то, что видит он сам.
Если MCP выключен в проекте или на всей платформе, на странице MCP показано объяснение, а создать подключение нельзя. Список подключений и их отключение работают. Подробнее — в разделе «Выключатели MCP».
Перед подключением
- Войдите в Napulse под своей учётной записью.
- Выберите нужный проект и откройте Интеграции → MCP.
- Проверьте название проекта и блок «Что можно подключить».
- Скопируйте адрес сервера. Один адрес используется для разных приложений; выбор проекта и прав выполняется при авторизации, а не изменением ссылки.
Не подставляйте projectId в аргументы инструментов. Подключение уже связано с конкретным проектом. Для работы с другим проектом создайте отдельное подключение.
Вход через браузер — OAuth
- Во внешнем приложении добавьте удалённый MCP-сервер по адресу из Napulse.
- Выберите авторизацию через браузер, если приложение предлагает способы входа.
- На странице Napulse проверьте название приложения и адрес возврата. Название сообщает само приложение; оно не является подтверждением его подлинности.
- Проверьте проект и выберите, что сможет ИИ (см. «Что сможет ИИ»). По умолчанию отмечено «Всё, что могу я».
- Нажмите Разрешить подключение и вернитесь во внешнее приложение.
- Проверьте доступные инструменты или выполните запрос на чтение.
После подключения приложение само обслуживает OAuth-токены. Не копируйте их в переписку с моделью.
Сколько живёт вход через браузер
- Токен доступа, который приложение получает после входа через браузер, действует 5 минут. Так и задумано: приложение само обновляет его в фоне, вам ничего делать не нужно.
- Обновлять токен приложение может до 30 дней с момента подключения. До какого числа действует вход, написано на карточке подключения (см. «Где видно подключения»). Когда срок кончится, подключите приложение заново.
- Для скрипта или своей интеграции этот токен не подходит: через 5 минут он перестанет работать. Используйте персональный ключ — он не истекает.
Подключение по API-ключу
Этот вариант нужен, если приложение позволяет задать Bearer-токен, вы пишете собственную интеграцию или запускаете скрипт. Персональный ключ создаётся в Интеграции → API, не истекает и отзывается там же. В отличие от 5-минутного токена входа через браузер, его не нужно обновлять.
- В выбранном проекте откройте Интеграции → API.
- Укажите понятное название, например «Ассистент отдела продаж».
- Выберите, что сможет ИИ: «Всё, что могу я», «Только просмотр» или «Выбрать вручную» (см. ниже). В ручном режиме чтение и изменение выдаются отдельно: для сценария «найти статью и обновить её» потребуются оба разрешения базы знаний.
- Нажмите Создать ключ.
- Сохраните секрет в защищённых настройках приложения: полностью он показывается только при создании.
- Укажите адрес MCP-сервера и авторизацию
Authorization: Bearer <ваш ключ>. - Выполните запрос каталога инструментов или попросите ассистента прочитать доступные данные.
Если поле приложения называется «Bearer token», обычно в него вставляют только ключ; если это поле произвольного заголовка, укажите имя Authorization и значение Bearer <ключ>. Не помещайте ключ в URL, текст запроса к AI или исходный код публичного приложения.
Создание ключа не делает сотрудника администратором. Действуют его текущие права в Napulse, разрешения ключа и ограничения выбранного проекта. Сам ключ не включает фоновый автоответчик: для каждой операции клиент должен вызвать соответствующий инструмент.
Персональный API-ключ не имеет срока истечения. Он работает до отзыва, пока сотрудник сохраняет необходимые права и доступ к проекту. Отозвать ключ можно там же: Интеграции → API, блок «Подключения и журнал», кнопка Отключить. Чтобы находить забытые ключи, на карточке подключения показано «Последнее использование» (см. ниже). Для смены ключа создайте новый, обновите настройки интеграции, проверьте её и отключите старый.
Лимиты вызовов
У каждого подключения два отдельных бюджета вызовов инструментов:
- чтение (поиск, карточки, списки, отчёты) — по умолчанию 120 вызовов в минуту, разово до 30 подряд;
- изменения (всё, что что-то меняет или отправляет) — 30 вызовов в минуту, разово до 10 подряд.
Исчерпанный бюджет изменений не мешает читать, и наоборот. Один вызов инструмента — одна единица бюджета, сколько бы диалогов или записей он ни обработал внутри. Если лимит исчерпан, инструмент отвечает rate_limited и пишет, через сколько секунд повторить. Подробнее — в разделе «Ошибки подключения MCP».
Что можно попросить
| Пример задачи | Разрешения подключения |
|---|---|
| «Найди инструкцию по обработке нового клиента» | knowledge:read |
| «Добавь согласованный регламент в базу знаний» | knowledge:read, knowledge:write |
| «Найди диалог клиента и подготовь ответ» | clients:read |
| «Покажи карточку клиента: кто ответственный, какие теги и откуда пришёл» | clients:read |
| «Найди диалоги второй линии, где клиент ждёт ответа больше часа» | clients:read |
| «Поставь клиенту тег vip, добавь заметку и отметь диалог прочитанным» | clients:read, clients:write |
| «Передай диалог Марии» (нужно право CRM менять ответственного) | clients:read, clients:write |
| «Переведи этого клиента на вторую линию» | clients:read, clients:write |
| «Отправь этот текст в выбранный диалог» | clients:read, clients:reply |
| «Создай черновик робота приветствия» | robots:read, robots:write |
| «На каком шаге робот теряет людей и какие там ошибки?» | robots:read, analytics |
| «Создай доску и добавь карточки плана запуска» | tasks:read, tasks:write |
| «Что у нас запланировано в SMM на неделю и какие посты не вышли?» | smm:read |
Инструмент отправки ответа действительно отправляет сообщение. Укажите конкретного получателя и согласованный текст. Созданный через MCP робот сохраняется на паузе; активация выполняется отдельным действием после проверки схемы.
Что сможет ИИ
При входе через браузер и при создании ключа есть три варианта:
- «Всё, что могу я» (по умолчанию). ИИ сможет делать всё, что можете вы в этом проекте, включая новые возможности. Права пересчитываются при каждом действии: дали вам новое право — ИИ получит его со следующего действия, забрали — потеряет сразу. Переподключать ничего не нужно. Сюда входят и действия — ответы клиентам, рассылки, правка настроек, — если они есть у вас.
- «Только просмотр». ИИ только смотрит: чтение данных и отчёты, без изменений и без сообщений клиентам. Список фиксируется в момент подключения: новые возможности просмотра такому подключению сами не добавятся. Особые разрешения (например, просмотр секретов) сюда не входят.
- «Выбрать вручную». Прежний список галочек. Опасные возможности — удаление, секреты, «войти как», пароли, ключи ИИ, SQL, оплата тарифа, каналы — показаны отдельной группой «Особые» с пояснениями, когда они доступны вам.
В любом режиме ИИ не получит больше ваших прав и доступа к другим проектам. В режиме «войти как» подключить ИИ нельзя ни в одном из вариантов.
Где видно подключения
Подключения показаны на странице Интеграции → MCP и Интеграции → API, в блоке «Подключения и журнал». В нём три вкладки:
- «Мои подключения» — ваши подключения: и вход через браузер (OAuth), и API-ключи. На карточке:
- тип: «Браузер: <название приложения>» или «API-ключ»;
- название и дата создания;
- «Последнее использование: …» или «Ещё не использовался». Время обновляется при каждом вызове ИИ, не чаще раза в минуту;
- для входа через браузер — до какого числа он действует (до 30 дней с последнего входа). Если вход истёк или приложение его отозвало, на карточке написано, что приложение нужно подключить заново;
- режим: «Всё, что могу я», «Только просмотр» или «Выбрано: N» со списком разрешений, и кнопка Отключить;
- если у вашего подключения со списком нет разрешений, которые вы можете дать сейчас, — подсказка «Переподключите, чтобы ИИ получил новые возможности». Для ключа выпустите новый в режиме «Всё, что могу я», для входа через браузер подключите приложение заново.
- «Все подключения проекта» — только у сотрудника с правом «Управлять подключениями ИИ». Подключения всех сотрудников с фильтром по сотруднику.
- «Журнал вызовов» — что делали подключения (см. ниже).
Флажок «Показать отключённые» добавляет в список уже отключённые подключения: так видно историю.
Журнал вызовов
Журнал показывает, что делал ИИ: время, сотрудник, подключение, действие простыми словами (например, «Чтение сообщений диалога», «Создание задачи», «Ответ клиенту»), объект (диалог, сделка, задача… с коротким номером) и результат: «Выполнено», «Доступ разрешён», «Отказано: нет доступа» или «Ошибка».
В журнале два вида строк:
- «Вызов инструмента» — команда, которую дал ИИ;
- «Обращение к данным» — каждый запрос к CRM, который проверил сервер, с объектом, к которому он относился. Отказы тоже записываются.
Запись «Обращение к данным» делается до того, как CRM выполнит действие. Поэтому её результат — «Доступ разрешён» или «Отказано: нет доступа», но не «Выполнено». «Доступ разрешён» значит только, что сервер пропустил запрос. Удалось ли действие (например, ушёл ли ответ клиенту), показывает результат строки «Вызов инструмента» того же действия: «Выполнено» или «Ошибка».
Если подключение работает в режиме «Всё, что могу я», рядом с его названием написано «режим «Всё, что могу я»».
Тексты сообщений, аргументы команд и их отпечатки в журнал на экране не выводятся. Записи хранятся 180 дней и не удаляются при отключении подключения.
Фильтры: сотрудник (только с правом «Управлять подключениями ИИ»), подключение, период, вид записей и «Только ошибки и отказы». По умолчанию показаны подключения ИИ; записи роботов — по выбору «Роботы» или «Все записи». На телефоне журнал показан карточками.
Свой журнал видит каждый, кто может подключать ИИ. Журнал всего проекта — сотрудник с правом «Управлять подключениями ИИ». Журнал работает и при выключенном MCP.
Как отключить подключение
Откройте Интеграции → MCP или Интеграции → API, найдите подключение в блоке «Подключения и журнал», нажмите Отключить и подтвердите действие. Так отключаются и API-ключи, и вход через браузер. Следующие запросы этого подключения будут отклонены. Для восстановления создайте новый ключ или подключите приложение заново.
Сотрудник управляет своими подключениями. Сотрудник с правом «Управлять подключениями ИИ» (mcp.manage) видит и может отключить также подключения других сотрудников проекта (вкладка «Все подключения проекта»); это право не нужно для отключения собственных подключений. В режиме «войти как» список и отключение работают, создание — нет. Отключение не отменяет уже выполненные действия и не удаляет данные, которые внешнее приложение успело получить.
Как выключить MCP во всём проекте
Сотрудник с правом «Управлять подключениями ИИ» открывает Интеграции → MCP и выключает переключатель в блоке «MCP в проекте». Сразу перестают работать все подключения ИИ этого проекта. Ключи не удаляются: после включения подключения заработают снова. Переключать MCP в режиме «войти как» нельзя.
Если подключение не работает
- Нет адреса сервера — проверьте настройку MCP.
- Не видны нужные действия — сверьте разрешения и каталог.
- Нужно написать свою интеграцию — используйте примеры API-запросов.
- Требуется понять, какие данные увидит приложение — прочитайте правила доступа.