MCP-сервер Statsnet: данные о компаниях для ИИ

Что такое MCP и зачем он нужен

Model Context Protocol — открытый протокол, через который приложения искусственного интеллекта взаимодействуют с внешними источниками данных и инструментами. MCP-сервер описывает доступные действия, а MCP-клиент в ИИ-приложении вызывает их для выполнения вашего запроса. Это позволяет работать с данными сервиса в привычном диалоге.

В Statsnet таким источником служат сведения о компаниях. Вы можете попросить ассистента найти организацию по БИН, подготовить справку или разобрать связи. Ассистент получает результаты через MCP и использует их как контекст для ответа. Определение и основные понятия протокола приведены в официальном введении в Model Context Protocol.

Архитектура MCP: как работает сервер Statsnet

Вы задаёте вопрос. Укажите компанию, страну и нужный результат: краткую справку, список контрактов или обзор связей.
ИИ-ассистент выбирает инструмент. MCP-клиент получает описание инструментов сервера и передаёт параметры подходящего вызова.
Statsnet возвращает данные. Сервер обрабатывает запрос с учётом авторизации, тарифа и доступной квоты.
Ассистент формирует ответ. Он объединяет результаты в объяснение или таблицу. Вы можете уточнить вопрос и запросить дополнительные сведения.

Например, сначала ассистент находит нужное юридическое лицо, затем получает его карточку, после чего собирает отдельные сведения о судах или госконтрактах. Для каждого шага используются доступные инструменты. Такой поток соответствует клиент-серверной архитектуре MCP.

Statsnet предоставляет удалённый MCP server по адресу https://statsnet.co/mcp. Соединение работает через Streamable HTTP; устанавливать собственный сервер или поддерживать локальный процесс для доступа к Statsnet не требуется.

MCP-серверы и внешние источники данных

В архитектуре MCP разделены роли модели и источника информации. Языковая модель понимает задачу и формулирует ответ, а подключение к MCP-серверу даёт доступ к данным выбранного сервиса. ИИ может запросить сведения во время диалога, без переноса всей базы данных в сообщение. Актуальность ответа при этом зависит от самих источников данных и времени их обновления.

Один клиент может работать с несколькими MCP-серверами: например, получать сведения о компаниях через Statsnet, а также взаимодействовать с вашими внутренними источниками через отдельные подключения. Интеграция с корпоративными базами данных или доступ к файлам требуют собственных инструментов и разрешений. Подключение Statsnet само по себе не открывает ассистенту доступ к этим ресурсам.

Какие данные доступны через MCP

Публичные инструменты работают без API-ключа. Для расширенных данных нужен ключ и подходящий тариф. Ниже — инструменты из документации Statsnet MCP.

Инструмент	Для чего использовать
`search_companies`	Найти компанию по названию, БИН/ИИН или руководителю.
`get_company`	Получить публичную карточку компании в Markdown.
`get_company_paid`	Изучить полную карточку, учредителей, капитал, финансовую историю и риски.
`get_gov_contracts`	Посмотреть государственные контракты, заказчиков, суммы и даты.
`get_court_cases`	Получить сведения о судебных делах, сторонах и результатах.
`get_relations`	Исследовать связи руководителей, учредителей и компаний.
`check_individual`	Проверить физическое лицо по ИИН: участие в компаниях и риски.

Набор сведений зависит от выбранной компании и источников. Если поле отсутствует, попросите ассистента обозначить это в ответе. Проверка физлица требует Premium или более высокого тарифа; она доступна и в Pro.

Примеры запросов для работы с компаниями

Подготовка к проверке контрагента

Найди компанию по указанному БИН в Казахстане. Подготовь краткую справку: статус, руководитель, учредители и факторы риска. Отдельно перечисли сведения, которых нет в полученных данных.

Укажите точный идентификатор, чтобы отличить организацию от компаний с похожими названиями. Для последовательного анализа используйте гайд по проверке контрагента.

Анализ государственных контрактов

Посмотри госконтракты этой компании. Сгруппируй полученные записи по заказчикам, укажи суммы и даты. Отметь, какой период охватывают данные.

Такой запрос помогает подготовиться к переговорам и понять опыт поставщика. Просите ассистента опираться на возвращённые записи и явно отмечать неполный охват.

