Запустить импорт компании Федресурса — MCP fedresurs_company_import
Инструмент fedresurs_company_import сервера MCP Федресурса СУДиДЕЛО. По явному поручению пользователя запускает загрузку компании по ИНН. Параметр queue задаёт приоритет очереди: 1 — высший, 10 — низший.
Когда использовать и как работать
Принятие запроса не означает завершение загрузки. После запуска проверяйте company_status по тому же ИНН; после таймаута сначала выясните состояние, прежде чем запускать импорт снова.
Параметры инструмента
inn— Обязателен. ИНН строкой без пробелов; начальные нули сохраняются. Допустимы 10 или 12 цифр ASCII.queue— Необязателен; по умолчанию 1. Целый приоритет очереди от 1 (высший) до 10 (низший).
Пример запроса и вызова
Через sudodelo-fedresurs выполни действие «Запустить импорт компании Федресурса» с указанными мной параметрами. Покажи фактический результат инструмента.
{
"name": "fedresurs_company_import",
"arguments": {
"inn": "7707083893",
"queue": 1
}
}
Это пример содержимого params для MCP tools/call, а не результат реального запроса. ИНН замените нужным вам, UUID — идентификаторами из ответов API. UUID операции архивного импорта создаётся клиентом отдельно. Пароль и ключ не передаются в аргументах или сообщением в чат.
Какой метод открытого API используется
Инструмент вызывает один метод Public API СУДиДЕЛО:
POST /api/Fedresurs/import — открыть описание метода в Swagger.
Импорт компании по ИНН. В Swagger раскрыты параметры, модели и ответы. Машинное описание OpenAPI.
inn→inn, query.queue→queue, query.
MCP передаёт существующий ключ сотрудника в query-параметре apiKey Public API. При прямой интеграции нужен тот же доступ. Не помещайте реальный ключ в публикуемые ссылки и журналы. При браузерном MCP входе транспорт дополнительно проверяет ключ через GET /api/Auth/api-key/fedresurs-context; это проверка подключения, а не второй метод получения данных данного инструмента.
Результат и его обработка
MCP возвращает итог и разрешено, а после обращения к API — http_status, данные и заголовки. Исходный JSON сохраняется в данные, включая дополнительные поля. Проверяйте разрешено, MCP isError и содержимое: успешная доставка MCP-ответа не заменяет проверку результата действия.
Импорт запускайте только по поручению пользователя. HTTP 202 означает принятие задания; завершение проверяется отдельным инструментом статуса. Автоматических повторов нет. После таймаута сначала выясните состояние операции.
Поля данных источника
В успешном JSON или элементах списка OpenAPI описывает следующие поля верхнего уровня. Они находятся внутри данные MCP-результата; наличие и заполненность оценивайте по фактическому ответу.
inn— ИНН организацииfound— Количество найденных записейsaved— Количество новых сохранённых компанийupdated— Количество обновлённых компанийcards_loaded— Количество загруженных карточекerrors— Список ошибок при импортеtimestamp— Время выполнения импорта (UTC)data_source— Источник данных: «fetched» — с сайта, «cache» — из кэша, «queued» — импорт поставлен в очередь (данных ещё нет)last_parsed_at— Время последнего парсинга (ISO, UTC)blocked— True, если запрос заблокирован Qrator Security (403)refreshing— True, если TTL истёк и клиенту отдан предыдущий кэш, а полный импорт запущен в фонеqueued— True, если кэша нет и импорт поставлен в очередь (клиент не ждёт завершения)message— Человекочитаемое сообщение (например, о постановке в очередь)
Дополнительные поля источника сохраняются. Произвольные разделы 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.monitoringresultlistfedresurs (мониторинг компаний Федресурса).
Для подключения используйте инструкции обзорной статьи: /mcp-oauth для браузерного входа либо /mcp с X-Sudodelo-Api-Key. Предел JSON по умолчанию — 16 МиБ. Статусы и JSON-ошибки источника сохраняются; транспортная ошибка — 502, таймаут — 504, превышение локального лимита — 413. Ошибки аргументов выявляются до обращения к API. Пустые данные и отказ в доступе не являются доказательством отсутствия событий.