Агенты и MCP в пространстве
Сотрудники подключают к Пачке AI-агентов: Claude Code, Cursor, приложение Claude и другие программы с MCP, а также агентов на своих серверах. Эта страница для владельца и администраторов пространства: кто может подключить агента, что он увидит, где найти и отозвать подключения. Подробные правила описаны на страницах по ссылкам.
MCP работает на обычных токенах API
MCP — протокол, по которому программа с AI-агентом вызывает методы API Пачки. Подключить агента значит выдать ему обычный токен API: подтвердить вход программы через браузер или вставить в неё персональный токен либо токен бота. С персональным токеном или токеном бота агент работает и без MCP: через CLI или напрямую через API.
Отдельного выключателя MCP нет. Разрешить сотрудникам персональные токены и ботов, но закрыть им MCP нельзя: подключение агента и есть доступ к API. Каждая настройка доступа действует на всё пространство сразу: у неё два значения, и выбрать в ней отдельных сотрудников или отделы нельзя.
Кто может подключить агента
Подключение агентов решают две настройки доступа к API в разделе Настройки пространства > Общие настройки. Меняют их владелец и администраторы.
Настройки доступа к API
| Настройка | Чем сотрудник подключает агента |
|---|---|
| Кто может создавать персональные токены | вход через браузер в программе с MCP, персональный токен из интерфейса, вход в CLI |
| Кто может создавать интеграции | токен своего бота |
По умолчанию персональные токены и вход через браузер есть только у администраторов, а ботов создают и сотрудники. Поэтому сотрудник может подключить агента токеном своего бота, даже когда персональные токены ему закрыты. Такой агент работает от имени бота и видит то же, что бот.
Чтобы агентов подключали только администраторы, выберите Только администраторы в обеих настройках. Вторая настройка закроет сотрудникам и создание ботов. Что ещё меняет каждая настройка, сказано в разделе Кто может создавать токены, а в каком порядке закрыть и уже выданный доступ — в разделе Как закрыть подключение агентов.
Сотрудник, которому подключение закрыто, видит на экране согласия и на странице API отказ «Доступ к API ограничен…» с просьбой обратиться к администратору. Мульти-гость подключает агента на тех же условиях, что сотрудник, но своего бота не создаёт, а гость с API не работает при любой настройке. Подробнее — в разделе Роли в пространстве.
Что видит агент
Агент видит и делает то, что разрешено его токену. Метод API проверяет скоупы токена, роль его владельца, тариф пространства и участие в чатах так же, как без агента. Скоупы открывают методы, но не расширяют видимость.
| Чем подключён агент | От чьего имени | Что видит |
|---|---|---|
| Вход через браузер или в CLI | сотрудника | то же, что сотрудник в интерфейсе, обычно со всеми правами его роли |
| Персональный токен из интерфейса | сотрудника | то же, что сотрудник, в пределах прав, выбранных при создании токена |
| Токен бота | бота | открытые беседы и каналы, чаты и треды, куда добавлен бот, и личные сообщения с ним |
Подробнее о видимости — в разделах Типы токенов и Доступы к чатам и сообщениям.
Агент на токене владельца пространства получает и его привилегии, например перечень всех чатов пространства и экспорт сообщений на тарифе «Корпорация». Подробнее — в разделе Что доступно Владельцу пространства сверх остальных.
Агент, которого зовут по нику в треде, устроен как бот: он видит то же, что бот, а создать его может тот, кому настройка Кто может создавать интеграции разрешает создавать ботов. Подробнее — в разделе Взаимодействие с агентом.
Набор инструментов MCP зависит от роли, тарифа и типа токена, подробнее в разделе Какие инструменты получает программа. Сотрудник может сузить агента сам: дать ему персональный токен только на чтение или поручить ему черновики, которые потом отправит вручную. Подробнее — в разделе Безопасные режимы.
Где увидеть и отозвать подключения
Владелец и администраторы видят доступы всех сотрудников на странице Интеграции > API, на вкладке Все токены: персональные токены, входы в CLI, авторизации ботов и подключения программ с MCP. В меню строки есть Список разрешений и Отозвать, отзыв действует сразу. Подробнее — в разделе Все токены пространства.
Вкладка «Все токены»
Отдельный тип «Клиент MCP» есть только у программы, подключённой через браузер: агента на персональном токене, входе в CLI или токене бота по списку не отличить от скрипта.
Токены бота на эту вкладку не попадают. Их видят и удаляют на вкладке API в карточке бота создатель и администраторы, если создатель открыл им доступ в настройке Кто может редактировать настройки бота. Всех ботов пространства, включая чужих, владелец на тарифе «Корпорация» находит методом GETСписок ботов пространства. Подробнее — в разделе Инвентаризация ботов пространства.
Свои подключения сотрудник видит и отзывает сам на странице API, подробнее в разделе Управление подключениями. На вкладке Все токены остаются и доступы сотрудников, которым приостановили доступ к пространству: почему их стоит отозвать, сказано в разделе Токен и смена роли.
Как закрыть подключение агентов
Смена настройки закрывает только новый доступ: выданные до неё токены, входы и подключения работают, пока их не отзовут. Подробнее — в разделе Кто может создавать токены.
Чтобы закрыть и выданный доступ:
Закройте персональные токены
Выберите Только администраторы в пункте Кто может создавать персональные токены. Подключать программы через браузер, входить в CLI и создавать персональные токены смогут только администраторы.
Отзовите выданные доступы
На вкладке Все токены найдите строки «Клиент MCP», «Персональный токен» и «Токен CLI» у сотрудников и отзовите те, что не нужны.
Проверьте токены ботов
Попросите создателей ботов удалить на вкладке API в карточке бота токены, отданные агентам, или удалите их сами, если создатель открыл администраторам доступ к боту. Сделайте это до следующего шага: когда ботов создают только администраторы, создатель без этой роли теряет доступ к своему боту.
Закройте создание ботов
Выберите Только администраторы в пункте Кто может создавать интеграции. Боты сотрудников продолжат работать с оставшимися токенами.
Журнал аудита
На тарифе «Корпорация» журнал аудита записывает выдачу и отзыв каждого доступа к API, а читает его владелец пространства. Подключение программы через браузер приходит событием oauth_authorization_granted с названием программы в деталях. Подключение агента персональным токеном, входом в CLI или токеном бота отдельной записи не оставляет: в журнале есть только выдача самого доступа. Все события и их детали — в разделе Токены и авторизации в журнале.
Действия агента журнал записывает теми же событиями, что и действия в интерфейсе, например message_created, а актором в них стоит владелец токена: сотрудник или бот.
Какие данные получает поставщик модели
Всё, что агент прочитал в Пачке через MCP, CLI или API, попадает в контекст модели и уходит поставщику, которого выбрали в программе. Что из этого следует и как MCP-сервер защищает от внедрённых в сообщения инструкций и утечки через ссылки — в разделе Безопасность.
Как отличить сообщения агента
Агент с токеном сотрудника пишет от его имени, а агент на токене бота пишет от имени бота. После входа через браузер или в CLI на аватаре стоит значок, а подсказка к нему называет программу: «Отправлено через «Claude Code»» или «Отправлено через «Pachca CLI»». С персональным токеном из интерфейса значка нет, и сообщение выглядит как написанное вручную. Как помечены сообщения при каждом способе доступа — в разделе Как выглядят сообщения.
Сообщение, отправленное агентом через программу