Пошаговая инструкция подключения remote MCP-сервера АСМК-СДД к Claude Desktop и API — OAuth 2.1, доступные инструменты, пример диалога и биллинг.

Что такое MCP и зачем он нужен для проверки контрагентов

Model Context Protocol (MCP) — открытый стандарт от Anthropic, который позволяет ИИ-ассистентам (Claude, Cursor и другим) безопасно вызывать внешние инструменты прямо в диалоге. Вместо того чтобы вручную копировать ИНН в сервис, ждать ответа и переносить данные обратно, аналитик пишет: «Проверь ООО "РусСтрой", ИНН 7701234567» — и Claude сам обращается к АСМК-СДД, получает риск-светофор, финансовые показатели и арбитражную историю, после чего формулирует заключение прямо в чате.

Ключевое отличие от обычного API-ключа в промпте: мастер-ключ к источникам данных (СБИС/TenderBot) хранится только на серверах АСМК-СДД и никогда не передаётся ни в Claude, ни на клиент. Пользователь авторизуется через OAuth 2.1, и Claude получает токен доступа исключительно к инструментам сервиса, а не к сырым данным провайдера.

Архитектура взаимодействия

sequenceDiagram
    participant U as Пользователь
    participant C as Claude Desktop
    participant M as MCP АСМК-СДД (/mcp)
    participant S as СБИС / TenderBot-3

    U->>C: «Проверь ООО "РусСтрой", ИНН 7701234567»
    C->>M: OAuth 2.1 (DCR + Authorization Code)
    M-->>C: access_token
    C->>M: find_counterparties(query="РусСтрой")
    M->>S: vok_response(inn=7701234567)
    S-->>M: 23 секции данных
    M-->>C: риск-светофор, сигналы, реквизиты
    C-->>U: Заключение + рекомендация

Подключение remote MCP-сервера

АСМК-СДД реализует Streamable HTTP MCP (FastMCP) — наиболее современный транспорт, поддерживаемый Claude Desktop начиная с версии 0.10 и Claude API напрямую.

Шаг 1 — Регистрация и получение токена

Перейдите на страницу документации для разработчиков и создайте аккаунт на странице регистрации.
В личном кабинете в разделе API-доступ сгенерируйте ключ вида dd_….

Ключ используется для прямых REST-вызовов. При подключении через MCP авторизация происходит иначе — через OAuth 2.1 DCR (см. ниже).

Шаг 2 — Настройка Claude Desktop

Откройте файл конфигурации Claude Desktop (claude_desktop_config.json) и добавьте блок:

{
  "mcpServers": {
    "asmk-sdd": {
      "type": "http",
      "url": "https://asmk-sdd.ru/mcp",
      "oauth": {
        "authorizationEndpoint": "https://asmk-sdd.ru/oauth/authorize",
        "tokenEndpoint": "https://asmk-sdd.ru/oauth/token",
        "registrationEndpoint": "https://asmk-sdd.ru/oauth/register",
        "scopes": ["counterparty:read"]
      }
    }
  }
}

При первом обращении Claude Desktop автоматически выполнит Dynamic Client Registration (DCR): зарегистрирует себя как OAuth-клиент, откроет браузер для авторизации пользователя, получит и сохранит токен. Повторная авторизация не требуется до истечения токена.

Шаг 3 — Проверка через Claude API

Если вы используете API напрямую (агенты, автоматизация), передайте MCP-сервер в параметре tools запроса согласно документации Claude API. Серверная часть поддерживает discovery через /.well-known/oauth-authorization-server и /.well-known/oauth-protected-resource.

Доступные инструменты MCP

После подключения Claude получает доступ к шести инструментам:

Инструмент	Что делает	Тарификация
`find_counterparties`	Поиск компаний по ИНН, ОГРН или названию	Бесплатно
`get_counterparty_report`	Полный отчёт: реквизиты, директор, ОКВЭД	По тарифу
`check_risk_factors`	Риск-светофор + скор 0–100 + объяснение сигналов	По тарифу
`get_financials`	Выручка, прибыль, активы за 3 года	По тарифу
`check_arbitration`	Арбитражные дела (ответчик, суммы, статус)	По тарифу
`get_document_link`	Ссылка на ВОК-PDF (выписка/финансы/бизнес)	По тарифу

Тарификация — по уникальным ИНН в календарном месяце, аналогично веб-интерфейсу.

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

Ниже — реальный сценарий работы менеджера по закупкам:

Пользователь: Нужно проверить нового поставщика перед подписанием договора. ООО «ТехноКомплект», ИНН 5047123456.

Claude: Ищу компанию в базе АСМК-СДД… (вызывает find_counterparties)

Компания найдена. ООО «ТехноКомплект», ОГРН 1175047000000, зарегистрирована в 2017 году, Московская область.

Запрашиваю риск-факторы… (вызывает check_risk_factors)

Результат:

Статус: активна
Риск-скор: 24 / 100 (низкий)
Арбитражных дел как ответчика за 3 года: нет
Исполнительных производств ФССП: нет
Финансовое здоровье: выручка растёт, капитал положительный
Надёжность СБИС: высокая

Заключение: По формализованным признакам компания не вызывает опасений. Рекомендую также запросить документы по стандартному чек-листу должной осмотрительности.

Биллинг и квоты

Поиск (find_counterparties) не тарифицируется.
Отчёт, риск-факторы, финансы, арбитраж — списываются при первом запросе по данному ИНН в текущем месяце. Повторные вызовы в том же месяце обслуживаются из кэша без дополнительного списания.
Квота отображается в личном кабинете в разделе Биллинг.
Новым пользователям начисляется 10 бесплатных проверок при регистрации.

При превышении квоты MCP-инструменты возвращают ошибку quota_exceeded — Claude сообщит об этом в диалоге и предложит перейти на страницу тарифов.

Уникальные преимущества интеграции

Большинство сервисов проверки контрагентов предлагают только веб-интерфейс или CSV-экспорт. АСМК-СДД — один из первых российских сервисов с нативным MCP-сервером, что даёт:

Встроенный контекст: Claude видит не сырой JSON, а структурированные сигналы с объяснениями на русском языке.
Безопасность: мастер-ключ к СБИС/TenderBot никогда не покидает инфраструктуру сервиса.
Мультитенантность: каждая организация работает в своём пространстве, биллинг и история изолированы.
Аудит: все MCP-вызовы логируются — важно для 152-ФЗ и внутреннего compliance.

Подробнее о REST API и других способах интеграции — на странице документации для разработчиков.

Готовы подключить ИИ-ассистента к проверке контрагентов? Зарегистрируйтесь — первые 10 проверок бесплатно, MCP-сервер доступен сразу после создания аккаунта.

Как подключить MCP-сервер АСМК-СДД к Claude