Плагин imzala для Claude

ОБНОВЛЯЕТСЯ ЕЖЕДНЕВНО: новые решения и выпуски Официального вестника каждый день добавляются в архив.

Плагин подключает Claude к архиву судебной практики imzala.net. В архиве собраны 11,5 млн решений турецких судов и ведомств, библиографические сведения о доктринальных работах, полные тексты Официального вестника, карта статей законов и данные TCMB/TÜİK. Claude самостоятельно формулирует ответ, а текст решения, его библиографические сведения и ссылку на официальный источник получает из архива.

Английский: инструменты, подключение и вход для любых MCP-клиентов

Что входит в плагин

Компонент	Назначение
Коннектор `ictihat`	Подключается к `https://mcp.imzala.net/mcp`. Предоставляет 12 инструментов: 11 предназначены только для чтения, а инструмент глубокого исследования запускает задачу подготовки отчёта.
Навык `ictihat-arastirma`	Описывает методику поиска: сочетание поиска по ключевым словам и смыслового поиска, запрет на цитирование без предварительного прочтения и проверка библиографических сведений.
Навык `dilekce-yazimi`	Описывает требования к оформлению юридических заявлений: обоснование и судебная практика приводятся в отдельных абзацах, цитаты должны быть дословными, приложения — перечислены.
Конвертер `md2udf.py`	Входит в навык `dilekce-yazimi`. Преобразует заявления в Markdown в формат UDF, используемый UYAP.

Установка

claude.ai и настольное приложение Claude

На странице Customize → Plugins → Add → Add marketplace введите asimokat/imzala-claude-eklenti.
В списке Discover выберите плагин imzala и установите его.
На вкладке Connectors плагина подключите коннектор. На открывшейся странице imzala.net укажите адрес электронной почты, введите полученный шестизначный код и подтвердите разрешение.

Установка сама по себе не выполняет вход: каждый пользователь подключается под своей учётной записью.

Claude Code

claude plugin marketplace add asimokat/imzala-claude-eklenti
claude plugin install imzala@imzala

Затем в сеансе введите /mcp, выберите сервер plugin:imzala:ictihat и выполните вход.

Какие данные передаются и хранятся

Плагин подключается только к https://mcp.imzala.net/mcp. В нём нет хуков и локального сервера.
Единственная программа в плагине — конвертер md2udf.py. Он работает только со стандартными библиотеками Python, не подключается к сети и запускается, только когда Claude преобразует заявление в UDF: в Claude Code и Cowork — на вашем компьютере, в чате — в среде Claude для выполнения кода.
Инструменты не записывают данные в архив. Все инструменты, кроме инструмента глубокого исследования, предназначены только для чтения. Инструмент глубокого исследования запускает задачу подготовки отчёта и расходует месячную квоту.
Вход выполняется по коду, отправленному на электронную почту; пароль не требуется.
Текст запросов, отправленных через инструменты поиска, на сервере не сохраняется. В течение 90 дней в журнале хранятся только идентификатор учётной записи, название инструмента, название клиентского программного обеспечения, длительность выполнения, размер ответа, статус ошибки и счётчики квоты.
Единственное исключение — глубокое исследование: первые 300 символов вопроса сохраняются в записи задачи, а исследование выполняется с помощью Google Gemini.
Подробнее: уведомление о конфиденциальности API · условия использования API

Стоимость

Сервис платный. Для каждой новой учётной записи предусмотрен 14-дневный пробный период. Тарифы: imzala.net/yapay-zeka

Английский

Этот плагин подключает Claude к архиву турецкой судебной практики imzala.net, который обновляется ежедневно. В архиве собрано 11,5 млн решений судов и ведомств, библиографические сведения о доктринальных работах, полные тексты Официального вестника, карта статей законов, а также данные центрального банка и статистической службы. Плагин использует удалённый MCP-сервер https://mcp.imzala.net/mcp и предоставляет два навыка: методику исследования (поиск по ключевым словам в сочетании со смысловым поиском, обязательное прочтение перед цитированием и проверка каждой ссылки) и правила составления юридических заявлений на турецком языке. В навык работы с заявлениями входит md2udf.py — скрипт на Python, который использует только стандартную библиотеку, не выполняет сетевых запросов и преобразует Markdown в формат UDF, используемый UYAP — турецкой судебной системой. Вход выполняется по коду, отправленному на электронную почту. Сервис платный; новым пользователям доступен 14-дневный пробный период. Содержимое сервера представлено на турецком языке. Сервер также совместим с MCP-клиентами, отличными от Claude; подробности приведены ниже.

