AI / Agent API (MCP)

Помимо работы в админ-панели, проверки и справочники Системы интеллектуального мониторинга мерчантов доступны программно — чтобы их мог вызывать ваш ИИ-ассистент, чат-бот комплаенс-офицера или внешняя автоматизация. Доступ только на чтение, по токену.

Есть два способа подключения — они дают один и тот же набор возможностей:

MCP-сервер (POST https://admin.shield.by/mcp) — по протоколу MCP (Model Context Protocol), Streamable HTTP. ИИ-ассистент банка (Claude, Open WebUI и любой MCP-совместимый клиент) видит проверки как нативные инструменты и вызывает их сам в ходе диалога.
REST API v1 (https://admin.shield.by/api/v1/...) — те же проверки обычными HTTP-запросами, для интеграции в любой стек.

Что доступно (13 инструментов)

Справочники

get_mcc / search_mcc — карточка MCC по коду и поиск по описанию.
get_oked / search_oked / oked_children — справочник ОКЭД (ОКРБ 005‑2011), поиск и дочерние коды.
expected_mcc — ожидаемые MCC для кода ОКЭД (маппинг вид деятельности → код приёма платежей).

Проверки по сущности

egr — сверка с ЕГР (Беларусь) по УНП.
trade_register — наличие в Торговом реестре (МАРТ).
aml — скрининг по санкционным/AML-спискам (OpenSanctions).
fatf — страновой риск FATF.
mcc_suggest — AI-определение MCC по сайту: система читает контент и предлагает MCC с вердиктом miscoding, опираясь на реальный каталог кодов (RAG); различает услуги и товары.

Агрегаты по кейсу

case_checks — текущее состояние всех индикаторов кейса андеррайтинга.
case_report — данные для итогового отчёта по кейсу (для LLM-композера).

Авторизация

Все запросы — с заголовком Authorization: Bearer <токен>. Два уровня:

Токен	Что открывает
Глобальный read-токен	только справочники (MCC, ОКЭД, expected‑mcc)
Токен тенанта (per-tenant)	справочники + проверки + кейсы своего тенанта

Токен тенанта выпускается в админ-панели на странице тенанта. Действуют лимиты частоты (rate-limit).

Единый формат ответа

Любой ответ — в одном конверте:

{
  "schema_version": "1.0",
  "data": { "mcc": "5812", "category": "Рестораны", "confidence": 0.95, "...": "..." },
  "meta": { "source": "mistral", "status": "grey", "summary": "...", "cost_hint": "metered" }
}

data — результат проверки.
meta.status — светофор (green / grey / red) для быстрой интерпретации.
meta.source — откуда данные (каталог, ЕГР, mistral и т.д.); cost_hint — бесплатно/платно.

Пример: REST

# Подсказка MCC по сайту мерчанта
curl -H "Authorization: Bearer $WEBSHIELD_TOKEN" \
  "https://admin.shield.by/api/v1/mcc-suggest?url=https://example-shop.by"

# Сверка с ЕГР по УНП
curl -H "Authorization: Bearer $WEBSHIELD_TOKEN" \
  "https://admin.shield.by/api/v1/egr/123456789"

Пример: подключение MCP к ИИ-ассистенту

В MCP-совместимом клиенте (Claude, Open WebUI, Cursor, MCP Inspector) добавьте сервер:

Transport: Streamable HTTP
URL: https://admin.shield.by/mcp
Auth: Bearer, ваш токен платформы

После подключения ассистент сам вызывает нужный инструмент в диалоге — например, на вопрос «определи MCC для сайта X» он вызовет mcc_suggest и вернёт ответ с источниками.