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

Для интеграторов: REST vs MCP

Как встроить российские юр/фин данные в свой продукт: REST API для любого бэкенда и MCP для агентных пайплайнов. Когда что выбрать, схема встраивания.

Обновлено:

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

Вы строите свой продукт — легалтех, систему проверки контрагентов, умный поиск, внутреннего AI-помощника или справочник. Ваши пользователи работают в вашем интерфейсе и не ставят Cursor. Вам нужен стабильный доступ к данным ФНС, ЕГРЮЛ, ФССП, СудАкт, госзакупок — по ключу, с гарантиями.

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

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

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

Ваш UI  →  ваш backend  →  REST / MCP  →  api.atomno-mcp.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)

Ваш бэкенд ходит на api.atomno-mcp.ru с персональным ключом:

curl https://api.atomno-mcp.ru/egrul/companies/inn/7707083893 \
  -H "Authorization: Bearer <ваш-ключ>"
  • Один ключ на организацию, лимиты по тарифу.
  • Ответы — строгий JSON (те же модели, что у MCP-тулзов).
  • Данные и платные источники — на нашей стороне, серверы в РФ.
  • Точные пути эндпоинтов под ваш сценарий выдаём вместе с ключом.

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

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

"mcpServers": {
  "egrul": {
    "command": "uvx",
    "args": ["atomno-mcp-egrul"],
    "env": { "ATOMNO_API_KEY": "<ваш-ключ>" }
  }
}

С ключом клиент проксирует все вызовы в hosted-бэкенд (актуальные данные, bulk, без локальных лимитов). Без ключа публичные серверы работают на открытых источниках — для проб и разработки.

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

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

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

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

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

Что дальше