Что такое MCP-сервер и зачем он ИИ-агентам

Что такое MCP простыми словами

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-приложения подключаются к внешним данным и инструментам. Его представила компания Anthropic в ноябре 2024 года, и за год стандарт стал общим для отрасли: MCP понимают Claude, ChatGPT, Cursor, VS Code, Gemini CLI и Codex, а в России — Yandex AI Studio и SourceCraft Code Assistant.

MCP часто сравнивают с USB-C. Раньше под каждую пару «ассистент + сервис» писали отдельную интеграцию. Теперь сервис один раз делает MCP-сервер, и к нему подключается любой совместимый ассистент — без доработок с обеих сторон.

Как это работает

• MCP-клиент встроен в ассистента: в Claude, Cursor, VS Code, AI Studio или в вашего собственного агента.
• MCP-сервер работает на стороне сервиса. Он сообщает, какие у него есть инструменты, что делает каждый и какие параметры принимает.
• Модель читает описания инструментов и сама решает, какой вызвать. Вы пишете обычным языком, а агент превращает просьбу в запрос с нужными параметрами.

Сервер может работать на вашем компьютере или в интернете. Удалённый сервер подключается по адресу, как сайт: ничего не нужно устанавливать, доступ открывается ключом в заголовке запроса.

Чем MCP-сервер отличается от обычного API

MCP не заменяет API, а работает поверх него. Сайт по-прежнему ходит в API напрямую, а ИИ-агенту удобнее MCP: он сразу понимает, какие инструменты доступны и как ими пользоваться. Чем это отличается от function calling? Функции описывает разработчик в коде одного приложения, а MCP-сервер один на всех: те же инструменты работают в любом совместимом ассистенте.

Зачем ИИ-агенту внешние данные

Языковая модель знает мир на дату обучения и не сверяется с реестрами. Спросите её о конкретной компании — она уверенно назовёт ИНН, адрес и руководителя, но часть сведений окажется устаревшей или выдуманной. В переписке это терпимо, в договоре, счёте или доставке — нет.

MCP-сервер даёт агенту доступ к первоисточнику. Вместо догадки модель делает запрос и отвечает по актуальной записи ЕГРЮЛ, ФИАС или кадастра. Ответ легко проверить: в нём те же поля, что пришли из реестра.

Что умеет MCP-сервер hintdata

Мы подключили к MCP все основные данные сервиса — 16 инструментов, сгруппированных по задачам:

Подробнее о самих данных — на страницах подсказок адресов, поиска компаний и кадастра.

Что можно поручить агенту

Пишите ассистенту так же, как коллеге. Вот задачи, которые он решит уже сейчас:

• «Проверь компанию с ИНН 7707083893: действует ли она, кто руководитель и какой юридический адрес».
• «Вот адреса из таблицы — приведи их к ФИАС и добавь индексы».
• «Найди организации, где этот человек руководитель или учредитель».
• «Какая кадастровая стоимость у объекта с этим кадастровым номером?»
• «Определи, мобильный ли это номер и в каком он регионе».
• «Найди банк по БИК 044525225 и подставь реквизиты в счёт».

Если нужна проверка контрагента целиком, посмотрите разбор проверки компании по ИНН: агент через MCP получает те же поля, что и программа через API.

Как подключить за пять минут

• Зарегистрируйтесь на hintdata.ru — ключ выдаётся сразу, карта не нужна.
• В личном кабинете создайте секретный ключ — он начинается с sk_. Лучше отдельный для ассистента: его можно отозвать, не трогая остальные.
• Добавьте сервер в настройки ассистента: адрес https://api.hintdata.ru/mcp и заголовок Authorization со значением «Bearer» и ключом.
• Перезапустите ассистента и попросите найти компанию по ИНН — он увидит инструменты hintdata и вызовет нужный.

Например, в Cursor настройки лежат в файле .cursor/mcp.json, а ключ берётся из переменной окружения:

{
  "mcpServers": {
    "hintdata": {
      "url": "https://api.hintdata.ru/mcp",
      "headers": { "Authorization": "Bearer ${env:HINTDATA_KEY}" }
    }
  }
}

В Claude Code сервер добавляется одной командой:

claude mcp add --transport http hintdata https://api.hintdata.ru/mcp \
  --header "Authorization: Bearer sk_ваш_ключ"

Схема везде одна: адрес сервера и ключ в заголовке. Готовые настройки для VS Code, SourceCraft, Codex, Gemini CLI, Hermes Agent и Claude Desktop — в документации по MCP.

MCP на российских платформах

• Yandex AI Studio. В разделе Agent Atelier → MCP-серверы добавьте внешний сервер: URL https://api.hintdata.ru/mcp, транспорт Streamable HTTP, авторизация «Токен доступа» с заголовком Authorization. После этого инструменты hintdata доступны агентам AI Studio.
• GigaChat. Агента на модели GigaChat собирают на GigaChain, как в официальном примере Сбера, а сервер hintdata подключают библиотекой langchain-mcp-adapters. Пример кода — в документации.
• SourceCraft Code Assistant. Ассистент Яндекса для разработчиков подключает сервер в VS Code через файл .codeassistant/mcp.json — тем же адресом и ключом.

Протокол не привязан к модели, поэтому сервер работает и с агентами на открытых моделях, например в Hermes Agent.

Безопасность и оплата

• Каждый вызов инструмента — обычный запрос к API по вашему ключу. Тариф, лимиты и ограничения ключа по IP работают так же, как для сайта.
• Через MCP агент не получит больше, чем прямой запрос с тем же ключом: поля сверх тарифа в ответ не попадают.
• Подсказки и поиск расходуют дневной лимит тарифа. Стандартизация и объекты недвижимости оплачиваются с баланса по тем же ценам, что и в API.
• Платные инструменты отмечены для ассистента отдельно — клиент может спросить подтверждение перед вызовом.
• Ключ передаётся только в заголовке и никогда — в адресе.

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

Нужно ли уметь программировать, чтобы подключить MCP?

Нет. В Claude, Cursor, VS Code и AI Studio достаточно указать адрес сервера и ключ — это пара строк в настройках. Код понадобится, только если вы собираете собственного агента.

Какие ассистенты поддерживают MCP?

Claude Code и Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, Hermes Agent, Yandex AI Studio, SourceCraft Code Assistant и многие другие. Подойдёт любой клиент, который подключает удалённые MCP-серверы по HTTP.

Сколько стоит MCP-сервер hintdata?

Отдельной платы нет. Вызовы инструментов считаются как обычные запросы к API: на бесплатном тарифе — до 10 000 подсказок в день, платные методы списываются с баланса. Подробности — на странице тарифов.

Можно ли подключить MCP к GigaChat или YandexGPT?

Да. В Yandex AI Studio внешний MCP-сервер добавляется в интерфейсе и становится доступен агентам. С GigaChat сервер работает через GigaChain — пример есть в документации.

Откуда данные?

Адреса — из ФИАС (ГАР), компании и ИП — из ЕГРЮЛ и ЕГРИП ФНС, объекты недвижимости — из открытых данных Росреестра, справочники — из официальных классификаторов. Подробно об адресах — в статье что такое ФИАС и ГАР.

Что делать, если ассистент получил ошибку?

Сервер возвращает причину по-русски с кодом ошибки: нет ключа, не хватает тарифа, закончился баланс или дневной лимит. Ассистент может объяснить её сам, а все коды разобраны в статье о лимитах и ошибках API.