praktika-mcp · Подключение
Практика высших судов рядом с вашим ассистентом
Ассистент ищет акты Верховного Суда и разъяснения Пленума, читает мотивировку и цитирует дословно со ссылкой на PDF суда. На этой странице описано, как подключить Практику к Claude, ChatGPT, Claude Code или Codex.
Практика доступна как размещенный сервис по адресу https://mizenko.ru/praktika/mcp. Доступ выдается через кабинет mizenko.ru. Claude и ChatGPT подключаются по OAuth, другие клиенты по личному ключу. Открыть кабинет
Установка
Локальная установка (для разработчиков)
Сервер работает на вашем компьютере. Корпус загружается в локальную базу, а клиент запускает сервер сам. Пароли базы хранятся в .env и в настройки клиента не попадают.
Требования
- uv
- менеджер окружения Python; Python 3.12 он поставит сам
- Docker
- PostgreSQL 17 с поиском запускается в контейнере
- Корпус актов
- тексты актов высших судов; передается вместе с доступом к репозиторию
- Диск
- около 15 ГБ под рабочую версию корпуса, предыдущую для отката и собираемую
- Клиент
- Claude Code или Codex; подойдет и другой MCP-клиент с запуском по stdio
Установка и загрузка корпуса
- Получите доступ к репозиторию praktika-mcp и корпусу актов (пока по запросу) и разместите корпус там, где указано в README проекта.
- Скопируйте .env.example в .env и задайте три пароля ролей базы, например результатом openssl rand -hex 24.
- Поднимите базу, установите зависимости и загрузите корпус. Полная загрузка занимает около 9 минут и около 3,5 ГБ в базе.
- praktika doctor проверяет Docker, базу, миграции, наличие корпуса и версию загруженного корпуса. Все пять строк должны быть отмечены ✓.
git clone <praktika-mcp> praktika-mcp
cd praktika-mcp
cp .env.example .env # задайте три пароля ролей БД, .env не попадает в git
docker compose up -d # PostgreSQL 17 на 127.0.0.1:5432
uv sync # окружение и зависимости
uv run praktika ingest # загрузка корпуса, ~9 минут
uv run praktika doctor # все пять проверок отмечены ✓Подключение к ассистенту
Выберите один способ. Плагин подключает сервер и три скилла сразу, ручная настройка подключает только сервер. Если включить оба, сервер подключится дважды.
Плагин · Claude Code
- В папке praktika-mcp соберите плагин. Сборщик записывает абсолютные пути к uv и к проекту и ничего не устанавливает сам.
- Добавьте собранный каталог как источник плагинов и установите praktika-mcp для своего пользователя.
- Откройте новую сессию Claude Code. В /mcp появится сервер praktika, а скиллы станут доступны обычной фразой.
uv run python scripts/build_plugin.py
cd dist/plugins/local
claude plugin marketplace add .
claude plugin install praktika-mcp@praktika-local --scope userПлагин привязан к путям этого компьютера. После обновления скиллов соберите его заново и переустановите.
Плагин · Codex
- Соберите плагин, как для Claude Code, или используйте уже собранный каталог dist/plugins/local.
- Добавьте каталог как источник и установите плагин, затем откройте новую сессию Codex.
cd dist/plugins/local
codex plugin marketplace add .
codex plugin add praktika-mcp@praktika-localВручную · Claude Code, Cursor
- Создайте .mcp.json в папке проекта (или добавьте praktika в личные настройки клиента) по шаблону ниже.
- Замените /ABSOLUTE/PATH/TO/praktika-mcp абсолютным путем к клону. Пароль базы указывать не нужно, сервер читает его из .env.
- Перезапустите клиент и подтвердите сервер praktika. Скиллы при ручном подключении доступны как MCP prompts сервера.
{
"mcpServers": {
"praktika": {
"command": "uv",
"args": [
"run",
"--directory",
"/ABSOLUTE/PATH/TO/praktika-mcp",
"praktika",
"serve"
]
}
}
}Вручную · Codex
- Добавьте блок в личный ~/.codex/config.toml и замените путь к клону.
- Перезапустите Codex и проверьте сервер командой codex mcp list.
[mcp_servers.praktika]
command = "uv"
args = ["run", "--directory", "/ABSOLUTE/PATH/TO/praktika-mcp", "praktika", "serve"]Инструменты сервера
- praktika_search
- поиск по вопросу или ключевым словам с фильтрами по норме, коллегии, виду акта, исходу, периоду и пункту разъяснения (cites), отдельными блоками идут разъяснения Пленума и свежая практика коллегий
- praktika_find_term
- все акты с точным оборотом во всех падежах и дословные цитаты
- praktika_get_document
- чтение акта по частям (мотивировка первой) или пункта разъяснения; статус пункта и практика по нему
- praktika_case
- все акты ВС по номеру дела, включая не вошедшие в корпус, со ссылкой на PDF
- praktika_status
- состав и срез корпуса, версии, охват
Три скилла
Скилл задает агенту порядок работы. Сначала норма и разъяснения, потом мотивировки, отдельный поиск практики «против» и только дословные цитаты. К скиллу можно обратиться обычной фразой.
Обзор практики по вопросу
«Сделай обзор практики по снижению неустойки по ст. 333 ГК для коммерсанта»
Справка с позицией Пленума, линией коллегий ВС, свежей практикой, ограничениями и перечнем того, что не найдено.
Практика под тезисы
«Подбери практику за и против под тезисы этого отзыва»
По каждому тезису цитаты «за» и «против» и оценка «подкреплен», «спорный», «практика против» или «не найдено».
Проверка судебного акта
«Проверь выводы этого постановления апелляции по практике ВС»
Таблица выводов суда со статусом «подтвержден», «расхождение» или «не охвачен» и весом источника.
Как проверить, что все работает
Отправьте ассистенту такой запрос.
Вызови praktika_status и покажи срез корпуса.
Затем найди практику ВС о снижении неустойки
по ст. 333 ГК для коммерсанта, прочитай мотивировку
одного акта и процитируй вывод суда.В чате должны появиться вызовы инструментов praktika, а в ответе реквизиты акта, ссылка на PDF и цитата в кавычках.
Если не работает
- «База недоступна»
- Запустите Docker и выполните docker compose up -d в папке praktika-mcp, затем praktika doctor.
- «Корпус собран другой версией»
- Если код обновился, а корпус нет, выполните praktika ingest. Вернуть предыдущий корпус можно командой praktika rollback.
- Ассистент отвечает без цитат
- Проверьте, что сервер включен в /mcp, и прямо попросите использовать praktika. Цитировать можно только text и quote из ответов сервера, потому что snippet в выдаче поиска обрезан.
- Обновить корпус
- Обновите корпус актов и выполните praktika ingest. Пересборка атомарная, сервер продолжает работать на прежней версии до переключения.
Ограничения
- Корпус включает содержательные акты ВС, разъяснения Пленума ВС и архив ВАС по состоянию на 27.09.2026. Актов КС, СИП и кассационных округов нет.
- Законная сила и последующий пересмотр актов не проверяются. Статус разъяснений определяется по данным корпуса и не является официальной проверкой.
- Пустая выдача не доказывает, что практики нет. Поиск лексический, часть текстов распознана из PDF с ошибками.
- Скиллы подбирают и раскладывают практику, но не дают юридического заключения и не прогнозируют исход дела.