> ## 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.

# Codex で Linkly AI を使う

> Linkly AI のローカルナレッジベースを OpenAI Codex CLI に統合して、コマンドライン AI アシスタントにドキュメントサポートを提供します

## 前提条件

* [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/ja/use-cli) が必要です。その後以下を実行します：

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

  <Tab title="CLI" icon="square-terminal">
    先に [Linkly AI CLI のインストール](/docs/ja/use-cli) が必要です。インストール後、Codex は CLI コマンドを直接呼び出してあなたのドキュメントを検索・閲覧できます：

    ```bash theme={null}
    linkly search "キーワード"
    linkly read <document-id>
    ```
  </Tab>
</Tabs>

<Tip>
  [Linkly AI Skills](/docs/ja/use-skills)
  を同時にインストールすることをお勧めします。AI アシスタントに Linkly AI
  のツールを効率的に使う方法を教え、検索と読み取りの効率を向上させます。
</Tip>

## 接続の確認

追加完了後、Codex で以下のプロンプトを送信して確認します：

```
ドキュメントの中からプロジェクト設計に関する内容を検索して
```

設定が正しければ、Codex が Linkly AI のツールを呼び出して検索結果を返します。

## よくある質問

<AccordionGroup>
  <Accordion title="MCP サービスに接続できない">
    Linkly AI Desktop が起動しており、MCP
    サービスが実行中であることを確認してください。ポートのデフォルトは 60606
    で、Linkly AI の設定で確認できます。
  </Accordion>
</AccordionGroup>