Инструменты

У MCP-сервера Пачки инструмент на каждый метод публичного API. Инструмент вызывает свой метод с токеном подключения, поэтому права и ограничения у него те же, что у метода. Ответ собран из ответа метода: в списках каждая запись сокращена до основных полей, полную запись агент получает по запросу. Подробности — на странице метода, ссылка на неё в таблице ниже.

Шаги авторизации OAuth инструментами не стали. Инструментом не стал и метод GETПоток событий: держать соединение модель не может, а ссылка из ответа открывает события бота без токена.

Как агент отправляет файл

Файл к сообщению или черновику агент передаёт одним из двух способов:

• Содержимым в вызове. Подходит для небольшого текста, который агент написал сам, например таблицы или отчёта в .md. Сервер сам загружает файл и прикладывает его к сообщению, черновику или промо-картинкам бота.
• Ключом своей загрузки. Так отправляют документ или картинку с диска: настоящий файл модель содержимым не передаст. Агент получает форму загрузки инструментом pachca_get_upload_params, сам отправляет файл в хранилище, например через curl, и передаёт ключ и размер файла в сообщение или черновик. Для этого агенту нужен доступ к файлу на вашем компьютере и к хранилищу Пачки, как у Claude Code, Codex или Cursor.

В чате Claude у агента нет доступа к файлам на вашем компьютере, а его среда выполнения кода не может обратиться к хранилищу файлов Пачки. Поэтому там он отправит файл только содержимым, то есть небольшой текст. Аватар принимает только содержимое. Как устроена загрузка в API — в разделе Загрузка файлов.

Какие инструменты получает программа

Список зависит от токена подключения:

• Роль. Управление сотрудниками и тегами есть только у владельца и администратора. Мульти-гость, кроме того, не получает инструменты ботов, создание чатов и выход из них, добавление участников и тегов в чат и список сотрудников тега. Какие права у каждой роли — в разделе Права и роли.
• Тариф. Выгрузка сообщений, журнал аудита и списки всех чатов и ботов пространства есть только у владельца на тарифе «Корпорация».
• Тип токена. Формы, разворачивание ссылок, история событий, смена адреса своего вебхука и перевыпуск своего токена есть только у токена бота. Черновиков, раздела «Важное» и управления ботами у токена бота нет.

Роль проверяется на каждом вызове: если программа всё же вызовет инструмент не из списка, метод API ответит отказом и назовёт причину.

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

Все инструменты

Пометка в колонке Действие — та же, что получает программа: по ней программа решает, когда спросить подтверждение. Что значит каждая пометка — в разделе Подтверждение действий.

Манифест инструментов

Набор инструментов собирается из спецификации API и публикуется пакетом @pachca/mcp-manifest: имена, описания, схемы аргументов и ответов, права, роли и правила ответа сервера. Описания в нём на английском: их читает модель. Изменения набора — в журнале изменений пакета.