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

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

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

Что нужно до начала. Код доступа — он спрашивается в окне входа коннектора и он же передаётся заголовком в средах без такого окна. Код виден в личном кабинете; если кабинета ещё нет, зарегистрируйтесь. Выданный лично код работает сам по себе, регистрация для него не нужна.

⚠️ Имя коннектора — только латиницей. Из кириллического имени не собираются внутренние идентификаторы инструментов: сервер подключится и будет виден в настройках, но в чате помощник ответит, что не видит его инструменты. Поэтому в поле имени пишите латинскими буквами: Glossa AI. Уже назвали по-русски — удалите запись и заведите заново латиницей.

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

Откройте список MCP-серверов. Settings → MCP Servers → New MCP Server. В форме выберите Scope: значение User открывает коннектор во всех рабочих пространствах, Workspace — только в текущем проекте; для работы с книгой удобнее User. Если коннектор уже настроен у вас в Claude Code или Codex CLI, на той же странице есть кнопка Import — ZCode прочитает их конфигурации и перенесёт серверы, тогда шаг 2 не нужен.
Заполните форму. Type — HTTP (не stdio и не SSE: адрес работает по протоколу Streamable HTTP). URL — адрес из блока ниже. Name — латиницей: Glossa AI.
Войдите. После сохранения ZCode откроет окно входа — введите код доступа и подтвердите. В плашке сверху видно имя клиента и адрес возврата: по ним и видно, что вход запрашивает именно ваша среда, а не сторонний сайт.
Проверьте работу. Задайте агенту вопрос: «Что „Глосса“ пишет о пределах свободы договора по статье 421 ГК РФ?» В ответе должны появиться дословные цитаты со сносками на полосы издания.

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

Адрес коннектора

https://glossa-ai.ru/mcp

Это не адрес страницы, на которой вы сейчас находитесь. Скопируйте адрес кнопкой, а не из адресной строки браузера: вставленный адрес страницы проходит вход, но коннектора по нему нет, и помощник отвечает «no MCP server was found at the provided URL».

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

Форма пишет в те же файлы, которые можно править руками; в окне добавления сервера есть режим полной конфигурации, куда 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 →