MCP-сервер для выписок ЕГРЮЛ и ЕГРИП по ИНН — egrul.nalog.ru

4 дня назад
СУДиДЕЛО.рф
2 минут

MCP-сервер СУДиДЕЛО для ЕГРЮЛ и ЕГРИП позволяет получать PDF-выписки по ИНН через ИИ-помощника. Подключите сервер к совместимому клиенту и попросите скачать выписку для юридического лица или индивидуального предпринимателя.

Источником данных служит сайт ФНС России egrul.nalog.ru — сервис «Предоставление сведений из ЕГРЮЛ/ЕГРИП в электронном виде». MCP-сервер получает выписки через API СУДиДЕЛО.

Достаточно знать ИНН: предварительно добавлять организацию или ИП в мониторинг СУДиДЕЛО не требуется.

Что можно делать

  • Скачивать актуальную PDF-выписку ЕГРЮЛ по 10-значному ИНН юридического лица.
  • Скачивать актуальную PDF-выписку ЕГРИП по 12-значному ИНН индивидуального предпринимателя.
  • Передавать полученный PDF клиенту для сохранения и дальнейшей работы с документом.

Это отдельный MCP-сервер для получения выписок. В его каталоге один инструмент — egrul_egrip_pdf_skachat. В обычном чате его название вводить не обязательно: опишите задачу своими словами.

Что нужно для начала

  • Учётная запись СУДиДЕЛО с доступом к ЕГРЮЛ.
  • MCP-клиент с поддержкой Streamable HTTP. Для входа через браузер клиент должен поддерживать такой способ авторизации.
  • При ручной настройке — API KEY из раздела «Интеграция → API». При входе через браузер копировать его не требуется. Подробнее — в инструкции по открытому API.
  • Для сохранения документа — возможность клиента декодировать base64 и записать PDF в файл.

Какой адрес выбрать

На обоих адресах доступны вход через браузер и подключение по API KEY. Выбирайте адрес по месту работы клиента:

  • Для работы из России используйте https://mcp-egrul-ru.torkndgov.ru. Для входа через браузер: https://mcp-egrul-ru.torkndgov.ru/mcp-oauth. Для ручной настройки по API KEY: https://mcp-egrul-ru.torkndgov.ru/mcp.
  • Для работы из зарубежных сервисов используйте https://mcp-egrul.torkndgov.ru. Для входа через браузер: https://mcp-egrul.torkndgov.ru/mcp-oauth. Для ручной настройки по API KEY: https://mcp-egrul.torkndgov.ru/mcp.

Выбирайте адрес по месту работы клиента или сервиса, который подключается к MCP. Для LM Studio на компьютере в России выбирайте адрес с -ru, для зарубежного онлайн-сервиса — адрес без -ru. API KEY один и тот же для обоих адресов.

LM Studio 0.4.28+2 поддерживает полный браузерный вход на обоих адресах. Если основной адрес недоступен из вашей сети, используйте https://mcp-egrul-ru.torkndgov.ru/mcp-oauth. После входа нажмите «Подключить» и вернитесь в клиент.

Адреса подключения

  • Вход через браузер из России: https://mcp-egrul-ru.torkndgov.ru/mcp-oauth
  • Вход через браузер из зарубежных сервисов: https://mcp-egrul.torkndgov.ru/mcp-oauth
  • Основной адрес: https://mcp-egrul.torkndgov.ru/mcp
  • Запасной адрес: https://mcp-egrul-ru.torkndgov.ru/mcp
  • Проверка доступности процесса: https://mcp-egrul.torkndgov.ru/health

Если основной адрес не открывается в вашем клиенте, используйте запасной. Ключ доступа и возможности сервера те же.

Сервис работает удалённо, отдельно устанавливать сервер не требуется. Можно войти через браузер или настроить API KEY вручную. Ранее настроенное подключение по ключу продолжает работать.

Подключение в агенте ИИ

