ДокументацияЛюди и права

Агенты (MCP)

для администратора школыПройти по шагам в Академии

Агент — это ИИ-ассистент, которому вы выдали доступ к TERVIO проекта. С ним можно спросить у TERVIO цифры и настройки прямо в чате с ассистентом: «какая скорость ответов за неделю», «покажи схему воронки группового чата», «кто из сотрудников сейчас перегружен» — или попросить собрать воронку.

Раздел «Агенты» есть в каждом проекте. Видят его только администраторы: они заводят агентов, выдают и отзывают ключи.

Как подключить по ключу

  1. «Добавить агента» — назовите его так, чтобы в журнале было понятно, чей он: «Claude Анны», «Отчёты для руководителя». Сразу после этого откроется выдача ключа.
  2. «Выдать ключ» — название ключа, права по разделам (подробнее — ниже), срок (30, 90, 180 или 365 дней) и, если нужно, адреса, с которых ключом можно пользоваться: до 20, по адресу или подсети в строке. Пусто — с любого адреса.
  3. Выберите, как подключать: «Промпт для агента» — один текст, который вы отправляете своему ассистенту, и он подключается сам; или «Настроить вручную» — команда для Claude Code и настройки для Cursor и Claude Desktop. Ключ показывается один раз: потеряли — отзовите его и выдайте новый.

Кнопкой в ChatGPT и Claude

Ключ копировать не нужно: приложение само откроет TERVIO, а вы выберете, что ему разрешить. Адрес сервера скопируйте из карточки «Подключить в чате ChatGPT или Claude — без ключа» в разделе «Агенты».

В ChatGPT

  1. В ChatGPT слева откройте «Плагины», справа вверху нажмите «Добавить» и выберите «Добавить пользовательский сервер MCP».
  2. Название — например, «TERVIO». В поле «Подключение» вставьте адрес сервера, в поле «Аутентификация» оставьте OAuth.
  3. Раскройте «Расширенные настройки OAuth» и в поле «Способ регистрации» выберите динамическую регистрацию клиента (DCR). Другие варианты с TERVIO не сработают. Области доступа и остальные поля не меняйте.
  4. Отметьте согласие в предупреждении внизу и нажмите «Создать в виде плагина».
  5. В чате наберите @ и выберите TERVIO.

Кнопка «Создать в виде плагина» не нажимается или TERVIO пишет «Подключение не создано» — значит, в «Способе регистрации» выбран не DCR. Пользовательскому клиенту OAuth нужен идентификатор, которого у TERVIO нет, а вариант по умолчанию ChatGPT не может пройти проверку TERVIO. Переключите на DCR, а если плагин уже создан, удалите его в «Плагинах» и создайте заново.

В Claude

  1. В claude.ai или в приложении Claude откройте «Настройки» → «Коннекторы» и нажмите «Добавить пользовательский коннектор» (Add custom connector).
  2. Название — например, «TERVIO», в поле адреса вставьте адрес сервера.
  3. Ничего не меняйте: в «Authentication» — «Sign in now», в «OAuth client» — «Use Claude's published identity» (оба помечены «Detected»). «Request headers» и «Advanced» не трогайте. Нажмите «Add».
  4. В чате нажмите «+» внизу слева → Connectors и включите TERVIO.

На бесплатном тарифе Claude можно добавить один свой коннектор. В Team и Enterprise его добавляет владелец организации, а остальные нажимают «Connect» у TERVIO.

Что будет в TERVIO

После создания коннектора приложение откроет TERVIO проекта: ChatGPT — сразу, Claude — сразу или при первом обращении. Если вы ещё не вошли, войдите под администратором — после входа вернётесь к подключению. На странице видно, какой сайт просит доступ и куда вы вернётесь после решения. Проверьте адрес: название приложение указывает само. Если доступ просит программа на вашем компьютере (Claude Code, Cursor), TERVIO предупредит об этом — разрешайте, только если подключение начали вы сами.

В блоке «Кому выдать доступ» выберите существующего агента или «Новый агент», выберите уровни по разделам — так же, как при выдаче ключа, — и задайте срок. Галочка «Доверенный ключ — не спрашивать меня» снимает подтверждение с воронок, справочников и рассылок — подробнее ниже. Нажмите «Разрешить доступ» — вернётесь в приложение. Передумали — нажмите «Отказать».

