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

Подключите Statsnet к Claude, Cursor и другим MCP-клиентам. Ищите компании, изучайте связи, суды и госконтракты в диалоге с ИИ. MCP входит в Pro.

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

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

В Statsnet таким источником служат сведения о компаниях. Вы можете попросить ассистента найти организацию по БИН, подготовить справку или разобрать связи. Ассистент получает результаты через MCP и использует их как контекст для ответа. Определение и основные понятия протокола приведены в [официальном введении в Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro).

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

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

Например, сначала ассистент находит нужное юридическое лицо, затем получает его карточку, после чего собирает отдельные сведения о судах или госконтрактах. Для каждого шага используются доступные инструменты. Такой поток соответствует [клиент-серверной архитектуре MCP](https://modelcontextprotocol.io/docs/learn/architecture).

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

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

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

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

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

Публичные инструменты работают без API-ключа. Для расширенных данных нужен ключ и подходящий тариф. Ниже — инструменты из [документации Statsnet MCP](https://docs.statsnet.co/ru/overview/mcp).

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

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

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

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

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

Укажите точный идентификатор, чтобы отличить организацию от компаний с похожими названиями. Для последовательного анализа используйте [гайд по проверке контрагента](/guides/kz/proverka-kontragenta).

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

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

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

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

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

Это отправная точка для [анализа аффилированности](/business-check/affiliations). Наличие общей связи само по себе не объясняет характер отношений — изучайте роли и контекст.

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

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

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

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

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

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

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

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

Храните файл с реальным ключом в личных настройках клиента; не добавляйте его в общий репозиторий. Актуальные варианты настройки, включая Claude Desktop, собраны в [инструкции подключения](https://docs.statsnet.co/ru/overview/mcp).

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

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

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

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

MCP даёт ИИ-приложению стандартный способ взаимодействовать с инструментами. API удобен, когда нужен заранее определённый процесс интеграции. Для Statsnet оба способа используют один API-ключ; правила учёта запросов описаны в [документации сервиса](https://docs.statsnet.co/ru/overview/mcp).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Откройте [инструкцию подключения MCP](https://docs.statsnet.co/ru/overview/mcp), создайте ключ в [личном кабинете](/me) и задайте первый вопрос о компании. Для расширенных возможностей выберите [Pro](/plans). Если нужна помощь с настройкой, [свяжитесь с командой Statsnet](/contact).