Исследование связей

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

Это отправная точка для анализа аффилированности. Наличие общей связи само по себе не объясняет характер отношений — изучайте роли и контекст.

Как подключить MCP Statsnet

1. Подготовьте доступ

Для работы с расширенными инструментами выберите тариф Pro и создайте API-ключ в личном кабинете. Используется тот же ключ, что и для REST API. Передавайте его в заголовке Authorization: Bearer, в настройках подключения, а не в тексте запроса к ассистенту.

2. Добавьте MCP-сервер в клиент

В Claude Code выполните команду, заменив sk_live_YOUR_KEY своим ключом:

claude mcp add --transport http statsnet https://statsnet.co/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

Для Cursor и других клиентов с настройкой удалённого подключения через mcp.json используйте конфигурацию из документации:

{
  "mcpServers": {
    "statsnet": {
      "url": "https://statsnet.co/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY"
      }
    }
  }
}

Храните файл с реальным ключом в личных настройках клиента; не добавляйте его в общий репозиторий. Актуальные варианты настройки, включая Claude Desktop, собраны в инструкции подключения.

3. Проверьте подключение

Убедитесь, что клиент видит инструменты Statsnet. Начните с поиска известной компании и проверьте название и идентификатор в результате. Затем запросите нужные расширенные сведения. Для анонимного режима уберите заголовок Authorization: останутся два публичных инструмента.

MCP и API: какой способ выбрать

Задача	MCP	REST API
Исследовать компанию в диалоге	Ассистент выбирает инструменты по вашему запросу.	Нужен интерфейс или код для вызовов.
Встроить данные в собственное приложение	Подходит для приложения с MCP-клиентом.	Подходит для прямой интеграции с сайтом, CRM или сервисом.
Управлять последовательностью запросов	Уточняйте задачу и проверяйте действия ассистента.	Задавайте последовательность и обработку ответов в коде.

MCP даёт ИИ-приложению стандартный способ взаимодействовать с инструментами. API удобен, когда нужен заранее определённый процесс интеграции. Для Statsnet оба способа используют один API-ключ; правила учёта запросов описаны в документации сервиса.

Контроль доступа к данным и действиям ИИ

Инструменты и результаты их вызовов становятся частью работы выбранного ИИ-приложения. Искусственный интеллект использует полученную информацию для ответа, поэтому перед подключением проверьте настройки обработки данных в вашем клиенте. В корпоративной среде согласуйте, с какими источниками и сведениями разрешено работать.

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

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

MCP входит в тариф Pro?

Да, MCP входит в Pro. Платные инструменты используют права и квоту подписки. Возможности и стоимость показаны на странице тарифов.

Можно попробовать без API-ключа?

Да. Без ключа доступны поиск компаний и публичная карточка. Анонимный поиск ограничен 30 запросами в час с одного IP. Авторизованный поиск возвращает до 50 результатов за вызов без этого IP-лимита.

Как учитываются платные запросы?

Учёт совпадает с REST API: на API-тарифах — по вызовам, на тарифах с отчётами — один отчёт за карточку компании с бесплатным повтором в течение двух недель. Полная карточка расходует квоту тарифа.

Почему сервер возвращает 401 или ошибку инструмента?

HTTP 401 означает неверный или отозванный ключ. Сервер не переключает такой запрос в анонимный режим. Если исчерпана квота или тариф не подходит, инструмент возвращает объяснение. Проверьте ключ и подписку в личном кабинете; при необходимости обратитесь в поддержку.

Нужно ли разрабатывать свой MCP-сервер?

Нет. Для доступа к Statsnet подключите готовый удалённый сервер к совместимому клиенту. Собственная разработка нужна, если вы создаёте отдельную интеграцию со своими источниками данных или бизнес-логикой.

MCP показывает изменения в реальном времени?

Подключение позволяет запросить данные во время диалога, но не гарантирует мгновенное обновление всех реестров. Проверяйте даты записей и периоды показателей. Запрос к MCP-серверу и обновление исходной базы данных — разные процессы.

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

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

Начните работу с MCP

Откройте инструкцию подключения MCP, создайте ключ в личном кабинете и задайте первый вопрос о компании. Для расширенных возможностей выберите Pro. Если нужна помощь с настройкой, свяжитесь с командой Statsnet.