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