Подключение к DeepSeek Harness

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

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

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

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

DeepSeek Harness (команда dsh) — открытая агентная среда DeepSeek, где всё устроено плагинами. MCP-серверы она подключает как клиент, записью в файле профиля. Окна входа здесь нет, доступ передаётся кодом в заголовке. Установка одной командой: npm i -g @deepseek-ai/dsh; профиль web создаётся сам при первом запуске dsh web.

Положите код доступа в переменную окружения. Код виден в личном кабинете; отдельный токен выпускать не нужно. Держите его в переменной, а не в тексте конфигурации: файлы профиля легко попадают в резервные копии и репозитории.
```
export GLOSSA_CODE=ВАШ_КОД_ДОСТУПА
```
Добавьте сервер в патч-слой профиля. Пользовательские правки живут в файле cordis.patch.yml в каталоге профиля; соседний cordis.yml — корень профиля, его не редактируют. Новая запись добавляется через insert, и это главная тонкость: патч без insert считается правкой существующей записи, и dsh молча пропустит его с предупреждением patch: entry … not found.
~/.dsh/profiles/web/cordis.patch.yml
```
- insert:
    - id: mcp-glossa
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: glossa
        transport: streamable-http
        url: https://glossa.legal/mcp
        headers:
          Authorization: !!js '`Bearer ${process.env.GLOSSA_CODE}`'
        toolCallTimeoutMs: 180000
```
В serverName допустимы латиница, цифры, дефис и подчёркивание: из него собираются имена инструментов mcp__glossa__….
Проверьте, что запись попала в дерево профиля. Собранную конфигурацию печатает отдельная команда, среду она при этом не запускает.
```
dsh --profile web --dump-config | tail -20
```
В конце вывода должна появиться ваша запись с пометкой источника # == ~/.dsh/profiles/web/cordis.patch.yml. Вместо неё напечаталось patch: entry … not found — потерян insert из шага 2.
Запустите dsh и убедитесь, что плагин поднялся. Команда dsh web поднимет локальный веб-интерфейс. Откройте Settings → Plugins, вкладка Plugin list, введите в поиск mcp: запись mcp-client в состоянии Enabled означает, что клиент смонтирован. Дальше задайте вопрос: «Что „Глосса“ пишет о пределах свободы договора по статье 421 ГК РФ?»

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

https://glossa.legal/mcp

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

Полезные поля плагина

toolCallTimeoutMs — таймаут одного вызова инструмента. По умолчанию 60 000 мс; если вызовы обрываются на длинных исследованиях, ставьте 180 000.
failOnStartupError — при значении true сборка не поднимется, если коннектор недоступен. Удобно, чтобы не работать «без книги» незаметно для себя.
reconnect.enabled — автоматическое переподключение после обрыва связи, включено по умолчанию.

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

При старте предупреждение «patch: entry … not found»

В патче потерян insert. Без него запись считается правкой уже существующего плагина с таким id, и dsh её пропускает: коннектор просто не появляется, без явной ошибки. Сверьтесь с блоком из шага 2 и повторите dsh --profile web --dump-config.

Плагин Enabled, но инструментов у модели нет

Клиент активируется даже при неудачном подключении, так задумано: сборка не должна падать из-за недоступного сервера. Проверьте, что переменная GLOSSA_CODE видна процессу — то есть экспортирована в той же оболочке, из которой запускается dsh. Чтобы такие случаи были заметны сразу, поставьте failOnStartupError: true.

Транспорт: streamable-http или sse?

Только streamable-http. Адрес работает по Streamable HTTP; со значением sse или stdio подключение не устанавливается.

Вызов инструмента обрывается по таймауту

Поставьте toolCallTimeoutMs: 180000: тяжёлый вопрос вызывает несколько обращений к книге подряд.

← Подключение: выбор среды Как пользоваться коннектором →