Инструменты

Сервер предоставляет 12 инструментов. Одиннадцать предназначены только для чтения (readOnlyHint: true). Инструмент arastirma_baslat не является инструментом только для чтения: каждый вызов запускает задачу глубокого исследования и расходует 10 единиц месячной квоты учётной записи. Он ничего не удаляет и не изменяет; ни один инструмент не записывает данные в архив. Описания инструментов и параметры указаны на турецком языке.

Инструмент	Назначение	Только для чтения
`ictihat_ara`	Поиск по ключевым словам в 11,5 млн решений (Кассационный суд, Государственный совет, Конституционный суд, ЕСПЧ, Счётная палата, региональные и суды первой инстанции, а также такие ведомства, как Управление по конкуренции). Результаты можно фильтровать по суду, году, гражданскому или уголовному отделению, исходу, типу документа и статье закона, на которую опирается решение. Каждый результат содержит библиографические сведения, идентификатор документа, фрагмент текста и ссылку на официальный источник.	да
`ictihat_semantik`	Смысловой поиск: принимает предложение, сформулированное обычным языком, и находит близкие по смыслу решения, даже если в них используются другие слова (векторный индекс содержит 28,7 млн фрагментов).	да
`karar_getir`	Возвращает решение по идентификатору документа: резолютивную часть (по умолчанию), фрагмент текста вокруг указанного слова или полный текст постранично. В начале приводятся библиографические сведения и ссылка на официальный источник.	да
`kunye_dogrula`	Проверяет, существует ли решение с указанными библиографическими сведениями. По номеру дела и/или номеру решения возвращает сведения о фактическом суде, дате, исходе и ссылку на источник; отмечает несовпадение суда или даты, а если решение не найдено — показывает похожие варианты.	да
`benzer_kararlar`	Показывает решения, основанные на тех же правовых доводах, что и указанное решение. Для решений Конституционного суда также может показать более поздние решения, в которых на него ссылаются.	да
`madde_haritasi`	Для статьи закона (например, `hmk` 107) показывает распределение решений, в которых на неё ссылаются: по судам, доле исходов и годовой динамике. Возвращает сводные данные, а не отдельные решения.	да
`doktrin_ara`	Поиск по 98 651 диссертации и статье юридического журнала. Возвращает название, библиографические сведения, аннотацию и ссылку; полный текст не предоставляется из-за авторских прав.	да
`resmi_gazete_ara`	Полнотекстовый поиск по Официальному вестнику Турецкой Республики с 27 июня 2000 года. Содержит более 110 000 документов, включая уведомления.	да
`hukuk_gundemi`	Законодательная повестка: законопроекты, находящиеся на рассмотрении парламента Турции, с указанием их статуса; последние поправки, опубликованные в Официальном вестнике; заголовки юридической прессы. Все материалы приводятся в формулировках источников.	да
`veri_getir`	Официальные показатели, используемые при юридических расчётах: авансовые и редисконтные процентные ставки центрального банка, индексы цен (потребительских, производителей, строительства и услуг), а также обменные курсы 43 валют. Данные предоставляются Центральным банком Турецкой Республики и Турецким статистическим институтом с указанием источника.	да
`arastirma_baslat`	Запускает задачу глубокого исследования по широкому юридическому вопросу и возвращает идентификатор задачи. Обычно отчёт готов примерно через 4 минуты. Каждый вывод в нём подкреплён проверенной ссылкой и дословной цитатой.	нет: запускает задачу и расходует квоту
`arastirma_sonuc`	Возвращает отчёт по задаче глубокого исследования по её идентификатору. Если задача ещё выполняется, инструмент ожидает до 40 секунд, а затем возвращает сведения о ходе работы.	да

Подключение из любого MCP-клиента

Адрес: https://mcp.imzala.net/mcp
Транспорт: Streamable HTTP
Авторизация: OAuth 2.1 с входом по коду, отправленному на электронную почту, или персональный API-ключ, передаваемый как Bearer-токен
Название в MCP Registry: net.imzala/ictihat

