> ## 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 в Kimi Code

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

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

<AccordionGroup>
  <Accordion title="Ответы по вашим материалам, а не памяти модели">Kimi Code найдёт документы через `search`, затем получит точные разделы через `read`, поэтому ответ будет основан на заметках, спецификациях и отчётах.</Accordion>
  <Accordion title="От поиска к структуре и полному тексту">Используйте `search` для кандидатов, `outline` для структуры длинного документа и `read` только для нужных разделов, не переполняя контекст.</Accordion>
  <Accordion title="Настройка для проекта или для всех проектов">Пользовательская конфигурация наследуется всеми проектами, а одноимённая проектная запись её переопределяет.</Accordion>
</AccordionGroup>

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

* Установлен [Kimi Code CLI](https://www.kimi.com/code), требуется Node.js 22.19.0 или новее
* Linkly AI Desktop запущен, а служба MCP активна

<Note>Руководство относится к **Kimi Code CLI**. В Kimi Work пока можно использовать только готовые плагины, а пользовательские MCP-серверы добавить нельзя.</Note>

## Настройка

Kimi Code читает MCP-серверы из `~/.kimi-code/mcp.json` для пользователя или `.kimi-code/mcp.json` в корне проекта.

<Tabs>
  <Tab title="Локальный MCP HTTP (рекомендуется)" icon="globe">
    ```json theme={null}
    { "mcpServers": { "linkly-ai": { "url": "http://127.0.0.1:60606/mcp" } } }
    ```

    Запись с `url` без `transport` считается HTTP-сервером.
  </Tab>

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

    ```json theme={null}
    { "mcpServers": { "linkly-ai": { "url": "https://mcp.linkly.ai/mcp", "headers": { "Authorization": "Bearer <your API Key>" } } } }
    ```

    API Key с префиксом `lkai_` создаётся в [панели Linkly AI](https://linkly.ai/dashboard/integrations).
  </Tab>

  <Tab title="CLI Stdio (резервный вариант)" icon="terminal">
    Сначала [установите Linkly AI CLI](/docs/ru/use-cli), затем добавьте:

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

    Запись с `command` считается stdio-сервером.
  </Tab>
</Tabs>

<Tip>В TUI Kimi Code можно выполнить `/mcp-config` и управлять серверами интерактивно.</Tip>

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

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

Вызовите `/skill:linkly-ai`. Другие способы: [Использование Skills](/docs/ru/use-skills).

## Проверка подключения

Выполните `/mcp` в TUI Kimi Code: `linkly-ai` должен отображаться как подключённый. Затем отправьте:

```
Найди в моих документах сведения о проектировании проекта
```

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

<AccordionGroup>
  <Accordion title="`kimi mcp add` сообщает о неизвестной команде">Это синтаксис старого `kimi-cli`. Используйте `/mcp-config` или измените `mcp.json`.</Accordion>
  <Accordion title="Не работает подключение по HTTP">Проверьте Desktop и MCP командой `curl http://127.0.0.1:60606/mcp`.</Accordion>
  <Accordion title="Сервер есть, но инструменты не вызываются">Убедитесь, что нет `"enabled": false`, а `disabledTools` не исключает инструменты Linkly AI. Установка Skills также помогает агенту выбирать их.</Accordion>
  <Accordion title="Stdio не находит linkly">Установите [Linkly AI CLI](/docs/ru/use-cli) и проверьте PATH командой `linkly --version`.</Accordion>
</AccordionGroup>