Подключение появится у выбранного агента как ключ с пометкой OAuth и адресом приложения. Чтобы закрыть доступ, в TERVIO откройте «Агенты», найдите этот ключ и нажмите «Отозвать» или «Удалить» — доступ прекратится сразу. После окончания выбранного срока подключите приложение заново.

Права ключа: уровни по разделам

У каждого раздела — свой уровень, и каждый следующий включает предыдущий:

  • Нет доступа — раздела для агента нет: его инструментов агент даже не видит.
  • Только смотреть — видит, ничего не меняет.
  • Создавать и редактировать новое — создаёт новое — воронки, теги, черновики рассылок, сайты, — а менять, запускать и публиковать может только то, что создал сам. Удалять не может, даже своё. «Своё» — созданное этим агентом любым его ключом. Воронку, тег или сайт, которые завёл человек или другой агент, он не тронет и скажет, что для этого нужно поднять права ключа до «полный доступ».
  • Полный доступ — всё в разделе: меняет, запускает и публикует что угодно, удаляет.

У аналитики и переписки есть только «только смотреть». У сотрудников и ботов «полный доступ» — менять любое: удалять там нечего. Ключи, выданные до уровней, работают как раньше: изменения раздела стали «полным доступом», чтение — «только смотреть». У ключа, где уже выбран промежуточный уровень «менять любое, без удаления», он остаётся в списке, пока его не поменяют. Подтверждения от уровня не зависят: опасное агент делает только с вашего «Разрешить», даже если уровень позволяет.

Изменить права без нового ключа

В строке ключа нажмите «Изменить права»: уровни по разделам, доверенность, срок и адреса. Ключ и подключение в приложении остаются прежними — новые права действуют со следующего обращения агента. Запрос, который уже ждёт «Разрешить», TERVIO сверит с новыми правами: если их понизили, выполнить его не получится — поднимите права или отклоните запрос. У подключения из claude.ai и ChatGPT права меняются так же, только адресов у него нет. Каждое изменение записывается в «Журнал»: что было и что стало.

Что агент может смотреть

Только разделы, где уровень не ниже «только смотреть». У нового ключа это все разделы, кроме переписки, рассылок и сайтов:

  • Аналитика — скорость ответов, нагрузка по сотрудникам, день команды, дашборды, итоги рассылок.
  • Сценарии — список воронок, их схемы, папки и настройки листа, имена переменных из карточек клиентов.
  • Сотрудники — имена, роли, права, ответственные и отдел продаж, активность — без логинов и Telegram.
  • Боты — список ботов и их состояние; токены скрыты.
  • Справочники — теги, этапы, шаблоны ответов и папки чатов.
  • Переписка — список чатов и сообщения в них — то, что уже есть в TERVIO. Это личные данные клиентов, поэтому у нового ключа здесь «нет доступа», пока вы не выберете уровень сами.
  • Рассылки — итоги рассылок и подсчёт аудитории — сколько человек получит рассылку с таким фильтром.
  • Сайты — сайты проекта, их страницы и версии, ответы форм. Есть, когда в проекте подключён модуль «Сайты».

Что агент может менять

