CasusLegal CasusLegal Корпус практики высших судов ← На главную

Подключение к ZCode

Четыре шага, около минуты. ZCode — это агентная среда Z.ai под модели GLM. Удалённые MCP-серверы она открывает окном входа, поэтому подключение здесь такое же простое, как в Claude. Ни ключей, ни токенов вводить не нужно: вы входите через Telegram или паролем из личного кабинета.

⚠️ Среда без гарантии. Гарантированно поддерживаются Claude, ChatGPT, Grok и Hermes — в них коннектор протестирован. ZCode работает по тому же стандарту MCP, шаги ниже составлены по документации Z.ai, но стабильность конкретной версии среды мы не обещаем.
Доступ к базе. Приветственные бесплатные запросы в веб-чате и Telegram-боте на коннектор не распространяются. Перед подключением включите в личном кабинете бесплатный пробный период на три дня или оформите подписку на нужную базу.

Два пути подключения

Обычный случай
Вход через браузер

Вы работаете в ZCode на своём компьютере. Заполняете форму, среда открывает окно входа CasusLegal, и вы входите через Telegram или паролем из личного кабинета.

Секцию Headers при этом не трогаете.

Особый случай
Токен в заголовке

ZCode запущен на сервере, где браузер открыть негде. Тогда в форме добавляется заголовок Authorization с персональным токеном vasrf_conn_… из кабинета.

1
Откройте список MCP-серверов

В ZCode перейдите в Settings → MCP Servers и нажмите New MCP Server в правом верхнем углу.

В форме выберите Scope. Значение User открывает коннектор во всех рабочих пространствах, Workspace — только в текущем проекте. Для практики удобнее User: подключаете один раз и пользуетесь везде.

Если коннектор уже настроен у вас в Claude Code или Codex CLI, нажмите на той же странице иконку Import. ZCode прочитает их конфигурации и предложит перенести серверы одним действием, тогда шаги 2 и 3 не нужны.

2
Заполните форму

TypeHTTP (не stdio и не SSE: наш адрес работает по протоколу Streamable HTTP). URLhttps://mcp.casus.legal/mcp. Name — латиницей: CasusLegal.

Адрес в примере — база «Высшие суды». Подставляйте адрес той базы, которую вы оплатили (СИП — https://sip.casus.legal/mcp, КАС — https://kas.casus.legal/mcp, КУД — https://kud.casus.legal/mcp): с чужим адресом подключение пройдёт, но коннектор ответит, что подписка неактивна или истекла. Полная таблица — ниже, под шагами.

Имя пишите только латиницей. Из кириллического не собираются внутренние идентификаторы инструментов, и тогда сервер подключится и будет виден в настройках, но в чате модель ответит, что инструментов не видит.

Схема формы New MCP Server: Scope User, Name CasusLegal, Type HTTP, URL https://mcp.casus.legal/mcp и необязательная секция Headers.
Схема формы: заполняются Name, Type и URL. Секция Headers нужна только во втором варианте подключения — с токеном.
3
Войдите

После сохранения ZCode откроет окно входа CasusLegal. В нём два способа:

Через Telegram быстрее всего: аккаунт создастся автоматически, если его ещё нет. По паролю из личного кабинета входят те, кто уже задал его в разделе «Безопасность».

Окно входа CasusLegal: плашка с именем клиента ZCode и адресом возврата, кнопка «Войти через Telegram» и поле пароля.
Окно входа CasusLegal. В плашке сверху — имя клиента и адрес возврата: по ним видно, что вход запрашивает именно ваша среда, а не сторонний сайт.

Вариант без окна входа. Если ZCode работает на сервере, выпустите токен в кабинете (вкладка «Коннекторы», блок «Другие среды», кнопка «Выпустить токен») и добавьте его в форме в секции Headers: поле Authorization, значение Bearer vasrf_conn_…. Токен показывается один раз и работает, пока активна подписка.

4
Проверьте работу

Задайте агенту содержательный вопрос, например: «Найди практику ВС РФ по снижению неустойки по статье 333 ГК РФ». Первый поиск идёт около 30 секунд, потому что коннектор прогоняет несколько под-поисков по корпусу. В ответе должны появиться реквизиты актов со ссылками на полные тексты.

Если нужна ещё одна база, повторите шаги 1–3 с её адресом из таблицы ниже. Каждая база подключается отдельным сервером, подписка при этом одна.

Где лежит конфигурация

Форма пишет в те же файлы, которые можно править руками; в окне добавления сервера есть режим полной конфигурации, куда JSON вставляется целиком.

# все рабочие пространства (Scope: User) ~/.zcode/cli/config.json → ключ mcp.servers # только текущий проект (Scope: Workspace) <корень проекта>/.zcode/config.json → ключ mcp.servers

Адреса четырёх баз

БазаИмя (Name)Адрес (URL)
Высшие суды: КС · ВС · ВАСCasusLegalhttps://mcp.casus.legal/mcp
Суд по интеллектуальным правам (СИП)CasusLegal SIPhttps://sip.casus.legal/mcp
Административные дела (КАС · СКАД ВС РФ)CasusLegal KAShttps://kas.casus.legal/mcp
Уголовные дела (КУД · СКУД ВС РФ)CasusLegal KUDhttps://kud.casus.legal/mcp

Типичные ошибки

Сервер добавлен, но инструменты не появились

Проверьте тип сервера: нужен HTTP. При типе SSE подключение к нашему адресу не устанавливается.

Вторая причина: кириллическое имя сервера. Перепишите его латиницей и переподключите.

Вход прошёл, но коннектор отвечает отказом

Откройте вкладку «Коннекторы» в личном кабинете и проверьте срок подписки на нужную базу. Каждый корпус оплачивается отдельно, «Высшие суды» входят в любой комплект.

Если вы вводили пароль и он не подошёл, задайте его заново в разделе «Безопасность» кабинета. У тех, кто входил через Telegram, пароля может не быть вовсе.

ZCode запущен на сервере, окно входа открыть негде

Используйте вариант с токеном из шага 3: заголовок Authorization со значением Bearer vasrf_conn_…. Токен выпускается в кабинете и не отзывает уже работающие подключения в других средах.

Хочу перенести настройку из Claude Code или Codex CLI

На странице MCP Servers есть кнопка Import. ZCode сам находит конфигурации этих клиентов и переносит серверы. После импорта проверьте, что тип сервера остался HTTP, и при первом обращении пройдите вход.

Нужны сразу несколько баз

Добавьте по серверу на каждый адрес из таблицы выше с разными именами. Подписка одна и работает одновременно во всех средах: ZCode, Claude, ChatGPT.