Перейти к основному содержанию

Для бизнеса

REST vs MCP для вашего продукта

Обновлено:

Кому эта страница

Вы строите свой продукт — легалтех, систему проверки контрагентов, умный поиск, внутреннего AI-помощника или справочник. Ваши пользователи работают в вашем интерфейсе и не ставят Cursor. Вам нужен стабильный доступ к данным ФНС, ЕГРЮЛ и к судебной практике — по ключу, с гарантиями. В поиске есть акты экономической коллегии Верховного суда, дела по КоАП и часть банка арбитража; это не полный архив и не Конституционный суд. Лекарства: поиск препарата, карточка регистрационного удостоверения, статус регистрации, предельная цена ЖНВЛП и письма Росздравнадзора об отзыве серий — из официальных выгрузок; текста инструкции нет. Товарные знаки: карточка по номеру свидетельства из открытого реестра ФИПС. Маркировка рекламы, новостройки и залоги представлены в каталоге; текущие подключение и работа сервиса не подтверждены. Росреестр сохранён как отдельное редакционное описание. Госзакупки: поиск и карточка с официального сайта zakupki.gov.ru; сводка поставщика недоступна. Приставы в каталоге есть, живой доступ не проверен.

Если же вы разработчик и хотите подключить MCP в свою AI-IDE — вам сюда: Где подключать MCP →.

Главный принцип

Конечный пользователь не видит MCP. Он жмёт кнопку в вашем UI → ваш бэкенд идёт за данными → отдаёт результат. MCP нужен, только если у вас внутри уже есть AI-агент с вызовом инструментов (tool-calling). Иначе — обычный REST.

Ваш UI  →  ваш backend  →  REST / MCP  →  api.atomno-data.ru  →  данные

REST или MCP — что выбрать

Ваш случайЧто брать
Витрина / справочник / поиск в UIREST
Бэкенд на PHP / Go / Node / JavaREST
Классическая бизнес-логика без LLMREST
Свой агент/копайлот с tool-calling (LangChain, OpenAI tools, свой рантайм с MCP)MCP-клиент (меньше своего кода)
RAG-пайплайн, где модель сама выбирает инструментMCP или REST-обёртка — по стеку

REST — универсален и не требует LLM. MCP экономит glue-код там, где агент уже умеет с ним работать: получаете готовые схемы инструментов, discovery и типизированные ошибки из коробки, а не пишете обёртки вручную.

Вариант A — REST (hosted API)

Общий адрес REST API — api.atomno-data.ru. Полный URL метода и заголовок авторизации возьмите из инструкции подключения выбранного продукта. Ниже форма запроса с полным URL в переменной ATOMNO_METHOD_URL:

curl "$ATOMNO_METHOD_URL" \
  -H "Authorization: Bearer <ваш-ключ>"
  • Один ключ на организацию, лимиты по тарифу.
  • Ответы — строгий JSON (те же модели, что у MCP-тулзов).
  • Данные и платные источники — на нашей стороне, серверы в РФ.
  • Состав продуктов, авторизация и ссылки на методы — REST API →.
  • Сводная проверка контрагентов (оценка риска 0–100) — API проверки контрагентов →: один POST по ИНН, профиль риска + оценка A–F.

Вариант B — MCP-клиент на вашем бэкенде

Если оркестратор поддерживает MCP, поднимите наш клиент как stdio-сервер и передайте ключ:

{
  "mcpServers": {
    "fns-check": {
      "command": "uvx",
      "args": ["atomno-mcp-fns-check"],
      "env": { "MCP_FNS_API_KEY": "YOUR_ATOMNO_API_KEY" }
    }
  }
}

Этот пример требует клиента ФНС с поддержкой размещённого check_contractor. Ключ не переводит все инструменты в hosted-режим и не отменяет лимиты подписки. Проверьте версию и условия: обычный uvx не гарантирует поддержку режима в опубликованном пакете. Без ключа ФНС сохраняет открытый режим. Один ключ и квота размещённого доступа общие для ваших клиентов.

Данные и их источники

Все данные — из официальных / открытых источников РФ (ФНС «Прозрачный бизнес», ЕГРЮЛ/ЕГРИП, публичные акты экономической коллегии Верховного суда, дела по КоАП и часть банка арбитража (не полный архив и не Конституционный суд), официальный сайт госзакупок zakupki.gov.ru, государственный реестр лекарственных средств Минздрава, открытые данные Росздравнадзора о контроле качества серий, открытый реестр товарных знаков ФИПС). Маркировка рекламы, новостройки и залоги представлены в каталоге; текущие подключение и работа сервиса не подтверждены. Росреестр сохранён как отдельное редакционное описание. Банк данных ФССП в каталоге есть, живой доступ к нему не проверен. Обновление — на нашей стороне. Периодичность по каждому источнику уточняем письмом под ваш SLA.

Гарантии, объём, договор

  • Объём/лимиты — настраиваются под тариф; для больших нагрузок — выделенный контур.
  • Доступность и скорость — фиксируем в договоре под ваш сценарий.
  • Безопасность — доступ по ключу, размещение в РФ, для чувствительных кейсов — выделенный контур или установка в вашем периметре (на ваших серверах).
  • Документы — работаем по договору, счёт и закрывающие.

Готовность источников и цены — на страницах Решения и Тарифы.

Что дальше

Частые вопросы

Должны ли мои пользователи устанавливать MCP-клиент?

Нет, если данные получает ваш бэкенд. Пользователь работает в вашем интерфейсе, а сервер приложения обращается к REST API. MCP нужен там, где внутри системы уже есть агент с поддержкой вызова MCP-инструментов.

Что нужно уточнить перед интеграцией?

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

Как выбрать между проверкой контрагента и отдельным реестром?

Начните с необходимых сведений: реквизиты компании, признаки риска или конкретная запись. Затем сопоставьте их с составом продукта; отдельный клиент реестра может существовать без самостоятельного размещённого подключения.

Можно ли встроить поиск судебных решений в мой сервис?

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

Где должен храниться ключ, если данные видны пользователям сайта?

На вашем бэкенде, а не в публичном JavaScript браузера. Пользователь работает с вашим интерфейсом; ваш код выполняет запрос к размещённому API.

Нужно ли включать в продукт все инструменты MCP-клиента?

Нет. Выберите операции, необходимые сценарию, и сверяйте их доступность и права отдельно. Перечень инструментов не является обещанием, что все они входят в размещённый доступ.

Что показать пользователю, если часть источников не ответила?

Покажите неполученные сведения отдельно от результатов выполненных проверок. Не заменяйте ошибку пустым списком или сообщением об отсутствии риска.

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть