к содержимому
← О проекте Glossa

Glossa · Подключение

Комментарии к ГК РФ прямо в ИИ-ассистенте

Пошаговая инструкция о том, как подключить библиотеку Glossa к Claude, ChatGPT, Claude Code, Codex или Cursor. Claude и ChatGPT подключаются по OAuth; для остальных клиентов создайте личный ключ в кабинете mizenko.ru после подтверждения почты.

Ничего устанавливать не нужно, сервер работает на mizenko.ru. Понадобится только аккаунт mizenko.ru, общий для Glossa, Законов РФ и Практики ВС.

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

Все, что нужно для подключения

Claude и ChatGPT подключаются по OAuth через вход mizenko.ru; для Claude Code, Codex и других клиентов нужен личный ключ из кабинета (Authorization: Bearer mzk_…). Библиотека и поиск работают на сервере, поэтому исходный код, книги, SQLite, Python и модели скачивать не требуется.

Реквизиты подключения

Имя подключения
glossa
URL сервера
https://mizenko.ru/glossa/mcp
Транспорт
Streamable HTTP
Авторизация
Bearer token
HTTP-заголовок
Authorization: Bearer YOUR_GLOSSA_TOKEN
Срок ключа
выбирается в кабинете

В поле «Token» / «API key» вставляйте только ключ. Если клиент предлагает HTTP-заголовки, укажите Authorization и значение Bearer, пробел, ваш ключ. YOUR_GLOSSA_TOKEN служит местом для замены, а не рабочим токеном. Email и пароль нужны только для входа на сайт.

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

  1. Войдите в кабинет mizenko.ru (или зарегистрируйтесь) и создайте ключ во вкладке «Ключи».
  2. Скопируйте токен и сохраните его в личном менеджере паролей. После закрытия страницы он больше не показывается.
  3. Выберите инструкцию для своего клиента ниже. При добавлении сервера через форму укажите удаленное HTTP-подключение, URL и Bearer token.

Учетная запись mizenko.ru общая для Glossa, Законов РФ и Практики ВС. Настройки с личным ключом храните у себя и не включайте в общий Git-репозиторий.

Получить ключ в кабинете mizenko.ru

Настольные приложения и веб-чаты

Получить ключ в кабинете mizenko.ru

Выберите именно тот интерфейс, которым пользуетесь. Настройка MCP в локальном приложении и подключение в аккаунте веб-чата выполняются по-разному.

Совместимость клиентов с авторизацией Glossa
ПриложениеТекущий способ
Codex · DesktopПодключение по токену
Claude Code · приложение, вкладка CodeЛокальные сессии
Claude · Web / Desktop Chat / CoworkOAuth · чтение и поиск
ChatGPT · WebOAuth · чтение и поиск
Gemini · WebПодключение Glossa не подтверждено
Google AI Studio / Gemini APIВариант для разработчиков
Codex · Desktop

Подключение по токену

  1. Откройте настройки приложения → MCP servers. Для ручного подключения используются Add server и Streamable HTTP. Имя glossa, URL возьмите из реквизитов выше.
  2. Чтобы передавать токен, добавьте блок ниже в личный ~/.codex/config.toml (в Windows %USERPROFILE%\.codex\config.toml). Замените YOUR_GLOSSA_TOKEN. Если glossa уже добавлена, обновите ее блок; остальные настройки сохраните.
  3. В настройках сервера нажмите Restart или полностью перезапустите приложение. В новой локальной задаче введите /mcp и выполните проверочный запрос внизу страницы.
[mcp_servers.glossa]
url = "https://mizenko.ru/glossa/mcp"
http_headers = { Authorization = "Bearer YOUR_GLOSSA_TOKEN" }
startup_timeout_sec = 30
tool_timeout_sec = 120

Настройки общие с Codex CLI на том же компьютере. Локальное подключение не переносится автоматически в облачную задачу. В новых версиях приложение может называться ChatGPT Desktop с локальным Codex.

Claude Code · приложение, вкладка Code

Локальные сессии

  1. В настольном приложении Claude откройте вкладку Code и выберите локальную сессию с папкой на вашем компьютере.
  2. Откройте личный ~/.claude.json (в Windows %USERPROFILE%\.claude.json). Добавьте glossa в верхний объект mcpServers по шаблону ниже и замените YOUR_GLOSSA_TOKEN. Сохраните другие поля и серверы. При настройке через CLI этот блок уже может быть добавлен.
  3. Перезапустите приложение и создайте новую локальную Code-сессию. Попросите показать доступные инструменты Glossa и вызвать glossa_list_books.
{
  "mcpServers": {
    "glossa": {
      "type": "http",
      "url": "https://mizenko.ru/glossa/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GLOSSA_TOKEN"
      }
    }
  }
}

