ГлоссаГЛОССАAIпо подписке
Войти

← Как подключить

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

Четыре шага, около минуты. Доступ один на все среды: подключённая «Глосса» в другой программе от этого не отвалится, код доступа тот же.

⚠️ Среда без гарантии. Коннектор проверен в Claude, ChatGPT, Grok и Hermes — сбои в них мы чиним. ZCode работает по тому же стандарту MCP, и шаги ниже перенесены из проверенной инструкции, но стабильность конкретной версии среды мы не обещаем.
Что нужно до начала. В процессе добавления коннектора вам нужно будет ввести код доступа — он спрашивается в окне авторизации коннектора. Поэтому скопируйте его заранее на странице вашего личного кабинета; если кабинета ещё нет, зарегистрируйтесь.

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

  1. Откройте список MCP-серверов. Settings → MCP Servers → New MCP Server. В форме выберите Scope: значение User открывает коннектор во всех рабочих пространствах, Workspace — только в текущем проекте; для работы с книгой удобнее User. Если коннектор уже настроен у вас в Claude Code или Codex CLI, на той же странице есть кнопка Import — ZCode прочитает их конфигурации и перенесёт серверы, тогда шаг 2 не нужен.
  2. Заполните форму. Type — HTTP (не stdio и не SSE: адрес работает по протоколу Streamable HTTP). URL — адрес коннектора https://glossa-ai.ru/mcp. Name — латиницей: Glossa AI.
  3. Войдите. После сохранения ZCode откроет окно входа — введите код доступа и подтвердите. В плашке сверху видно имя клиента и адрес возврата: по ним и видно, что вход запрашивает именно ваша среда, а не сторонний сайт.
  4. Проверьте работу. Задайте агенту вопрос: «Что „Глосса“ пишет о пределах свободы договора по статье 421 ГК РФ?» В ответе должны появиться дословные цитаты со сносками на полосы издания.
Вариант без окна входа. Если ZCode работает на сервере и браузер открыть негде, добавьте в форме секцию Headers: поле Authorization, значение Bearer ВАШ_КОД_ДОСТУПА. Код виден в личном кабинете; выпускать отдельный токен не нужно.

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

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

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

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

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

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

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

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

Проверьте код доступа в личном кабинете: возможно, вы вводили не его, а пароль от кабинета — форма коннектора принимает только код.

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

Используйте вариант с заголовком: секция Headers, поле Authorization, значение Bearer ВАШ_КОД_ДОСТУПА. Работающие подключения в других средах это не отзывает.

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

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

← Подключение: выбор средыИнструкция для DeepSeek Harness →