Только в разделах с уровнем «создавать и редактировать новое» и выше, по умолчанию их нет. На уровне «создавать и редактировать новое» правка, запуск и публикация касаются только созданного самим агентом, а удаление закрыто. Безопасное агент делает сам, опасное — только с вашего разрешения:

  • Сценарии — сам: новая воронка (всегда выключенной), схема и настройки выключенной воронки, название, папки, копии. С разрешения: включить или выключить воронку, изменить включённую, сохранить схему с вебхуком, удалить воронку, перенести человека в другой блок. Удалить блок, на котором стоят люди, агент может, только перенеся их на другой блок или прямо согласившись остановить их воронку.
  • Файлы — сам: загрузить файл для блока «Медиа» — по прямой ссылке или по одноразовой ссылке на загрузку, которую агент даст вам: она живёт 30 минут. Файл, приложенный в чате claude.ai, агенту не передаётся — для этого и нужна ссылка; ChatGPT приложенный файл передаёт сам. Фото jpg, png, webp, gif; видео mp4, mov; аудио mp3, m4a; голосовое ogg; документы pdf, docx, xlsx, pptx, zip. Тип TERVIO определяет по содержимому файла. До 10 МБ каждый, до 10 файлов в блоке и до 30 загрузок в сутки на ключ. В воронку файл попадает вместе со схемой — с теми же разрешениями, что выше.
  • Справочники — сам: создать теги, этапы, шаблоны и папки чатов, изменить теги, этапы и шаблоны. С разрешения: удалить тег, этап или шаблон.
  • Рассылки — сам: черновик — текст с кнопками или блок воронки — и подсчёт аудитории. С разрешения: запуск и удаление черновика.
  • Сотрудники — всегда с разрешения: приглашение ссылкой, роль, права, включение и выключение, отметки «Ответственный» и «Отдел продаж». Трогать других агентов и самого себя агент не может.
  • Боты — всегда с разрешения: подключение по токену и переподключение.
  • Сайты — сам: завести сайт, сохранить страницу черновиком (готовый HTML — анкета, прайс, лендинг, что угодно), загрузить картинку. Всегда с разрешения: первая публикация сайта и каждой новой страницы, страница с формой и свой домен. С разрешения: обновить уже опубликованную страницу (доверенный ключ публикует сам) и снять страницу. Поля пароля и данных карты на сайте запрещены.

Агенту доступен весь конструктор: блоки, теги, вычисления, вебхуки и мини-приложения. Большой лист он читает частями, а одно поле блока правит, не пересылая схему целиком. Адреса и ключи вебхуков агент не видит, при сохранении TERVIO оставляет их как были. Две вещи он делает только после вашего «Разрешить», даже с доверенным ключом:

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

Изменений у одного ключа — не больше 300 в сутки, обращений — не больше 60 в минуту.

Запросы: «Разрешить» и «Отклонить»

Когда агент хочет сделать опасное, TERVIO не выполняет это сразу, а создаёт запрос. Он появляется наверху раздела «Агенты» в блоке «Запросы агентов»: кто просит, что именно и почему нужно ваше решение, а под «Что именно передаст агент» — данные, которые уйдут в TERVIO. У воронок рядом есть кнопка «Открыть воронку» — посмотрите схему, прежде чем разрешать. Переключатель «Ждут решения / История» показывает очередь или прошлые решения.

  • Разрешить — TERVIO выполняет запрос от имени агента — только если его ключ ещё действует, агент включён и права ключа по-прежнему позволяют это действие.
  • Отклонить — ничего не происходит, агент узнаёт об отказе.
  • Без решения — через сутки запрос сгорает: обстоятельства могли измениться.

Уведомление о новом запросе включается в настройках уведомлений — событие «ИИ-агент просит подтверждения», само оно не включено. Обычно оно не нужно: агент сам скажет вам в чате, что ждёт решения.

Доверенный ключ — галочка «Доверенный ключ — не спрашивать меня» при выдаче. С ней воронки, справочники и рассылки агент меняет без вашего подтверждения: включает и правит включённые воронки, удаляет, запускает рассылки. Боты, сотрудники, мини-приложения и прогон воронки в чате — всё равно только с разрешения.

Чего агент не может

Войти в TERVIO, писать клиентам из чата, менять настройки проекта, видеть пароли, токены, ключи интеграций и секреты вебхуков, заглянуть в другой проект. Каждое его обращение записывается в «Журнал» под именем агента.

Если ключ утёк

Отзовите или удалите его в разделе «Агенты» — он перестаёт работать сразу. «Отозвать» оставляет ключ в списке для истории, «Удалить» убирает насовсем; что агент делал по ключу, остаётся в «Журнале», а его запросы — в истории запросов. Когда ключом впервые пользуются с нового адреса, TERVIO присылает уведомление «ИИ-агент с нового адреса»: если это были не вы, это первый признак утечки. У подключения из claude.ai и ChatGPT признак другой: если старый токен подключения предъявят повторно, TERVIO сам отзовёт подключение и пришлёт «Подключение ИИ-агента отозвано».

Выключить агента целиком — кнопка «Выключить»: все его ключи замолчат, а после «Включить» действующие заработают снова. «Удалить» у агента отзывает все его ключи насовсем.