Серверы для Pyrus и их охват
Pyrus объединяет задачи, формы, реестры и справочники, и серверы покрывают эти разделы по-разному. Самый полный охват у обертки над официальной библиотекой, самый узкий у пакета из npm.
- MCP-сервер для Pyrus с уровнями доступа открывает все 41 метод API через официальную библиотеку pyrus-api. Запрещенные режимом инструменты он не регистрирует вовсе, поэтому агент не вызовет их даже по ошибке.
- MCP-сервер для Pyrus на npm создает, читает, обновляет и перемещает задачи, ищет списки по имени и работает с комментариями. Формы и каталоги его README не описывает.
- MCP-сервер для Pyrus с несколькими аккаунтами дает больше 20 инструментов: входящие, задачи по формам, реестры, контакты, роли, объявления и календарь. Между аккаунтами агент переключается параметром account.
- Многотенантный MCP-сервер для Pyrus добавляет базу знаний, аудит вызовов, хранение в SQLite, метрики Prometheus и обработку вебхуков.
Где взять security_key для Pyrus API
Документация Pyrus советует подключать интеграции через бота, технического пользователя организации. Ключ выпускается в настройках под значком шестеренки, в разделе «Авторизация», кнопкой «Получить ключ».
Остальное делает сервер. Он отправляет логин и security_key методом POST на accounts.pyrus.com/api/v4/auth и получает access_token. Если на одну почту заведено несколько аккаунтов, в запрос добавляют person_id. Облачный Pyrus возвращает вместе с токеном адреса api_url и files_url. Срок жизни токена ограничен. При смене пароля или блокировке аккаунта сервер должен авторизоваться заново.
Токен видит все, к чему у владельца ключа есть доступ. Поэтому боту стоит дать доступ только к тем формам и спискам, с которыми будет работать агент. Для пилота подойдет npx skillfoxx add mcp/pyrus-mcp. Та же установка доступна из карточки сервера.
Лицензия, язык и масштаб
Официального MCP от Pyrus в каталоге нет. Все серверы сделали независимые разработчики. У многотенантного сервера доступ широкий, а у остальных расширенный. VPN ни одному из них не нужен.
Для пилота с минимальным риском подходит сервер с уровнями доступа, если запустить его в режиме чтения и выдать ключ бота с доступом к одной форме. Но его лицензия PolyForm Strict 1.0.0 разрешает только некоммерческое использование, а для запуска нужен Python 3.14. Коммерческой команде придется договариваться с автором или брать другой сервер.
Пакет из npm ставится быстрее всех. Разделения прав по операциям в нем нет. Сервер на несколько аккаунтов покрывает формы и реестры, но лицензии в репозитории нет. Многотенантный вариант лежит внутри монорепозитория из 750 с лишним файлов и ставится только клонированием.
Если команда ведет задачи еще и в другом трекере, сравните его серверы на странице российского стека.
Что агент меняет в рабочем Pyrus
Все серверы создают и меняют задачи, а сервер на несколько аккаунтов еще завершает и переоткрывает их и публикует объявления. Первые недели держите агента на тестовой форме.
Секреты серверы хранят по-разному. Сервер на несколько аккаунтов держит security_key в открытом accounts.json и пишет лог pyrus_mcp.log в папку проекта. Многотенантный хранит учетные данные и аудит в своей SQLite.