MCP для Гаранта: как подключить ИИ-агента к правовой базе

Короткий ответ

ГАРАНТ — единственная из больших российских справочно-правовых систем, к которой ИИ-агента можно подключить нормальным путём. У неё есть официальный API «Гарант Коннект» с документацией и OAuth-авторизацией, а поверх него — MCP-серверы, в том числе оформленные плагином для Claude Code.

Нужен один компонент, который не берётся из репозитория: токен доступа. Его выдаёт региональный представитель ГАРАНТа по договору.

Чем это отличается от КонсультантПлюс

Тем, что здесь есть что оборачивать. MCP — это переводчик между агентом и API; если API нет, никакой сервер не поможет, и у КонсультантПлюс ситуация именно такая.

У «Гарант Коннекта» больше четырёхсот функций: полнотекстовый поиск, сниппеты с оценкой релевантности, простановка гиперссылок на нормы в вашем тексте, экспорт в PDF и RTF, отслеживание изменений документа, судебная практика, лента правовых новостей. Агенту из этого набора нужны первые три.

Что умеет готовый сервер

Открытый проект garant-mcp даёт агенту три инструмента:

• поиск по базе — обращение к методу /v2/search;
• фрагменты документа — метод /v2/snippets, помечен автором как экспериментальный: без живого OAuth-токена эндпоинт отвечает 404, и на конкретном ключе может как работать, так и не работать;
• ссылка на документ — сборка прямой ссылки на документ в веб-клиенте ГАРАНТа.

Важное ограничение, о котором автор пишет честно: полный текст документа через это API недоступен. Агент находит документ и фрагмент, а читать его вы идёте по ссылке в браузере. Для сценария «проверь, есть ли такая норма, и дай ссылку» этого достаточно; для «перескажи документ целиком» — нет.

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

Claude Code, плагином:

/plugin install AurelVU/garant-mcp

Напрямую через uvx — в окружении должен лежать токен:

GARANT_TOKEN=xxx uvx garant-mcp

Claude Desktop — в claude_desktop_config.json:

{
  "mcpServers": {
    "garant": {
      "command": "uvx",
      "args": ["garant-mcp"],
      "env": { "GARANT_TOKEN": "${GARANT_TOKEN}" }
    }
  }
}

Своим контуром, по HTTP — есть готовый образ, сервер поднимается на http://host:8000/mcp:

docker run --rm -p 8000:8000 -e GARANT_TOKEN=xxx ghcr.io/AurelVU/garant-mcp:latest

Общий порядок действий для любого клиента — в инструкции по подключению MCP.

ВажноТокен ГАРАНТа кладите в переменную окружения, а не в конфиг агента. Конфиг легко уезжает в репозиторий вместе с секретом, а токен здесь — это доступ к платной подписке организации.

Где всплывают ограничения

Лимиты запросов. Заявленный потолок — около 20 запросов в минуту и до 30 одновременных. Агент делает вызовы пачками, поэтому в лимит упираются раньше, чем ожидают: один вопрос пользователя легко превращается в пять поисков подряд.

Отдельный месячный лимит. У интернет-версии методы «Простановка ссылок», «Документы на контроле» и «Фрагменты на контроле» суммарно ограничены тысячей запросов в календарный месяц. Если планируете массово прогонять договоры через простановку ссылок, это первое, во что вы упрётесь.

Условия использования. Сервис разрешён для внутренних задач организации, а не для перепродажи. Продукт для внешних клиентов на его основе — предмет отдельного разговора с ГАРАНТом.

Зрелость самого сервера. garant-mcp — небольшой открытый проект: последние изменения в репозитории датированы концом мая 2026, лицензия не указана. Это рабочий инструмент для своей команды, но не то, на чём строят сервис для клиентов. Если нужна предсказуемость — свой сервер поверх того же API пишется за вечер, зато вы владеете кодом.

Чего ждать от связки

Работает хорошо: проверить, существует ли норма и в какой она редакции; найти документ по описанию своими словами; собрать подборку ссылок по теме; разметить свой текст ссылками на упомянутые нормы.

Работает плохо: пересказ документа целиком (полный текст через API не приходит), вывод о применимости нормы к вашей ситуации, любые заключения. Модель уверенно выдумывает, когда данных не хватает, а в правовых текстах выдуманная ссылка неотличима от настоящей на вид.

Разделение простое: агент ищет и цитирует, юрист решает и проверяет по первоисточнику.

Рядом

Что делать, если у вас КонсультантПлюс, а не ГАРАНТ, — в отдельном разборе. Связка правовой базы с учётной системой — 1С и Консультант+. Какие нейросети вообще пригодятся юристу — обзор по профессии.