Для LM Studio подготовлена отдельная пошаговая инструкция по подключению MCP-сервера ЕГРЮЛ/ЕГРИП: настройка mcp.json, включение инструмента в чате и работа с PDF.

Способ 1. Войти через браузер

В совместимом MCP-клиенте добавьте сервер с адресом для вашего подключения. Пример входа через браузер из России:

{
  "mcpServers": {
    "sudodelo-egrul": {
      "url": "https://mcp-egrul-ru.torkndgov.ru/mcp-oauth"
    }
  }
}
  1. Сохраните настройки и начните подключение сервера в клиенте.
  2. В открывшемся браузере войдите в свою учётную запись СУДиДЕЛО. Если система запросит дополнительное подтверждение входа, выполните его.
  3. Проверьте название подключаемого приложения и нажмите «Подключить». Кнопка «Отмена» завершает подключение без предоставления доступа.
  4. После сообщения об успешной авторизации вернитесь в MCP-клиент и убедитесь, что доступен инструмент egrul_egrip_pdf_skachat.

Копировать API KEY или вводить его в чат не нужно. Если вы уже вошли в СУДиДЕЛО, система может сразу показать подтверждение подключения приложения.

Способ 2. Указать API KEY вручную

Добавьте запись в конфигурацию MCP-клиента (mcp.json). Вместо плейсхолдера укажите свой API KEY:

{
  "mcpServers": {
    "sudodelo-egrul": {
      "url": "https://mcp-egrul.torkndgov.ru/mcp",
      "headers": {
        "X-Sudodelo-Api-Key": "<ваш ключ доступа СУДиДЕЛО>"
      }
    }
  }
}

Сохраните настройки, переподключите MCP-сервер или перезапустите клиент. Проверьте, что появился сервер sudodelo-egrul и инструмент egrul_egrip_pdf_skachat.

Чтобы переключиться на запасной адрес, замените только значение url в этой же записи:

"url": "https://mcp-egrul-ru.torkndgov.ru/mcp"

Оставьте прежний API KEY, сохраните настройки и переподключите сервер. Основной адрес также продолжает работать.

Как передать ключ доступа

При входе через браузер приложение получает доступ автоматически. При ручной настройке укажите ключ в заголовке X-Sudodelo-Api-Key и используйте адрес с окончанием /mcp. Ключ не входит в аргументы инструмента; вводить его в чат не требуется.

Оба способа используют существующий ключ вашего пользователя и его права. Вход через браузер не создаёт новый ключ и не меняет старый. Подключайте только те приложения, которым готовы предоставить этот доступ.

Замена или отзыв API KEY прекращает работу старого ключа во всех подключениях, где он использовался. После замены обновите ручные настройки или заново подключитесь через браузер. Обычный выход из аккаунта в браузере сам по себе не отзывает API KEY.

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

  • «Скачай выписку ЕГРЮЛ по ИНН [ИНН юридического лица] и сохрани PDF».
  • «Получи выписку ЕГРИП по ИНН [ИНН индивидуального предпринимателя]».
  • «Сохрани полученную выписку в файл vypiska.pdf».

Замените текст в квадратных скобках настоящим ИНН. Для юридического лица нужны 10 цифр, для ИП — 12. Если клиент умеет создавать файлы, помощник сможет сохранить документ; иначе потребуется обработать результат инструмента отдельно.

Пример диалога с ИИ

На предоставленном скриншоте пользователь запрашивает выписку по ИНН, а помощник сообщает о получении документа и предлагает скачать PDF.

Пользователь: «Получи выписку из ЕГРЮЛ для компании с ИНН 5903117707».

ИИ-помощник: «Выписка из ЕГРЮЛ для компании с ИНН 5903117707 успешно получена». В ответе показан файл egrul-5903117707.pdf размером 169 КБ.

