Скачать вложение архивного снимка Федресурса — MCP fedresurs_archive_attachment
Инструмент fedresurs_archive_attachment сервера MCP Федресурса СУДиДЕЛО. Получает файл выбранной публикации и точного снимка. Первое чтение может загрузить файл через основной источник; это не всегда чтение уже сохранённых байтов.
Когда использовать и как работать
Успешно сохранённые байты неизменяемы, но доступ проверяется заново. Текст публикации может быть доступен при ошибке отдельного файла; проверяйте результат именно скачивания.
Параметры инструмента
person_uuid— Обязателен. Ненулевой UUID гражданина из фактического ответа карточки или доступного задания.family— Обязателен. Семейство: bankruptcy-messages, bankruptcy-reports или sfact-messages.publication_uuid— Обязателен. Ненулевой UUID публикации из списка выбранного объекта.attachment_uuid— Обязателен. Ненулевой UUID вложения из данных выбранной публикации.snapshot_id— Обязателен. Ненулевой UUID точного доступного снимка из ответа задания или системы.
Не смешивайте идентификаторы разных граждан, публикаций и снимков. Точный snapshot_id обязателен в операциях чтения снимка, списка, публикации и вложения.
Пример запроса и вызова
Через sudodelo-fedresurs выполни действие «Скачать вложение архивного снимка Федресурса» с указанными мной параметрами. Покажи фактический результат инструмента.
{
"name": "fedresurs_archive_attachment",
"arguments": {
"person_uuid": "00000001-2222-4333-8444-555555555555",
"family": "bankruptcy-messages",
"publication_uuid": "00000003-2222-4333-8444-555555555555",
"attachment_uuid": "00000004-2222-4333-8444-555555555555",
"snapshot_id": "00000006-2222-4333-8444-555555555555"
}
}
Это пример содержимого params для MCP tools/call, а не результат реального запроса. ИНН замените нужным вам, UUID — идентификаторами из ответов API. UUID операции архивного импорта создаётся клиентом отдельно. Пароль и ключ не передаются в аргументах или сообщением в чат.
Какой метод открытого API используется
Инструмент вызывает один метод Public API СУДиДЕЛО:
Получить вложение публикации архивного адаптера. В Swagger раскрыты параметры, модели и ответы. Машинное описание OpenAPI.
person_uuid→personUuid, path.family→family, path.publication_uuid→publicationUuid, path.attachment_uuid→attachmentUuid, path.snapshot_id→snapshotId, query.
MCP передаёт существующий ключ сотрудника в query-параметре apiKey Public API. При прямой интеграции нужен тот же доступ. Не помещайте реальный ключ в публикуемые ссылки и журналы. При браузерном MCP входе транспорт дополнительно проверяет ключ через GET /api/Auth/api-key/fedresurs-context; это проверка подключения, а не второй метод получения данных данного инструмента.
Результат и его обработка
MCP возвращает итог и разрешено, а после обращения к API — http_status, данные и заголовки. Исходный JSON сохраняется в данные, включая дополнительные поля. Проверяйте разрешено, MCP isError и содержимое: успешная доставка MCP-ответа не заменяет проверку результата действия.
При успехе данные содержит имя_файла, content_type, размер_байт и soderzhimoe_base64. Получите полный результат, декодируйте base64, сравните длину байтов с размер_байт и сохраните файл в клиенте. Формат определяется MIME источника, это не обязательно PDF. Лимит по умолчанию — 5 МиБ до base64. Из обрезанного ответа полный файл восстановить нельзя.
В текущем OpenAPI для метода документированы ответы:
400— Некорректные параметры запроса: проверьте обязательные поля, типы, форматы и допустимые диапазоны значений.401— API-ключ отсутствует, недействителен или отозван либо отсутствует требуемый доступ к организации, разделу или действию. Причина указана в ответе.403— Доступ к операции запрещён: проверьте учётные данные и права сотрудника.500— Внутренняя ошибка обработки запроса. Причина может быть связана с данными или зависимостями сервера.404— Запрошенная запись, файл или связанный справочник не найдены либо недоступны в текущей области доступа.409— Конфликт текущего состояния или конкурентное изменение данных. Обновите сведения и проверьте основание повторной команды.413— Размер переданного файла или тела запроса превышает допустимый предел.422— Запрос не может быть выполнен из-за недопустимых значений или превышения защитных лимитов; уточните параметры.424— Результат обработки запроса с HTTP-статусом 424.429— Превышена допустимая частота запросов; повторите обращение позже с учётом Retry-After, если он указан.502— Зависимый сервис вернул ошибку или ответ, не соответствующий ожидаемому контракту.503— Сервис или необходимый компонент временно недоступен; повторите запрос позже.504— Истекло время ожидания зависимого сервиса; перед повтором изменяющей команды проверьте её результат.499— Результат обработки запроса с HTTP-статусом 499.200— Байты связанного вложения. При первом архивном запросе адаптер может загрузить файл из основного сервиса; успешные байты сохраняются.
Доступ и ограничения
Нужно право menu.monitoringpersons (мониторинг физических лиц). Для чтения архивных объектов проверяются текущая личная подписка или действующий грант, организация и доступ к объекту; импорт дополнительно проверяет возможность управления подпиской при делегированном доступе.
Для подключения используйте инструкции обзорной статьи: /mcp-oauth для браузерного входа либо /mcp с X-Sudodelo-Api-Key. Предел JSON по умолчанию — 16 МиБ. Статусы и JSON-ошибки источника сохраняются; транспортная ошибка — 502, таймаут — 504, превышение локального лимита — 413. Ошибки аргументов выявляются до обращения к API. Пустые данные и отказ в доступе не являются доказательством отсутствия событий.