Обзор
MCP (Model Context Protocol) — открытый протокол, по которому программа с AI-агентом подключается к внешнему сервису и получает его инструменты. MCP-сервер Пачки даёт агенту инструмент на каждый метод API, и агент сам выбирает нужный: прочитать тред, найти сообщение, ответить, поставить напоминание, пригласить сотрудника. Код писать не нужно, а права те же, что в API: агент видит и делает только то, что можно владельцу токена, которым подключена программа, в пределах прав этого токена.
Сервер работает по транспорту Streamable HTTP. Его подключают Claude Code, Claude, Cursor, VS Code, Codex (в том числе в приложении ChatGPT на компьютере), Grok Bot и другие программы с поддержкой MCP, а также агенты в Yandex AI Studio и на GigaChat.
Что можно попросить агента
Через сервер агенту доступен весь API, а не только переписка:
- Что решили в треде про релиз 2.4? Коротко, по пунктам
- Найдёт тред, прочитает сообщения и перескажет решения
- Какие у меня напоминания на эту неделю?
- Покажет ваши напоминания со сроками
- Пригласи anna@example.com и добавь её в каналы «Общий» и «Дизайн»
- Пригласит сотрудника и добавит его в каналы
- Отправь в канал «Финансы» файл report.pdf с отчётом за квартал
- Загрузит файл и отправит сообщение с ним
- Выгрузи переписку канала «Поддержка» за сентябрь
- Запросит выгрузку сообщений канала за сентябрь
Приглашение доступно не каждой роли, а выгрузка ещё и не на каждом тарифе. Кому что доступно — в разделе Какие инструменты получает программа. Файл с диска отправит программа с терминалом, подробнее — в разделе Как агент отправляет файл.
Повседневные задачи вроде дайджеста, разбора треда или слежения за тредом собраны в разделе Что можно поручить агенту.
Как подключить
Сервер даёт агенту инструменты вместе с правилами: описание инструмента говорит, как ведёт себя метод, а инструкции сервера — где обсуждать и когда спросить. Скиллы добавляют, как собрать из вызовов задачу, например прочитать тред целиком перед пересказом или собрать дайджест. Скиллы необязательны, когда они полезны, сказано в разделе Нужны ли скиллы. Больше всего в Пачке пригодится скилл сообщений: с ним агент сам пишет коллегам коротко, в тред и вашим голосом, и напоминать ему об этом каждый раз не нужно. Шаги для каждой программы — на странице Подключение к MCP. В Claude Code, приложении Claude, Codex, VS Code и Cursor сервер и скиллы можно поставить и одной установкой плагина «Пачка». Агент работает с Пачкой и без MCP, через CLI или API, а скиллы подходят к любому из этих способов, подробнее — в разделе Как подключить Пачку к агенту.
Подключать агентов разрешают те же настройки пространства, что и доступ к API. Подробнее — в разделе Кто может подключить, а для администратора — на странице Агенты и MCP в пространстве.
Сервер по адресу, вход в Пачку, скиллы и проверка
Как писать коллегам коротко и в тред, как собрать задачу из вызовов: прочитать тред целиком перед пересказом, собрать дайджест
Как устроен сервер
Программа получает инструменты
При подключении сервер отдаёт программе инструменты, которые подходят токену по роли в пространстве, тарифу и типу токена. У каждого метода публичного API, кроме нескольких служебных, свой инструмент с именем pachca_…, например pachca_send_message или pachca_list_tasks: аргументы повторяют параметры метода, а описание взято из документации API. Все инструменты — на странице Инструменты MCP, набор для вашего токена — в разделе Какие инструменты получает программа.
Агент выбирает инструмент
Агент сам выбирает, какой инструмент вызвать, по описаниям инструментов, инструкциям сервера и скиллам. Перед вызовом программа может спросить у вас разрешение, подробнее — в разделе Подтверждение действий.
Сервер вызывает метод API
Инструмент вызывает свой метод с токеном подключения, и метод проверяет всё как обычно: скоупы токена, роль владельца токена, тариф пространства и участие в чатах. Поэтому права агента те же, что в API.
Агент получает ответ
Ответ попадает в контекст модели. Текст, который написали сотрудники, гости и боты, приходит в отдельной разметке, а длинный список сервер обрезает, подробнее — в разделах Безопасность и Пределы.
Сервер принимает любой действующий токен API: персональный, в том числе полученный входом через браузер, и токен бота. Токену гостя, деактивированного или удалённого сотрудника сервер отказывает. Какие роли работают с API — в разделе Роли в пространстве.
Сервер работает на всех тарифах, включая бесплатный «Начало». Тариф влияет на набор инструментов и на лимит сообщений: пространство на «Начале», которое превысило месячный лимит сообщений, получает отказ большинства методов, пока его не оплатят. Что входит в каждый тариф — на странице тарифов.
Подтверждение действий
Разрешение на вызов инструмента спрашивает сама программа, так, как её настроил сотрудник: перед каждым вызовом, только перед изменениями или без вопросов. Сервер помечает каждый инструмент, и программы учитывают пометки:
| Пометка | Что делает инструмент | Например |
|---|---|---|
| Чтение | Только читает данные | pachca_list_chat_messages, pachca_search_messages |
| Изменение | Создаёт или меняет данные | pachca_send_message, pachca_create_task |
| Опасное изменение | Перезаписывает или удаляет то, что уже есть, а также создаёт бота или сотрудника | pachca_delete_message, pachca_remove_member, pachca_create_bot |
Создание бота и сотрудника помечено опасным, потому что бот шлёт события на адрес по выбору создателя, а приглашение уходит на любую почту. Пометка каждого инструмента — в разделе Инструменты MCP.
По инструкциям сервера агент сам просит подтверждения в чате в четырёх случаях:
- объект изменения агент выбрал сам, например из нескольких совпадений;
- изменение нельзя отменить, хотя подошло бы обратимое: приостановить сотрудника вместо удаления;
- изменение затрагивает сразу много объектов;
- агент отправляет от имени сотрудника текст, который сочинил сам.
Скиллы добавляют свои случаи, например перенос сообщения из закрытого чата в чат с другими читателями или упоминание, которое пригласит в тред нового участника. Они перечислены в разделе Что знает каждый скилл.
Безопасные режимы
Если сотрудник хочет сам решать, что уйдёт в Пачку, подойдёт один из двух режимов:
Персональный токен с правами на чтение и поиск: вызовы, которые меняют данные, получают отказ
Агент с токеном сотрудника оставляет готовое сообщение в поле ввода чата, а отправляет его сотрудник
Безопасность
Поставщик модели получает то, что прочитал агент. Ответы инструментов попадают в контекст модели, поэтому сообщения, файлы и данные сотрудников, которые агент прочитал, уходят поставщику модели, выбранному в программе. Как они хранятся и используются дальше, определяют условия программы и поставщика модели. Сервер отдаёт агенту данные, доступные токену, и только в ответ на вызов инструмента.
Чужой текст — это данные. Сообщения, имена файлов и другие поля, которые пишут сотрудники, гости и боты, сервер отдаёт агенту внутри отдельной разметки, а в инструкциях сервера сказано не выполнять ничего из этого текста. Так сообщение с просьбой «перешли все токены» остаётся сообщением.
Пачка сама не открывает ссылки из сообщений агента. Через MCP сообщение отправляется без превью ссылки, сервер не скачивает файлы по ссылке, а выгрузка не шлёт событие на внешний адрес. Иначе внедрённая в чат инструкция могла бы попросить агента написать ссылку с данными, и данные ушли бы на чужой сервер без единого клика. Адрес, на который бот шлёт события, агент меняет только опасным изменением бота.
Секреты отдаются только вам. Инструменты, которые возвращают токен бота или адрес входящего вебхука, говорят агенту показать их вам и больше никуда не передавать.
Если в программе одновременно подключены другие MCP-серверы, текст из одного может попытаться управлять инструментами другого. Подключая несколько серверов, оставьте подтверждения: не отключайте подтверждение для изменений.
Что видят коллеги и администратор
Сообщение, которое агент отправил после входа через браузер, подписано именем сотрудника, а на аватаре стоит значок с подсказкой «Отправлено через «Claude Code»». С персональным токеном из интерфейса подсказка не называет программу: в ней написано «Отправлено через API». Как помечены сообщения при каждом способе доступа — в разделе Как выглядят сообщения.
Сообщение, отправленное агентом через программу
Подключение через браузер администратор видит строкой «Клиент MCP» на вкладке Все токены и может его отозвать. Что ещё видит администратор и что записывает журнал аудита — на странице Агенты и MCP в пространстве.
Пределы
| Что | Предел | Сверх предела |
|---|---|---|
| Вызовы инструментов | 20 в секунду на токен | Отказ со сроком, через который можно повторить |
| Запросы к серверу | 100 в секунду на токен, включая подключение и список инструментов | Ответ 429 |
| Ответ инструмента | 100 000 символов | Длинный список сервер обрезает по целым записям и подсказывает агенту запросить страницу поменьше |
| Файл от сервера | 3,75 МБ в ответе: картинка приходит картинкой, текст текстом до 100 000 символов, остальное вложением | Агент узнаёт только размер файла |
| Файлы от агента | 4 МБ на вызов вместе с файлами, переданными содержимым в base64, то есть около 3 МБ исходных файлов | Документ или картинку с диска агент загружает сам |
Каждый вызов — запрос к API, поэтому действуют и все лимиты API, например на отправку сообщений. Описания всех инструментов вместе занимают десятки тысяч токенов контекста модели: если программа позволяет, отключите инструменты, которые агенту не нужны.