Запрос выписки ЕГРЮЛ по ИНН 5903117707 и ответ ИИ с PDF-файлом egrul-5903117707.pdf
Пример диалога с ИИ и получения PDF-выписки. Нажмите на изображение, чтобы открыть его в полном размере.

Как устроена работа

  1. Вы сообщаете ИИ-помощнику ИНН и просите получить выписку.
  2. Клиент вызывает инструмент egrul_egrip_pdf_skachat с параметром inn.
  3. MCP-сервер обращается к открытому API СУДиДЕЛО с вашим ключом и получает PDF.
  4. Клиент получает имя файла, тип, размер и содержимое документа в base64, затем сохраняет PDF при наличии такой возможности.

Сам MCP-сервер не создаёт файл на вашем компьютере. Сообщение об успешном получении выписки означает передачу её содержимого клиенту; сохранение файла выполняется следующим действием.

Важные ограничения

  • LM Studio 0.4.28+2 обрезает ответ с PDF до 50 000 символов. Из обрезанного ответа полный документ восстановить нельзя; для сохранения полного PDF нужен клиент, который получает результат целиком.
  • Поиск по названию, ОГРН или ФИО не предусмотрен: требуется ИНН.
  • Каталог содержит только скачивание текущей выписки. Архив выписок, мониторинг изменений и редактирование данных CRM в этот сервер не входят.
  • Параметр inn — строка из 10 или 12 цифр, без пробелов. Начальные нули нужно сохранять.
  • Лимит PDF по умолчанию — 5 МиБ до кодирования в base64. При превышении лимита содержимое документа не возвращается.
  • Доступ зависит от действительности ключа, прав пользователя и доступности сервиса получения выписок.

Если что-то не работает

  1. Если клиент не подключается к основному адресу, используйте адрес для России: https://mcp-egrul-ru.torkndgov.ru/mcp-oauth для входа через браузер или https://mcp-egrul-ru.torkndgov.ru/mcp для ручной настройки по ключу. Переподключите сервер.
  2. Откройте проверку доступности: ожидается status: ok. Эта проверка подтверждает работу процесса, но не проверяет ключ или получение выписок.
  3. Для входа через браузер проверьте адрес с окончанием /mcp-oauth и завершите подтверждение подключения. Для ручной настройки используйте /mcp и заголовок X-Sudodelo-Api-Key.
  4. Проверьте ИНН: 10 цифр для юридического лица или 12 для ИП.
  5. При сообщении об отказе в доступе проверьте API KEY и право пользователя на ЕГРЮЛ. Если выписка не найдена, уточните ИНН; при временной недоступности сервиса повторите запрос позже.
  6. Если выписка получена, но файла нет, проверьте поддержку сохранения PDF в клиенте.

После обновления сервера переподключите клиент, если он показывает старый инструмент monitoring_egrul_pdf_skachat. В этом сервере используется egrul_egrip_pdf_skachat с ИНН вместо идентификатора записи мониторинга.

Для программистов

Пример аргументов инструмента для ИП:

{"inn": "590612160763"}

Успешный результат содержит разрешено: true и объект данные с полями имя_файла, content_type, размер_байт и soderzhimoe_base64. Декодируйте последнее поле из base64 и сохраните байты в PDF. Перед сохранением проверяйте разрешено и наличие содержимого: прикладной отказ может прийти как обычный результат MCP-инструмента.

Для прямой интеграции без MCP используется метод:

GET https://api-sudodelo.torkndgov.ru/api/MonitoringCompanies/egrul/pdf?inn={ИНН}&apiKey={API_KEY}

Он принимает 10- или 12-значный ИНН и возвращает PDF без добавления субъекта в мониторинг. Актуальный контракт — в Swagger, группа MonitoringCompanies. Справка по API ЕГРЮЛ также описывает работу с записями мониторинга и архивными выписками.

Если вам нужны другие разделы CRM, смотрите описание основного MCP-сервера СУДиДЕЛО.