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

# Claude Code で Linkly AI を使う

> Linkly AI のローカルナレッジベースを Claude Code に統合して、AI コーディングアシスタントにドキュメント検索・閲覧能力を提供します

## できること

<AccordionGroup>
  <Accordion title="AI に設計ドキュメントを読んでからコードを書かせる">
    ターミナルで Linkly AI の `search`
    ツールを使ってアーキテクチャの意思決定記録を検索し、`read`
    で具体的な規格を読み取ることで、Claude Code
    がプロジェクトの慣例を理解した上でコードを書くため、スタイルの不一致や設計原則違反を減らせます。
  </Accordion>

  <Accordion title="過去の意思決定を追跡して同じ轍を踏まない">
    Linkly AI
    を使って「なぜこのように設計したのか」の記録を素早く見つけることで、AI
    が歴史的な背景を理解した上でより的確なアドバイスをします。コンテキストから切り離された汎用的な解決策ではなく、実際の状況に即した提案が得られます。
  </Accordion>

  <Accordion title="コマンドラインワークフロー内でシームレスにドキュメントを参照">
    ターミナルを離れることなく、Claude Code の会話で Linkly AI の `search`
    ツールを通じてコンピュータ上の要件ドキュメントや API
    仕様を検索できます。頻繁なウィンドウ切り替えに集中を乱されることがありません。
  </Accordion>
</AccordionGroup>

## 前提条件

* [Claude Code](https://claude.ai/code) がインストール済みであること
* Linkly AI Desktop が起動しており、MCP サービスが実行中であること

## 設定手順

<Tabs>
  <Tab title="MCP HTTP（推奨）" icon="globe">
    ターミナルで以下を実行します：

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

  <Tab title="MCP Stdio" icon="terminal">
    先に [Linkly AI CLI のインストール](/docs/ja/use-cli) が必要です。その後以下を実行します：

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

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

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

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

## 接続の確認

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

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

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

## よくある質問

<AccordionGroup>
  <Accordion title="HTTP 方式での接続に失敗する">
    Linkly AI Desktop が起動しており、MCP
    サービスが実行中であることを確認してください。ターミナルで `curl
            http://127.0.0.1:60606/mcp` を実行して接続性をテストできます。
  </Accordion>

  <Accordion title="Stdio 方式で linkly コマンドが見つからないと表示される">
    [Linkly AI CLI がインストール済み](/docs/ja/use-cli)であること、および `linkly`
    コマンドが PATH に含まれていることを確認してください。
  </Accordion>
</AccordionGroup>