MCP-сервер для ИИ-ассистентов

Подключите hintdata к ИИ-ассистенту по протоколу MCP — и он сам найдёт адрес по ФИАС, компанию по ИНН или объект по кадастровому номеру. Ответы приходят из реестров, а не из памяти модели.

Для подключения нужны три вещи:

• адрес сервера https://api.hintdata.ru/mcp;
• секретный ключ sk_… из личного кабинета — с публичным pk_… доступны только подсказки;
• заголовок Authorization: Bearer sk_…. Префикс Token, как в обычных запросах к API, тоже подходит.

Каждый вызов инструмента — обычный запрос к API по вашему ключу: тариф, лимиты, ограничения по IP и списания работают так же. Отдельно включать MCP или платить за него не нужно.

Настройка ассистентов

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

claude mcp add --transport http hintdata https://api.hintdata.ru/mcp \
  --header "Authorization: Bearer sk_xxx"

• Ключ надёжнее держать в переменной окружения, а не в файле проекта: Cursor и Codex подставляют её сами, VS Code спрашивает ключ при подключении.
• Claude Desktop подключает серверы с ключом в заголовке через мост mcp-remote — нужен установленный Node.js.
• После настройки перезапустите клиент или обновите список серверов и попросите ассистента, например, проверить компанию по ИНН.

Проверить, что сервер доступен, можно без ключа — список инструментов открыт:

curl https://api.hintdata.ru/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Российские платформы

Yandex AI Studio

Внешний сервер подключается в разделе Agent Atelier → MCP-серверы, после чего его инструменты доступны ИИ-агентам AI Studio.

• Нажмите «Создать MCP-сервер» и выберите «Внешний MCP-сервер».
• Укажите URL https://api.hintdata.ru/mcp и транспорт Streamable HTTP.
• Тип авторизации — «Токен доступа»: имя заголовка Authorization, значение Bearer sk_….
• Нажмите «Подключиться», отметьте нужные инструменты и сохраните.

GigaChat

Агента на модели GigaChat собирают на GigaChain, как в официальном примере Сбера. Сервер hintdata подключается библиотекой langchain-mcp-adapters, ключ — в переменной окружения HINTDATA_KEY:

# pip install langchain-gigachat langchain-mcp-adapters langgraph
import asyncio, os
from langchain_gigachat.chat_models.gigachat import GigaChat
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async def main():
    client = MultiServerMCPClient({
        "hintdata": {
            "transport": "streamable_http",
            "url": "https://api.hintdata.ru/mcp",
            "headers": {"Authorization": f"Bearer {os.environ['HINTDATA_KEY']}"},
        }
    })
    tools = await client.get_tools()
    # ключ GigaChat — в переменной окружения GIGACHAT_CREDENTIALS
    agent = create_react_agent(GigaChat(model="GigaChat-2-Max"), tools)
    result = await agent.ainvoke({"messages": "Проверь компанию с ИНН 7707083893"})
    print(result["messages"][-1].content)

asyncio.run(main())

SourceCraft Code Assistant от Яндекса настраивается так же, как VS Code, — пример на вкладке «SourceCraft» в разделе «Настройка ассистентов». Агенты на открытых моделях, например Hermes Agent, подключают сервер тем же адресом и ключом.

Инструменты

Сервер отдаёт 16 инструментов, сгруппированных по задачам. Аргументы повторяют параметры методов API, поэтому описание полей и примеры ответов — в разделах документации по ссылкам.

Оплата и лимиты

• Подсказки и поиск расходуют дневной лимит тарифа — на бесплатном это 10 000 запросов в день.
• Стандартизация и объекты недвижимости списываются с баланса по тем же ценам, что и в API. Цены — на странице тарифов.
• Платные инструменты отмечены для клиента как изменяющие — ассистент может спросить подтверждение перед вызовом.
• Поля сверх тарифа в ответ не попадают, а инструменты расширенных тарифов — компания по email и связанные компании — отвечают отказом с понятной причиной.
• Подсказки по умолчанию возвращают 5 вариантов, чтобы не раздувать контекст ассистента; больше — параметром count.
• Остаток лимитов и баланс ассистент узнаёт инструментом account.

Безопасность и ошибки

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