к содержимому
← О проекте praktika-mcp

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

Установка и загрузка корпуса

  1. Получите доступ к репозиторию praktika-mcp и корпусу актов (пока по запросу) и разместите корпус там, где указано в README проекта.
  2. Скопируйте .env.example в .env и задайте три пароля ролей базы, например результатом openssl rand -hex 24.
  3. Поднимите базу, установите зависимости и загрузите корпус. Полная загрузка занимает около 9 минут и около 3,5 ГБ в базе.
  4. 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
  1. В папке praktika-mcp соберите плагин. Сборщик записывает абсолютные пути к uv и к проекту и ничего не устанавливает сам.
  2. Добавьте собранный каталог как источник плагинов и установите praktika-mcp для своего пользователя.
  3. Откройте новую сессию 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
  1. Соберите плагин, как для Claude Code, или используйте уже собранный каталог dist/plugins/local.
  2. Добавьте каталог как источник и установите плагин, затем откройте новую сессию Codex.
cd dist/plugins/local
codex plugin marketplace add .
codex plugin add praktika-mcp@praktika-local
Вручную · Claude Code, Cursor
  1. Создайте .mcp.json в папке проекта (или добавьте praktika в личные настройки клиента) по шаблону ниже.
  2. Замените /ABSOLUTE/PATH/TO/praktika-mcp абсолютным путем к клону. Пароль базы указывать не нужно, сервер читает его из .env.
  3. Перезапустите клиент и подтвердите сервер praktika. Скиллы при ручном подключении доступны как MCP prompts сервера.
{
  "mcpServers": {
    "praktika": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABSOLUTE/PATH/TO/praktika-mcp",
        "praktika",
        "serve"
      ]
    }
  }
}
Вручную · Codex
  1. Добавьте блок в личный ~/.codex/config.toml и замените путь к клону.
  2. Перезапустите 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 с ошибками.
  • Скиллы подбирают и раскладывают практику, но не дают юридического заключения и не прогнозируют исход дела.