> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Использование Linkly AI в ZCode

> Подключите локальную базу знаний Linkly AI к ZCode, чтобы агент на основе GLM мог искать и читать ваши документы

## Возможности

<AccordionGroup>
  <Accordion title="Чтение спецификаций перед написанием кода">Найдите архитектурные решения и требования через `search`, затем прочитайте нужные разделы через `read`. ZCode будет учитывать соглашения проекта, а не угадывать их.</Accordion>
  <Accordion title="Реальные материалы для Goal Mode и Subagents">При длительном рефакторинге или миграции Goal Mode и Subagents смогут получать локальные материалы по необходимости и сверяться с документацией.</Accordion>
  <Accordion title="Одна база знаний во всех рабочих пространствах">Настройте Linkly AI один раз на уровне пользователя, и все рабочие пространства ZCode получат доступ к тем же документам.</Accordion>
</AccordionGroup>

## Предварительные требования

* Установлен [ZCode](https://zcode.z.ai)
* Linkly AI Desktop запущен, а служба MCP активна

## Настройка

<Tabs>
  <Tab title="Локальный MCP HTTP (рекомендуется)" icon="globe">
    <Steps>
      <Step title="Откройте MCP Servers">В **Settings** перейдите на **MCP Servers** и нажмите **New MCP Server**.</Step>
      <Step title="Выберите область">Выберите **User** для всех проектов или **Workspace** только для текущего.</Step>
      <Step title="Добавьте сервер">Укажите **Type**: `HTTP`, **Name**: `linkly-ai`, **URL**: `http://127.0.0.1:60606/mcp`. Нажмите **Add** и включите переключатель.</Step>
    </Steps>
  </Tab>

  <Tab title="Удалённый MCP" icon="cloud">
    Сначала [настройте удалённый доступ](/docs/ru/use-in-remote); туннель должен иметь статус <Badge stroke color="green">● Подключено</Badge>.

    <Steps>
      <Step title="Откройте MCP Servers">В **Settings** откройте **MCP Servers → New MCP Server**.</Step>
      <Step title="Укажите удалённый сервер">Введите **Type**: `HTTP`, **Name**: `linkly-ai`, **URL**: `https://mcp.linkly.ai/mcp`.</Step>
      <Step title="Добавьте заголовок авторизации">В **Request headers (optional)** добавьте **Key**: `Authorization`, **Value**: `Bearer <your API Key>`. Ключ с префиксом `lkai_` создаётся в [панели Linkly AI](https://linkly.ai/dashboard/integrations).</Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio (резервный вариант)" icon="terminal">
    [Установите Linkly AI CLI](/docs/ru/use-cli), затем измените `~/.zcode/cli/config.json` для пользователя или `<project root>/.zcode/config.json` для проекта:

    ```json theme={null}
    { "mcp": { "servers": { "linkly-ai": { "command": "linkly", "args": ["mcp"], "env": {} } } } }
    ```

    <Note>Файлы называются одинаково, но пользовательский находится в `.zcode/cli/`, а проектный — прямо в `.zcode/`. Ошибка в выборе файла встречается чаще всего.</Note>
    То же можно сделать через **MCP Servers → New MCP Server**: оставьте **Type** `stdio`, укажите **Command** `linkly` и **Args** `mcp`.
  </Tab>
</Tabs>

## Установка Skills

```bash theme={null}
git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.zcode/skills/linkly-ai
```

Откройте **Settings → Skills**, нажмите **Refresh**, затем введите `$` и выберите `linkly-ai`. Подробнее: [Использование Skills](/docs/ru/use-skills).

## Начало работы

* «Найди в моих документах архитектурные решения для этого модуля»
* «Прочитай спецификацию API и проверь соответствие реализации»

## Частые вопросы

<AccordionGroup>
  <Accordion title="Серверы из .agents/mcp.json исчезли">В одной области конфигурация `.zcode` имеет приоритет: если в ней есть MCP-сервер, `.agents/mcp.json` полностью пропускается. Перенесите серверы в `.zcode`.</Accordion>
  <Accordion title="Не работает подключение по HTTP">Проверьте Desktop и MCP командой `curl http://127.0.0.1:60606/mcp`.</Accordion>
  <Accordion title="Сервер есть, но инструменты недоступны">Включите сервер на странице **MCP Servers** или удалите из конфигурации поле `"enable": false`.</Accordion>
  <Accordion title="Stdio не находит linkly">Установите [Linkly AI CLI](/docs/ru/use-cli), проверьте PATH командой `linkly --version`.</Accordion>
</AccordionGroup>