Гарант MCP

semenboss95-design/garant-mcp· Проверено 12.11.2026· 1на GitHub

Подключает агента к правовой базе «Гарант»: найти акт, взять дословный текст статьи, посмотреть редакции и судебную практику. Нужен ваш собственный доступ к «Гаранту»: подписка или токен Гарант-Коннект.

2 реализации:

8 инструментов через вашу подписку internet.garant.ru: вход в браузере на вашем компьютере, редакция на дату события и блок provenance с реквизитами у каждой цитаты; ставится установщиком одной командой.

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

Что сделать до подключения

Действующая подписка «Гаранта» с логином и паролем от internet.garant.ru

git; Python ставить не нужно, установщик сам поставит uv, пакет и Chromium

Установщик: в PowerShell на Windows — install.ps1, на macOS и Linux — curl -LsSf https://raw.githubusercontent.com/semenboss95-design/garant-mcp/main/install.sh -o install.sh && sh install.sh

Вход в подписку в открывшемся окне браузера или командой garant login; проверка — garant doctor --живой

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio garant \
  -- garant-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.garant]
command = "garant-mcp"
args = []

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "garant": {
      "command": "garant-mcp",
      "args": []
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "garant": {
      "type": "stdio",
      "command": "garant-mcp",
      "args": []
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "garant": {
      "command": "garant-mcp",
      "args": []
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "garant": {
      "command": "garant-mcp",
      "args": []
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "garant": {
        "type": "local",
        "command": ["garant-mcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "garant": {
      "command": "garant-mcp",
      "args": []
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "garant": {
      "command": "garant-mcp",
      "args": []
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

garant_searchищет акты, решения, комментарии и формы

garant_documentвыдаёт текст документа

garant_articleвыдаёт дословный текст статьи

garant_tocпоказывает оглавление

garant_revisionsперечисляет редакции акта

garant_revision_on_dateнаходит редакцию на дату

garant_practiceищет практику высших судов

garant_kindsпоказывает дерево видов информации

14 инструментов поверх API Гарант-Коннект по вашему токену: кроме поиска и текстов — изменения документов за период, правовые новости, расстановка ссылок на нормы и практика из «Сутяжника». Один файл server.py, запускается как HTTP-сервер.

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

Что сделать до подключения

Python и пакеты mcp[cli], httpx и pydantic; запуск python server.py с переменной GARANT_TOKEN, или деплой на Railway из форка репозитория

Собственный токен Гарант-Коннект

GARANT_TOKEN

выдаётся в личном кабинете на garant.ru или по запросу вашему менеджеру «Гаранта»; задаётся на стороне сервера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http garant-mcp http://localhost:8000/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.garant-mcp]
url = "http://localhost:8000/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "garant-mcp": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "garant-mcp": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "garant-mcp": {
      "httpUrl": "http://localhost:8000/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "garant-mcp": {
      "httpUrl": "http://localhost:8000/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "garant-mcp": {
        "type": "remote",
        "url": "http://localhost:8000/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:8000/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "garant-mcp": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Инструменты сервера

garant_searchищет по базе актов и арбитражной практики

garant_get_snippetsнаходит нужные абзацы в документе

garant_get_document_htmlвыдаёт полный текст документа

garant_get_entry_htmlвыдаёт абзац с контекстом

garant_get_topic_infoпоказывает тип, статус, дату и орган

garant_get_redactionsперечисляет редакции документа

garant_find_modifiedпроверяет изменения за период

garant_block_on_control_changedследит за изменениями абзацев

garant_find_hyperlinksрасставляет ссылки на нормы в тексте

garant_get_newsвыдаёт правовые новости

garant_search_court_practiceищет судебную практику

garant_get_limitsпоказывает лимиты API

garant_download_document_urlдаёт ссылку на PDF, RTF или ODT

Показано 13 из 14.

Что попросить агента

«Найди в Гаранте статью 108 УПК РФ»Агент вызовет garant_search и garant_article

«Какая редакция статьи <номер> <кодекс> действовала на <дата>? Дай её текст»Агент вызовет garant_revision_on_date, затем garant_article с id редакции

«Подбери практику Верховного суда по <тема> за последние два года»Агент вызовет garant_practice с фильтрами по виду и периоду, в garant_mcp — garant_search_court_practice

«Проверь, менялись ли <документы> с <дата>»В garant_mcp агент вызовет garant_find_modified

«Расставь ссылки на нормы в этом тексте: <текст>»В garant_mcp агент вызовет garant_find_hyperlinks

Для каких задач

Найти статью закона и вставить её дословный текст в иск, жалобу или договор

Определить, какая редакция статьи действовала на дату события

Поднять практику Верховного и Конституционного судов по теме

Проверить, менялись ли нужные документы за период

Расставить в готовом тексте ссылки на нормы «Гаранта»

Ограничения

Без собственного доступа к «Гаранту» оба сервера не работают: garant-mcp нужна действующая подписка с логином и паролем от internet.garant.ru, garant_mcp — токен Гарант-Коннект. Допустимость автоматического обращения к сервису определяют его правила и ваша подписка

garant-mcp построен по записанному трафику сайта «Гаранта» без публичного API: при изменениях сервиса карту эндпоинтов обновляют. Практика приходит первой страницей списка, акты кассационных судов общей юрисдикции через подписку недоступны

В тексте статьи из garant-mcp могут оказаться редакционные врезки; перед подачей документа цитату сверяют с окном подписки

garant_mcp всегда стартует как HTTP-сервер на порту 8000 и не спрашивает у клиента ни пароля, ни токена; адрес развёрнутого сервера держите при себе. Весь код — один файл server.py, репозиторий создан 24.03.2026 и последний раз менялся 25.03.2026

Если не работает

Команда garant не находится

Откройте новое окно консоли. Если не помогло, выполните uv tool update-shell и снова откройте новое окно.

Claude или Codex не видят инструменты

Выполните garant register, для Codex — garant register --codex, затем garant doctor и полностью перезапустите клиент.

«Сессия подписки недействительна», сервер ответил 401 или 403

Вход истёк: выполните garant login.

Windows: установка упала с WinError 206 или Chromium не ставится с ошибкой Python

Выключены длинные пути. Один раз включите LongPathsEnabled в PowerShell от администратора и повторите установку в обычном окне.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
garant-mcp	semenboss95-design	1	локально	не нужен	8	10 сентября 2026
ГАРАНТ MCP	romanpirogov	1	HTTP	не нужен	14	25 марта 2026

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

Нужна ли подписка на «Гарант»?

Да. garant-mcp работает через вашу подписку: вы один раз входите в браузере, сессия хранится в профиле на вашем компьютере. Репозиторий не содержит базы и не передаёт учётные данные. garant_mcp нужен токен Гарант-Коннект.

Как проверить цитату, которую дал агент?

garant_article прикладывает блок provenance: редакция, дата начала действия, изменяющий акт, дата проверки и отпечаток текста. Если выдача неполна, сервер пишет об этом в полях _предупреждение и _нормализация.

Работает ли с ChatGPT?

Чат ChatGPT локальные серверы не запускает. Для подписки ChatGPT подходит Codex: garant register --codex допишет сервер в ~/.codex/config.toml.

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

Разверните сервер на Railway с переменной GARANT_TOKEN и добавьте в claude.ai через Settings → Integrations адрес https://<ваш домен>.up.railway.app/mcp. Локально python server.py поднимает сервер на порту 8000.

Как обновить garant-mcp?

Командой garant update: она обновит пакет и перезапустит демона, вход в подписку сохранится. garant doctor показывает неисправности и для каждой — команду, которой она чинится.

Работает ли сервер из России?

garant-mcp запускается на вашем компьютере и ходит в «Гарант» через ваш браузерный вход; garant_mcp обращается к api.garant.ru по вашему токену с вашей машины или с Railway.

Гарант MCP

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

Похожие серверы