> ## 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 в Codex

> Подключите локальную базу знаний Linkly AI к OpenAI Codex CLI и дайте консольному ИИ-помощнику возможность искать и читать документы

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

* Установлен [Codex CLI](https://github.com/openai/codex)
* Linkly AI Desktop запущен, а служба MCP активна

## Настройка

<Tabs>
  <Tab title="MCP HTTP (рекомендуется)" icon="globe">
    Выполните в терминале:

    ```bash theme={null}
    codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp
    ```
  </Tab>

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

    ```bash theme={null}
    codex mcp add linkly-ai -- linkly mcp
    ```
  </Tab>

  <Tab title="CLI" icon="square-terminal">
    Сначала [установите Linkly AI CLI](/docs/ru/use-cli). После установки Codex сможет напрямую вызывать команды CLI для поиска и чтения документов:

    ```bash theme={null}
    linkly search "keyword"
    linkly read <document-id>
    ```
  </Tab>
</Tabs>

<Warning>Codex может запускать команды оболочки в сетевой песочнице, где команда `linkly` доступна, но подключение к Linkly AI Desktop через localhost запрещено. Если `linkly status` сообщает `App: Unreachable`, не делайте вывод, что Desktop остановлен. Используйте настроенную интеграцию Linkly MCP. Если MCP недоступен, разрешайте повторный запуск вне сетевой песочницы только для конкретной команды Linkly CLI; не отключайте песочницу целиком. Просите пользователя запустить Desktop лишь в том случае, если разрешённый повторный запуск тоже завершился ошибкой.</Warning>

<Tip>Рекомендуем также установить [Linkly AI Skills](/docs/ru/use-skills): они научат ИИ-помощника эффективно пользоваться инструментами Linkly AI и повысят качество поиска и чтения.</Tip>

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

После добавления отправьте в Codex следующий запрос:

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

Если всё настроено правильно, Codex вызовет инструменты Linkly AI и вернёт результаты поиска.

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

<AccordionGroup>
  <Accordion title="Не удаётся подключиться к службе MCP">Убедитесь, что Linkly AI Desktop запущен, а служба MCP активна. По умолчанию используется порт 60606; его можно проверить в настройках Linkly AI.</Accordion>
</AccordionGroup>