> Краткое содержание: Для владельца и администраторов: почему у MCP нет отдельного выключателя и подключение агентов решают две настройки доступа к API, что агент видит с персональным токеном и токеном бота, где увидеть и отозвать подключения, как закрыть выданное, журнал аудита, данные для поставщика модели и пометка сообщений агента > Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ. # Агенты и MCP в пространстве Сотрудники подключают к Пачке AI-агентов: Claude Code, Cursor, приложение Claude и другие программы с MCP, а также агентов на своих серверах. Эта страница для владельца и администраторов пространства: кто может подключить агента, что он увидит, где найти и отозвать подключения. Подробные правила описаны на страницах по ссылкам. ## MCP работает на обычных токенах API MCP — протокол, по которому программа с AI-агентом вызывает методы API Пачки. Подключить агента значит выдать ему обычный токен API: подтвердить вход программы через браузер или вставить в неё персональный токен либо токен бота. С персональным токеном или токеном бота агент работает и без MCP: через [CLI](/guides/cli/overview) или напрямую через API. **Отдельного выключателя MCP нет.** Разрешить сотрудникам персональные токены и ботов, но закрыть им MCP нельзя: подключение агента и есть доступ к API. Каждая настройка доступа действует на всё пространство сразу: у неё два значения, и выбрать в ней отдельных сотрудников или отделы нельзя. ## Кто может подключить агента Подключение агентов решают две настройки доступа к API в разделе **Настройки пространства** > **Общие настройки**. Меняют их владелец и администраторы. ![Настройки доступа к API](/images/authorization/token_access.webp) *Настройки доступа к API* | Настройка | Чем сотрудник подключает агента | |---|---| | **Кто может создавать персональные токены** | вход через браузер в программе с MCP, персональный токен из интерфейса, вход в CLI | | **Кто может создавать интеграции** | токен своего бота | По умолчанию персональные токены и вход через браузер есть только у администраторов, а ботов создают и сотрудники. Поэтому сотрудник может подключить агента токеном своего бота, даже когда персональные токены ему закрыты. Такой агент работает от имени бота и видит то же, что бот. Чтобы агентов подключали только администраторы, выберите **Только администраторы** в обеих настройках. Вторая настройка закроет сотрудникам и создание ботов. Что ещё меняет каждая настройка, сказано в разделе [Кто может создавать токены](/api/authorization#kto-mozhet-sozdavat-tokeny), а в каком порядке закрыть и уже выданный доступ — в разделе [Как закрыть подключение агентов](#kak-zakryt-podklyuchenie-agentov). Сотрудник, которому подключение закрыто, видит на экране согласия и на странице **API** отказ «Доступ к API ограничен…» с просьбой обратиться к администратору. Мульти-гость подключает агента на тех же условиях, что сотрудник, но своего бота не создаёт, а гость с API не работает при любой настройке. Подробнее — в разделе [Роли в пространстве](/guides/permissions#roli-v-prostranstve). ## Что видит агент Агент видит и делает то, что разрешено его токену. Метод API проверяет скоупы токена, роль его владельца, тариф пространства и участие в чатах так же, как без агента. Скоупы открывают методы, но не расширяют видимость. | Чем подключён агент | От чьего имени | Что видит | |---|---|---| | Вход через браузер или в CLI | сотрудника | то же, что сотрудник в интерфейсе, обычно со всеми правами его роли | | Персональный токен из интерфейса | сотрудника | то же, что сотрудник, в пределах прав, выбранных при создании токена | | Токен бота | бота | открытые беседы и каналы, чаты и треды, куда добавлен бот, и личные сообщения с ним | Подробнее о видимости — в разделах [Типы токенов](/api/authorization#tipy-tokenov) и [Доступы к чатам и сообщениям](/guides/bots/access). Агент на токене владельца пространства получает и его привилегии, например перечень всех чатов пространства и экспорт сообщений на тарифе «Корпорация». Подробнее — в разделе [Что доступно Владельцу пространства сверх остальных](/guides/permissions#chto-dostupno-vladeltsu-prostranstva-sverh-ostalnyh). Агент, которого зовут по нику в треде, устроен как бот: он видит то же, что бот, а создать его может тот, кому настройка **Кто может создавать интеграции** разрешает создавать ботов. Подробнее — в разделе [Взаимодействие с агентом](/guides/ai-agents/interaction). Набор инструментов MCP зависит от роли, тарифа и типа токена, подробнее в разделе [Какие инструменты получает программа](/guides/mcp/tools#kakie-instrumenty-poluchaet-programma). Сотрудник может сузить агента сам: дать ему персональный токен только на чтение или поручить ему черновики, которые потом отправит вручную. Подробнее — в разделе [Безопасные режимы](/guides/mcp/overview#bezopasnye-rezhimy). ## Где увидеть и отозвать подключения Владелец и администраторы видят доступы всех сотрудников на странице **Интеграции** > **API**, на вкладке **Все токены**: персональные токены, входы в CLI, авторизации ботов и подключения программ с MCP. В меню строки есть **Список разрешений** и **Отозвать**, отзыв действует сразу. Подробнее — в разделе [Все токены пространства](/api/authorization#vse-tokeny-prostranstva). ![Вкладка «Все токены» на странице «API»: число токенов, фильтры по типу, сотруднику и боту и таблица с колонками «Название», «Тип», «Сотрудник», «Разрешения», «Выдан» и «Использовался»](/images/authorization/all_tokens.webp) *Вкладка «Все токены»* Отдельный тип «Клиент MCP» есть только у программы, подключённой через браузер: агента на персональном токене, входе в CLI или токене бота по списку не отличить от скрипта. Токены бота на эту вкладку не попадают. Их видят и удаляют на вкладке **API** в карточке бота создатель и администраторы, если создатель открыл им доступ в настройке [Кто может редактировать настройки бота](/guides/bots/settings#kto-mozhet-redaktirovat-nastroyki-bota). Всех ботов пространства, включая чужих, владелец на тарифе «Корпорация» находит методом [Список ботов пространства](/api/bots/list-company). Подробнее — в разделе [Инвентаризация ботов пространства](/guides/permissions#inventarizatsiya-botov-prostranstva). Свои подключения сотрудник видит и отзывает сам на странице **API**, подробнее в разделе [Управление подключениями](/guides/mcp/connect#upravlenie-podklyucheniyami). На вкладке **Все токены** остаются и доступы сотрудников, которым приостановили доступ к пространству: почему их стоит отозвать, сказано в разделе [Токен и смена роли](/guides/permissions#token-i-smena-roli). ## Как закрыть подключение агентов Смена настройки закрывает только новый доступ: выданные до неё токены, входы и подключения работают, пока их не отзовут. Подробнее — в разделе [Кто может создавать токены](/api/authorization#kto-mozhet-sozdavat-tokeny). Чтобы закрыть и выданный доступ: ### Шаг 1. Закройте персональные токены Выберите **Только администраторы** в пункте **Кто может создавать персональные токены**. Подключать программы через браузер, входить в CLI и создавать персональные токены смогут только администраторы. ### Шаг 2. Отзовите выданные доступы На вкладке **Все токены** найдите строки «Клиент MCP», «Персональный токен» и «Токен CLI» у сотрудников и отзовите те, что не нужны. ### Шаг 3. Проверьте токены ботов Попросите создателей ботов удалить на вкладке **API** в карточке бота токены, отданные агентам, или удалите их сами, если создатель открыл администраторам доступ к боту. Сделайте это до следующего шага: когда ботов создают только администраторы, создатель без этой роли теряет доступ к своему боту. ### Шаг 4. Закройте создание ботов Выберите **Только администраторы** в пункте **Кто может создавать интеграции**. Боты сотрудников продолжат работать с оставшимися токенами. ## Журнал аудита На тарифе «Корпорация» журнал аудита записывает выдачу и отзыв каждого доступа к API, а читает его владелец пространства. Подключение программы через браузер приходит событием `oauth_authorization_granted` с названием программы в деталях. Подключение агента персональным токеном, входом в CLI или токеном бота отдельной записи не оставляет: в журнале есть только выдача самого доступа. Все события и их детали — в разделе [Токены и авторизации в журнале](/guides/audit-events#tokeny-i-avtorizatsii-v-zhurnale). Действия агента журнал записывает теми же событиями, что и действия в интерфейсе, например `message_created`, а актором в них стоит владелец токена: сотрудник или бот. ## Какие данные получает поставщик модели Всё, что агент прочитал в Пачке через MCP, CLI или API, попадает в контекст модели и уходит поставщику, которого выбрали в программе. Что из этого следует и как MCP-сервер защищает от внедрённых в сообщения инструкций и утечки через ссылки — в разделе [Безопасность](/guides/mcp/overview#bezopasnost). ## Как отличить сообщения агента Агент с токеном сотрудника пишет от его имени, а агент на токене бота пишет от имени бота. После входа через браузер или в CLI на аватаре стоит значок, а подсказка к нему называет программу: «Отправлено через «Claude Code»» или «Отправлено через «Pachca CLI»». С персональным токеном из интерфейса значка нет, и сообщение выглядит как написанное вручную. Как помечены сообщения при каждом способе доступа — в разделе [Как выглядят сообщения](/api/authorization#kak-vyglyadyat-soobscheniya). ![Сообщение сотрудника, отправленное через Claude Code: иконка Claude на аватаре и подсказка «Отправлено через «Claude Code»»](/images/mcp/mcp-message-badge.webp) *Сообщение, отправленное агентом через программу* - [Кто может создавать токены](/api/authorization#kto-mozhet-sozdavat-tokeny) — Две настройки доступа к API и что закрывает каждая - [Все токены пространства](/api/authorization#vse-tokeny-prostranstva) — Доступы всех сотрудников, разрешения и отзыв - [MCP-сервер](/guides/mcp/overview) — Как устроен, права, безопасность и пределы ## Связанные разделы - [Авторизация](/api/authorization) - [MCP-сервер](/guides/mcp/overview) - [Журнал аудита событий](/guides/audit-events) - [Права и роли](/guides/permissions)