Файл ~/.claude.json используется и CLI, и локальной вкладкой Code. Для обычного чата Claude используйте следующую инструкцию; для SSH-сессии настройки должны находиться на выбранной машине.

Claude · Web / Desktop Chat / Cowork

OAuth · чтение и поиск

  1. Откройте Customize → Connectors → Add custom connector. Укажите Glossa и URL из реквизитов. В рабочей организации подключение может добавлять только администратор.
  2. Выберите Authentication → OAuth. Войдите через mizenko.ru и разрешите доступ к Glossa.
  3. Сохраните подключение. В новом чате откройте + → Connectors, включите Glossa и выполните проверочный запрос ниже. Подключение относится к аккаунту и используется в веб- и настольном чате.

Claude и ChatGPT подключаются по OAuth через вход mizenko.ru; для Claude Code, Codex и других клиентов нужен личный ключ из кабинета (Authorization: Bearer mzk_…).

ChatGPT · Web

OAuth · чтение и поиск

  1. Сначала создайте учетную запись mizenko.ru и сохраните email и пароль. Если учетная запись уже есть, используйте ее; для OAuth не нужно выпускать новый персональный Bearer-ключ.
  2. В настройках ChatGPT откройте Plugins → Add custom MCP server (в некоторых аккаунтах Apps → Create). Укажите имя Glossa, URL https://mizenko.ru/glossa/mcp и Authentication → OAuth. Доступность зависит от аккаунта и правил рабочего пространства.
  3. Glossa поддерживает Dynamic Client Registration, поэтому оставьте OAuth client ID и client secret пустыми, если интерфейс позволяет автоматическую регистрацию. Введите email и пароль только на странице mizenko.ru, подтвердите разрешение glossa на чтение и поиск и вернитесь в ChatGPT.
  4. В новом чате включите Glossa и попросите вызвать glossa_library_status и glossa_list_books. Убедитесь, что появились результаты инструментов; наличие подключения в настройках еще не проверяет работу библиотеки.

Токен доступа обновляется ChatGPT в фоне через refresh token, пока разрешение и доступ аккаунта действуют. Если запрос истек, начните подключение заново. Если client ID/secret обязательны, не подставляйте туда персональный ключ, а уточните доступность DCR у администратора. Полная проверка из вашего аккаунта выполняется после подключения.

Gemini · Web

Подключение Glossa не подтверждено

  1. В Gemini откройте Settings → Connected Apps → Custom apps. Доступность зависит от региона и аккаунта; по текущей справке Google функция доступна в США, на английском, с личным аккаунтом 18+ и включенным Keep Activity.
  2. Google описывает добавление MCP URL и Advanced features для серверов без Dynamic Client Registration. Прямой ввод Bearer token в этой справке не описан; совместимость Glossa с этим способом сейчас не подтверждена.
  3. Если ваш интерфейс не умеет передавать Authorization: Bearer, подключение текущего Glossa через этот диалог не готово. Используйте поддерживаемый клиент выше; для разработки с Google есть вариант API ниже.
Google AI Studio / Gemini API

Вариант для разработчиков

  1. Обычный чат AI Studio и Gemini Web являются разными интерфейсами. Готовое подключение Glossa через обычный чат AI Studio пока не проверено. В AI Studio доступен Playground → Agents для разработки агентов.
  2. Для программного подключения официальный Antigravity agent поддерживает remote MCP и headers. В вызов Interactions API добавьте объект ниже в массив tools, заменив YOUR_GLOSSA_TOKEN. Это фрагмент запроса API, а не файл настроек обычного веб-чата.
  3. Нужны отдельный Gemini API key, доступ к выбранному агенту и собственный вызов API. Запросите glossa_list_books и проверьте фактический вызов инструмента. Использование Google API может оплачиваться отдельно; этот сценарий с Glossa не проходил проверку из вашего аккаунта.
{
  "type": "mcp_server",
  "name": "glossa",
  "url": "https://mizenko.ru/glossa/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_GLOSSA_TOKEN"
  },
  "allowed_tools": [
    "glossa_library_status",
    "glossa_list_books",
    "glossa_search",
    "glossa_read_passage"
  ]
}

Сверено с официальной документацией 9 октября 2026. Названия пунктов и доступность функций могут отличаться в вашем аккаунте. Токен Glossa используется в настройках подключения, а не в сообщениях ассистенту.

Редакторы и терминал