Клиентам, поддерживающим удалённые серверы и OAuth, достаточно указать URL: при первом использовании они запустят процесс входа. Формат конфигурации зависит от клиента. Пример распространённого формата:

{
  "mcpServers": {
    "imzala": { "url": "https://mcp.imzala.net/mcp" }
  }
}

В VS Code файл .vscode/mcp.json использует для той же записи ключ "servers" и параметр "type": "http". В Claude Code выполните команду: claude mcp add --transport http imzala https://mcp.imzala.net/mcp.

Клиенты, которые могут запускать только локальные серверы (stdio), могут использовать мост mcp-remote. Он открывает ту же страницу входа в браузере:

{
  "mcpServers": {
    "imzala": { "command": "npx", "args": ["-y", "mcp-remote@0.1.37", "https://mcp.imzala.net/mcp"] }
  }
}

Вход по коду из письма (OAuth 2.1)

Что увидит пользователь:

Клиент откроет в браузере страницу imzala.net.
Пользователь введёт адрес электронной почты. На него будет отправлен 6-значный код, действительный в течение 10 минут. На ввод кода даётся 5 попыток.
Пользователь введёт код. На странице согласия будет указано приложение, которое запрашивает доступ. Чтобы продолжить, пользователь нажмёт Разрешить (İzin ver).
Браузер вернётся к клиенту, который получит токены.

Пароль не нужен. При первом входе для нового адреса электронной почты автоматически создаётся аккаунт с пробным периодом на 14 дней. После первого входа в браузере сохраняется cookie сроком на 30 дней. Поэтому при подключении другого приложения в том же браузере вводить код не потребуется, но подтвердить согласие всё равно нужно. Пользователь может отключить cookie на странице согласия. Ограничения: не более 5 кодов в час и 10 кодов за 24 часа для одного адреса электронной почты, а также не более 20 кодов в час с одного IP-адреса.

Для разработчиков клиентов:

Неавторизованный запрос к /mcp возвращает 401 с заголовком WWW-Authenticate: Bearer resource_metadata="https://mcp.imzala.net/.well-known/oauth-protected-resource/mcp", scope="ictihat".
Метаданные сервера авторизации: https://mcp.imzala.net/.well-known/oauth-authorization-server
Регистрация клиента: Dynamic Client Registration (RFC 7591) по адресу https://mcp.imzala.net/register или Client ID Metadata Document — HTTPS URL, используемый в качестве client_id. Поддерживаются только публичные клиенты (token_endpoint_auth_method: none).
Поток Authorization Code с PKCE; поддерживается только S256. Области доступа: ictihat, а для получения refresh token — также offline_access. Если передаётся индикатор ресурса, он должен иметь значение https://mcp.imzala.net/mcp. URI перенаправления должны использовать HTTPS или loopback HTTP (localhost, 127.0.0.1, [::1]).
Срок действия access token — 1 час. Refresh token действует 30 дней и заменяется при каждом использовании.

Персональный API key (для клиентов без OAuth)

Откройте https://mcp.imzala.net/anahtar и войдите с помощью кода из письма.
Создайте ключ. Он начинается с imz_ и показывается только один раз. При создании нового ключа можно отозвать старые.
Передавайте ключ с каждым запросом: Authorization: Bearer imz_…

{
  "mcpServers": {
    "imzala": {
      "url": "https://mcp.imzala.net/mcp",
      "headers": { "Authorization": "Bearer ${IMZALA_API_KEY}" }
    }
  }
}

Храните ключ в переменной окружения или защищённом хранилище клиента, но не в репозитории. Способ подстановки ${IMZALA_API_KEY} зависит от клиента.

Проверка подключения

Вызовите kunye_dogrula, указав esas 2023/1532 и karar 2024/250. В ответе должны быть указаны Yargıtay 3. Hukuk Dairesi (3-я гражданская коллегия Верховного суда), 18.01.2024 и результат ONAMA (решение оставлено без изменения).

Поддержка: https://imzala.net/yardim · Политика конфиденциальности: https://imzala.net/api-gizlilik · Условия использования: https://imzala.net/api-kosullar

Лицензия

MIT, см. LICENSE. Лицензия распространяется только на файлы расширения в этом репозитории; на сервис imzala.net и содержимое архива распространяются условия использования.