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 получите ключ
- Войдите в кабинет mizenko.ru (или зарегистрируйтесь) и создайте ключ во вкладке «Ключи».
- Скопируйте токен и сохраните его в личном менеджере паролей. После закрытия страницы он больше не показывается.
- Выберите инструкцию для своего клиента ниже. При добавлении сервера через форму укажите удаленное HTTP-подключение, URL и Bearer token.
Учетная запись mizenko.ru общая для Glossa, Законов РФ и Практики ВС. Настройки с личным ключом храните у себя и не включайте в общий Git-репозиторий.
Получить ключ в кабинете mizenko.ru
Настольные приложения и веб-чаты
Получить ключ в кабинете mizenko.ru
Выберите именно тот интерфейс, которым пользуетесь. Настройка MCP в локальном приложении и подключение в аккаунте веб-чата выполняются по-разному.
| Приложение | Текущий способ |
|---|---|
| Codex · Desktop | Подключение по токену |
| Claude Code · приложение, вкладка Code | Локальные сессии |
| Claude · Web / Desktop Chat / Cowork | OAuth · чтение и поиск |
| ChatGPT · Web | OAuth · чтение и поиск |
| Gemini · Web | Подключение Glossa не подтверждено |
| Google AI Studio / Gemini API | Вариант для разработчиков |
Codex · Desktop
Подключение по токену
- Откройте настройки приложения → MCP servers. Для ручного подключения используются Add server и Streamable HTTP. Имя glossa, URL возьмите из реквизитов выше.
- Чтобы передавать токен, добавьте блок ниже в личный ~/.codex/config.toml (в Windows %USERPROFILE%\.codex\config.toml). Замените YOUR_GLOSSA_TOKEN. Если glossa уже добавлена, обновите ее блок; остальные настройки сохраните.
- В настройках сервера нажмите 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
Локальные сессии
- В настольном приложении Claude откройте вкладку Code и выберите локальную сессию с папкой на вашем компьютере.
- Откройте личный ~/.claude.json (в Windows %USERPROFILE%\.claude.json). Добавьте glossa в верхний объект mcpServers по шаблону ниже и замените YOUR_GLOSSA_TOKEN. Сохраните другие поля и серверы. При настройке через CLI этот блок уже может быть добавлен.
- Перезапустите приложение и создайте новую локальную 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 · чтение и поиск
- Откройте Customize → Connectors → Add custom connector. Укажите Glossa и URL из реквизитов. В рабочей организации подключение может добавлять только администратор.
- Выберите Authentication → OAuth. Войдите через mizenko.ru и разрешите доступ к Glossa.
- Сохраните подключение. В новом чате откройте + → Connectors, включите Glossa и выполните проверочный запрос ниже. Подключение относится к аккаунту и используется в веб- и настольном чате.
Claude и ChatGPT подключаются по OAuth через вход mizenko.ru; для Claude Code, Codex и других клиентов нужен личный ключ из кабинета (Authorization: Bearer mzk_…).
ChatGPT · Web
OAuth · чтение и поиск
- Сначала создайте учетную запись mizenko.ru и сохраните email и пароль. Если учетная запись уже есть, используйте ее; для OAuth не нужно выпускать новый персональный Bearer-ключ.
- В настройках ChatGPT откройте Plugins → Add custom MCP server (в некоторых аккаунтах Apps → Create). Укажите имя Glossa, URL https://mizenko.ru/glossa/mcp и Authentication → OAuth. Доступность зависит от аккаунта и правил рабочего пространства.
- Glossa поддерживает Dynamic Client Registration, поэтому оставьте OAuth client ID и client secret пустыми, если интерфейс позволяет автоматическую регистрацию. Введите email и пароль только на странице mizenko.ru, подтвердите разрешение glossa на чтение и поиск и вернитесь в ChatGPT.
- В новом чате включите Glossa и попросите вызвать glossa_library_status и glossa_list_books. Убедитесь, что появились результаты инструментов; наличие подключения в настройках еще не проверяет работу библиотеки.
Токен доступа обновляется ChatGPT в фоне через refresh token, пока разрешение и доступ аккаунта действуют. Если запрос истек, начните подключение заново. Если client ID/secret обязательны, не подставляйте туда персональный ключ, а уточните доступность DCR у администратора. Полная проверка из вашего аккаунта выполняется после подключения.
Gemini · Web
Подключение Glossa не подтверждено
- В Gemini откройте Settings → Connected Apps → Custom apps. Доступность зависит от региона и аккаунта; по текущей справке Google функция доступна в США, на английском, с личным аккаунтом 18+ и включенным Keep Activity.
- Google описывает добавление MCP URL и Advanced features для серверов без Dynamic Client Registration. Прямой ввод Bearer token в этой справке не описан; совместимость Glossa с этим способом сейчас не подтверждена.
- Если ваш интерфейс не умеет передавать Authorization: Bearer, подключение текущего Glossa через этот диалог не готово. Используйте поддерживаемый клиент выше; для разработки с Google есть вариант API ниже.
Google AI Studio / Gemini API
Вариант для разработчиков
- Обычный чат AI Studio и Gemini Web являются разными интерфейсами. Готовое подключение Glossa через обычный чат AI Studio пока не проверено. В AI Studio доступен Playground → Agents для разработки агентов.
- Для программного подключения официальный Antigravity agent поддерживает remote MCP и headers. В вызов Interactions API добавьте объект ниже в массив tools, заменив YOUR_GLOSSA_TOKEN. Это фрагмент запроса API, а не файл настроек обычного веб-чата.
- Нужны отдельный 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
- Откройте личный файл ~/.codex/config.toml. Если файла нет, создайте его в папке ~/.codex.
- Добавьте блок ниже и замените YOUR_GLOSSA_TOKEN своим ключом. Существующие настройки сохраните; если блок glossa уже есть, обновите его вместо добавления второго.
- Полностью перезапустите 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 = 120Cursor
- Откройте личный файл ~/.cursor/mcp.json. Если файла нет, создайте его в папке ~/.cursor.
- Добавьте glossa внутрь объекта mcpServers и замените YOUR_GLOSSA_TOKEN своим ключом. Если файл пустой, можно вставить пример целиком.
- Сохраните файл и перезапустите Cursor. В режиме Agent разрешите использование инструментов Glossa и отправьте проверочный запрос ниже.
{
"mcpServers": {
"glossa": {
"url": "https://mizenko.ru/glossa/mcp",
"headers": {
"Authorization": "Bearer YOUR_GLOSSA_TOKEN"
}
}
}
}VS Code · Copilot
- Откройте палитру команд сочетанием Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows/Linux. Выполните MCP: Open User Configuration.
- Добавьте glossa в servers и элемент glossa-token в inputs. Если файл пустой, вставьте пример целиком. Существующие серверы и inputs сохраните.
- Через 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
- В установленном Claude Code выполните команду ниже в терминале, предварительно заменив YOUR_GLOSSA_TOKEN своим ключом.
- Параметр --scope user сохраняет подключение для вас во всех проектах. Если сервер glossa уже настроен, обновите существующую настройку.
- Откройте 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 и убедитесь, что в чате есть вызов инструмента, а не только обычный ответ модели.