Для бизнеса
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 — что выбрать
| Ваш случай | Что брать |
|---|---|
| Витрина / справочник / поиск в UI | REST |
| Бэкенд на PHP / Go / Node / Java | REST |
| Классическая бизнес-логика без LLM | REST |
| Свой агент/копайлот с 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.
Гарантии, объём, договор
- Объём/лимиты — настраиваются под тариф; для больших нагрузок — выделенный контур.
- Доступность и скорость — фиксируем в договоре под ваш сценарий.
- Безопасность — доступ по ключу, размещение в РФ, для чувствительных кейсов — выделенный контур или установка в вашем периметре (на ваших серверах).
- Документы — работаем по договору, счёт и закрывающие.
Готовность источников и цены — на страницах Решения и Тарифы.
Что дальше
- API проверки контрагентов → — сводная проверка контрагента одним POST.
- REST API (эндпоинты) → — подключение, состав продуктов и формат запросов.
- Решения для бизнеса → — сценарии и готовность источников.
- Тарифы → — Pro. 1С и МойСклад — одна страница интеграций, не карточки каталога.
- Обсудить интеграцию → — подключение вашей системы.
Частые вопросы
Должны ли мои пользователи устанавливать MCP-клиент?
Нет, если данные получает ваш бэкенд. Пользователь работает в вашем интерфейсе, а сервер приложения обращается к REST API. MCP нужен там, где внутри системы уже есть агент с поддержкой вызова MCP-инструментов.
Что нужно уточнить перед интеграцией?
Определите сценарий, нужный состав данных и объём запросов. Затем сверяйте доступные источники и методы, авторизацию, лимиты и требования к размещению. Периодичность обновления, доступность и условия поддержки согласуются под конкретный сценарий.
Как выбрать между проверкой контрагента и отдельным реестром?
Начните с необходимых сведений: реквизиты компании, признаки риска или конкретная запись. Затем сопоставьте их с составом продукта; отдельный клиент реестра может существовать без самостоятельного размещённого подключения.
Можно ли встроить поиск судебных решений в мой сервис?
На страницах судебной практики и REST API описаны интерфейс, доступный состав и ограничения. Не рассчитывайте на все суды или полный архив: для своего сценария сначала сопоставьте нужный период и тип решений с описанием набора.
Где должен храниться ключ, если данные видны пользователям сайта?
На вашем бэкенде, а не в публичном JavaScript браузера. Пользователь работает с вашим интерфейсом; ваш код выполняет запрос к размещённому API.
Нужно ли включать в продукт все инструменты MCP-клиента?
Нет. Выберите операции, необходимые сценарию, и сверяйте их доступность и права отдельно. Перечень инструментов не является обещанием, что все они входят в размещённый доступ.
Что показать пользователю, если часть источников не ответила?
Покажите неполученные сведения отдельно от результатов выполненных проверок. Не заменяйте ошибку пустым списком или сообщением об отсутствии риска.
