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

# Cursor で Linkly AI を使う

> Linkly AI のローカルナレッジベースを Cursor に統合して、AI コーディングアシスタントがあなたのプロジェクトドキュメントを検索・閲覧できるようにします

## できること

<AccordionGroup>
  <Accordion title="コーディング中に自動で要件ドキュメントを参照">
    手動でコピーペーストする必要はありません。Cursor が Linkly AI の `read`
    ツールを通じてあなたのコンピュータのプロダクト仕様ドキュメントを直接読み取り、コード生成前に要件を理解するため、認識のズレによる手戻りを減らせます。
  </Accordion>

  <Accordion title="プロジェクト内部ドキュメントを精確に検索">
    Linkly AI の `search` ツールでローカルドキュメントから API
    仕様・データ辞書・技術規格を素早く見つけられます。エディタから別ウィンドウに切り替えてドキュメントを探す必要がありません。
  </Accordion>

  <Accordion title="ビジネスコンテキストを踏まえてデバッグ">
    デバッグ時に Cursor が Linkly AI
    を通じてビジネスロジックドキュメントを読み取ることで、AI
    がビジネスルールを理解して問題の根本原因を特定しやすくなり、コードだけを見て判断することがなくなります。
  </Accordion>
</AccordionGroup>

## 前提条件

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

## 設定手順

<Tabs>
  <Tab title="MCP HTTP（推奨）" icon="globe">
    <Steps>
      <Step title="MCP 設定を開く">
        Cursor で **Settings → MCP Servers → Add Server** を開きます。
      </Step>

      <Step title="Linkly AI MCP を追加">
        以下の情報を入力します：

        * Name：`linkly-ai`
        * Type：`StreamableHTTP`
        * URL：`http://127.0.0.1:60606/mcp`
      </Step>
    </Steps>
  </Tab>

  <Tab title="MCP Stdio" icon="terminal">
    先に [Linkly AI CLI のインストール](/docs/ja/use-cli) が必要です。

    <Steps>
      <Step title="MCP 設定を開く">
        Cursor で **Settings → MCP Servers → Add Server** を開きます。
      </Step>

      <Step title="Linkly AI MCP を追加">
        以下の情報を入力します：

        * Name：`linkly-ai`
        * Type：`stdio`
        * Command：`linkly`
        * Args：`mcp`
      </Step>
    </Steps>
  </Tab>

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

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

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

## 使い始める

設定完了後、Cursor の AI 会話で直接質問するだけで、Cursor が自動的に Linkly AI のツールを呼び出します。例えば：

* 「ドキュメントの中からデータベース設計に関する内容を検索して」
* 「プロジェクトの API ドキュメントを読んで」

## よくある質問

<AccordionGroup>
  <Accordion title="MCP サービスに接続できない">
    以下を確認してください： 1. Linkly AI Desktop が起動しているか 2. MCP
    サービスが実行中か（設定に Running と表示） 3. ポート番号が 60606
    であること（Linkly AI の設定で確認できます）
  </Accordion>
</AccordionGroup>
