Полная публикация архивного снимка Федресурса — MCP fedresurs_archive_publication

Инструмент fedresurs_archive_publication сервера MCP Федресурса СУДиДЕЛО. Читает сохранённое представление публикации по гражданину, семейству, UUID сообщения и точному снимку. Все идентификаторы берите из списка этого же снимка.

Когда использовать и как работать

Проверяйте тело, источник и доступные заголовки X-Snapshot-Id и X-Publication-Body-SHA256. Полнота текста и доступность вложений проверяются отдельно.

Параметры инструмента

  • person_uuid — Обязателен. Ненулевой UUID гражданина из фактического ответа карточки или доступного задания.
  • family — Обязателен. Семейство: bankruptcy-messages, bankruptcy-reports или sfact-messages.
  • publication_uuid — Обязателен. Ненулевой UUID публикации из списка выбранного объекта.
  • snapshot_id — Обязателен. Ненулевой UUID точного доступного снимка из ответа задания или системы.

Не смешивайте идентификаторы разных граждан, публикаций и снимков. Точный snapshot_id обязателен в операциях чтения снимка, списка, публикации и вложения.

Пример запроса и вызова

Через sudodelo-fedresurs выполни действие «Полная публикация архивного снимка Федресурса» с указанными мной параметрами. Покажи фактический результат инструмента.

{
  "name": "fedresurs_archive_publication",
  "arguments": {
    "person_uuid": "00000001-2222-4333-8444-555555555555",
    "family": "bankruptcy-messages",
    "publication_uuid": "00000003-2222-4333-8444-555555555555",
    "snapshot_id": "00000006-2222-4333-8444-555555555555"
  }
}

Это пример содержимого params для MCP tools/call, а не результат реального запроса. ИНН замените нужным вам, UUID — идентификаторами из ответов API. UUID операции архивного импорта создаётся клиентом отдельно. Пароль и ключ не передаются в аргументах или сообщением в чат.

Какой метод открытого API используется

Инструмент вызывает один метод Public API СУДиДЕЛО:

GET /api/Fedresurs/monitoring/v1/persons/{personUuid}/publications/{family}/{publicationUuid} — открыть описание метода в Swagger.

Получить полное сохранённое представление публикации. В Swagger раскрыты параметры, модели и ответы. Машинное описание OpenAPI.

  • person_uuid → personUuid, path.
  • family → family, path.
  • publication_uuid → publicationUuid, 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-ответа не заменяет проверку результата действия.

Поля данных источника

В успешном JSON или элементах списка OpenAPI описывает следующие поля верхнего уровня. Они находятся внутри данные MCP-результата; наличие и заполненность оценивайте по фактическому ответу.

  • source — Источник сведений: fedresurs. Значения: 'fedresurs'.
  • registry — Реестр исходной публикации.
  • family — Семейство: bankruptcy-messages, bankruptcy-reports или sfact-messages.
  • publicationUuid — UUID публикации в Федресурсе.
  • number — Номер публикации в исходном реестре.
  • type — Вид публикации в исходном формате.
  • publishedAt — Дата публикации в исходном формате.
  • publisher — Сведения о публикаторе в исходном JSON.
  • cases — Связанные судебные дела; исходные реквизиты каждого дела.
  • sourceUrl — Адрес исходной публикации Федресурса.
  • bodyStatus — Доступность тела: complete — получено; unavailable — недоступно; pending — ожидается; unknown — не определено. Значения: ('complete', 'unavailable', 'pending', 'unknown').
  • contentKind — Вид содержимого публикации: текстовое сообщение либо структурированная форма.
  • text — Исходный текст публикации либо null, если текст отсутствует или недоступен.
  • structure — Структурированное содержимое публикации; произвольный JSON формы источника.
  • fullRepresentation — Полное сохранённое представление публикации в виде строки; null при отсутствии.
  • raw — Необработанные данные источника; произвольное JSON-значение.
  • metadata — Исходные метаданные публикации; набор полей зависит от семейства.
  • isAnnulled — Признак аннулирования; null, если источник не позволяет определить состояние.
  • relations — Подтверждённые связи публикаций, включая отмену и уточнение; исходный JSON каждой связи.
  • linkedMessages — Связанные сообщения в исходном формате.
  • attachments — Приложения публикации либо прогресс их загрузки; состав исходного JSON зависит от контекста.
  • bodyFetchedAt — Дата получения тела публикации в формате ISO 8601, UTC.
  • bodySha256 — Контрольная сумма SHA-256 сохранённого тела.
  • listCheckedAt — Дата последней проверки списка публикаций.
  • relationsCheckedAt — Дата последней проверки связей публикации.
  • missing — Отсутствующие сведения: имя поля и причина отсутствия.
  • provenance — Сведения о происхождении и получении данных; исходный JSON архива.

Дополнительные поля источника сохраняются. Произвольные разделы JSON не ограничены этим перечнем.

В текущем 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. Пустые данные и отказ в доступе не являются доказательством отсутствия событий.

Связанные инструменты

Обзор MCP Федресурса, подключение и полный каталог.