Codex · CLI
  1. Откройте личный файл ~/.codex/config.toml. Если файла нет, создайте его в папке ~/.codex.
  2. Добавьте блок ниже и замените YOUR_GLOSSA_TOKEN своим ключом. Существующие настройки сохраните; если блок glossa уже есть, обновите его вместо добавления второго.
  3. Полностью перезапустите Codex. Для проверки в CLI выполните codex mcp list, затем отправьте ассистенту проверочный запрос ниже.
[mcp_servers.glossa]
url = "https://mizenko.ru/glossa/mcp"
http_headers = { Authorization = "Bearer YOUR_GLOSSA_TOKEN" }
startup_timeout_sec = 30
tool_timeout_sec = 120
Cursor
  1. Откройте личный файл ~/.cursor/mcp.json. Если файла нет, создайте его в папке ~/.cursor.
  2. Добавьте glossa внутрь объекта mcpServers и замените YOUR_GLOSSA_TOKEN своим ключом. Если файл пустой, можно вставить пример целиком.
  3. Сохраните файл и перезапустите Cursor. В режиме Agent разрешите использование инструментов Glossa и отправьте проверочный запрос ниже.
{
  "mcpServers": {
    "glossa": {
      "url": "https://mizenko.ru/glossa/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GLOSSA_TOKEN"
      }
    }
  }
}
VS Code · Copilot
  1. Откройте палитру команд сочетанием Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows/Linux. Выполните MCP: Open User Configuration.
  2. Добавьте glossa в servers и элемент glossa-token в inputs. Если файл пустой, вставьте пример целиком. Существующие серверы и inputs сохраните.
  3. Через MCP: List Servers выберите glossa и запустите сервер. Когда VS Code запросит Glossa personal token, вставьте только ключ, без слова Bearer. Затем используйте чат Copilot в режиме Agent.
{
  "servers": {
    "glossa": {
      "type": "http",
      "url": "https://mizenko.ru/glossa/mcp",
      "headers": {
        "Authorization": "Bearer ${input:glossa-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "glossa-token",
      "description": "Glossa personal token",
      "password": true
    }
  ]
}

Этот вариант рассчитан на локальный чат VS Code с поддержкой inputs. Сессии Agent Host не получают серверы с интерактивным вводом токена.

Claude Code · CLI
  1. В установленном Claude Code выполните команду ниже в терминале, предварительно заменив YOUR_GLOSSA_TOKEN своим ключом.
  2. Параметр --scope user сохраняет подключение для вас во всех проектах. Если сервер glossa уже настроен, обновите существующую настройку.
  3. Откройте Claude Code и выполните /mcp, чтобы проверить состояние Glossa. Затем отправьте проверочный запрос ниже.
claude mcp add --transport http --scope user glossa https://mizenko.ru/glossa/mcp \
  --header "Authorization: Bearer YOUR_GLOSSA_TOKEN"

Команда содержит личный ключ и может сохраниться в истории терминала. Не отправляйте ее другим людям.

Шаблоны выше содержат только настройки подключения. В них нет действующих ключей. Добавляйте нужный блок в свои настройки, сохраняя уже подключенные серверы.

Как проверить, что все работает

Включите инструменты Glossa в своем клиенте и отправьте ассистенту такой запрос.

Вызови glossa_library_status и glossa_list_books.
Покажи состояние библиотеки и список доступных книг.

Затем попросите «Найди в Glossa комментарии к статье 10 ГК РФ, прочитай найденные фрагменты и укажи книгу и ссылку на источник». В чате должны появиться вызовы инструментов и результаты из библиотеки.

Открытие URL в браузере само по себе не проверяет MCP, подключение устанавливает ваш клиент. Полноценной проверкой служит успешный вызов инструментов.

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

401 · Unauthorized
Проверьте ключ, пробел после Bearer и URL целиком. Истекший или замененный токен не работает; войдите на этой странице, получите новый и обновите настройки.
429 · Too Many Requests
Доступ ограничен 60 HTTP-запросами в минуту и двумя одновременно, включая служебные запросы MCP. Подождите указанное в Retry-After время и повторите запрос.
OAuth в ChatGPT
Выберите OAuth и следуйте инструкции ChatGPT выше. Авторизуйтесь существующим email и паролем на mizenko.ru. Истекший запрос начните заново из ChatGPT; персональный Bearer-ключ не нужен в полях client ID/secret.
Ассистент отвечает без источников
Проверьте, что сервер включен и инструменты разрешены. Прямо попросите использовать Glossa и убедитесь, что в чате есть вызов инструмента, а не только обычный ответ модели.