MCP-сервер

Подключите AI-агентов к Statsnet по Model Context Protocol: установка в клиенты, инструменты и их параметры, лимиты, примеры запросов.

Statsnet предоставляет удалённый (remote) MCP-сервер — AI-агенты в Claude, Cursor, VS Code и любых MCP-совместимых клиентах ищут компании и получают их данные прямо в диалоге. Устанавливать локальный процесс не нужно:

POST https://statsnet.co/mcp

Режимы доступа

Без ключа (анонимно). Доступны два инструмента — search_companies и get_company, публичные данные бесплатно. Анонимный поиск ограничен 30 вызовами в час с одного IP и входит в общую бесплатную месячную квоту поиска, как на сайте.

С API-ключом. Создайте ключ в личном кабинете и передайте его в заголовке Authorization: Bearer sk_live_... в настройках подключения — не в тексте сообщения ассистенту. Ключ наследует подписку владельца: поиск без IP-лимита (до 50 результатов за вызов) и платные инструменты. Биллинг совпадает с REST API: на API-тарифах каждый вызов инструмента учитывается в месячном лимите; на тарифах с отчётами полная карточка списывает один отчёт, повторный просмотр той же компании в течение 2 недель бесплатен.

Неверный или отозванный ключ получает HTTP 401 — сервер никогда не переключает такой запрос в анонимный режим молча.

Инструменты

Параметры

Юрисдикции: kz (Казахстан), uz (Узбекистан), kg (Кыргызстан), ge (Грузия), am (Армения), tj (Таджикистан), az (Азербайджан) и штаты США в формате us-<код штата> — например, us-de, us-ca, us-ny. Полный актуальный список — в inputSchema инструментов, который клиент получает через tools/list.

Обычный сценарий: search_companies → идентификатор из результата → get_company или платный инструмент с той же парой jurisdiction + identifier. Если компания не найдена, квота не списывается.

Подключение

Claude Code

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

Без --header сервер подключится в анонимном режиме. Проверка: команда /mcp в Claude Code показывает statsnet и список инструментов.

Cursor

Файл ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в проекте:

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

VS Code (GitHub Copilot, режим агента)

Файл .vscode/mcp.json:

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

Claude Desktop

Анонимный режим: Settings → Connectors → Add custom connector, URL https://statsnet.co/mcp.

С API-ключом: конфиг claude_desktop_config.json поддерживает только локальные (stdio) серверы, поэтому удалённый сервер с заголовком подключается через мост mcp-remote (нужен Node.js):

{
  "mcpServers": {
    "statsnet": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://statsnet.co/mcp",
        "--header",
        "Authorization:${STATSNET_AUTH}"
      ],
      "env": { "STATSNET_AUTH": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

После правки конфига перезапустите Claude Desktop.

Другие клиенты

Любой клиент с поддержкой Streamable HTTP подключается по URL https://statsnet.co/mcp с необязательным заголовком Authorization. Храните конфиги с реальным ключом в личных настройках, а не в общем репозитории.

Примеры запросов к ассистенту

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

Проверка без клиента (curl)

Сервер отвечает на обычные JSON-RPC-запросы — удобно для отладки ключа:

curl -s https://statsnet.co/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_companies","arguments":{"query":"Казпочта","jurisdiction":"kz","limit":5}}}'

Ответ — объект JSON-RPC с полем result.content[0].text (Markdown). Список инструментов, доступных именно вашему ключу: {"jsonrpc":"2.0","id":1,"method":"tools/list"}.

Ошибки и лимиты

Ошибки уровня инструмента приходят как обычный результат с флагом isError, а не как протокольная ошибка: модель читает объяснение и может скорректировать запрос. Остаток квоты и тарифы — в личном кабинете и на странице тарифов.

Что дальше

• MCP для бизнеса — сценарии использования и сравнение с REST API.
• Аутентификация — ключи, права, тарифы.
• Справочник OpenAPI — те же данные через REST API.