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

# Windsurf で Linkly AI を使う

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

## 前提条件

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

## 設定手順

<Tabs>
  <Tab title="MCP HTTP（推奨）" icon="globe">
    MCP 設定ファイルを編集して、`mcpServers` に以下を追加します：

    <CodeGroup>
      ```json macOS / Linux theme={null}
      // ~/.codeium/windsurf/mcp_config.json
      {
        "mcpServers": {
          "linkly-ai": {
            "serverUrl": "http://127.0.0.1:60606/mcp"
          }
        }
      }
      ```

      ```json Windows theme={null}
      // %USERPROFILE%\.codeium\windsurf\mcp_config.json
      {
        "mcpServers": {
          "linkly-ai": {
            "serverUrl": "http://127.0.0.1:60606/mcp"
          }
        }
      }
      ```
    </CodeGroup>

    保存後、Windsurf を再起動します。
  </Tab>

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

    設定ファイルを編集して、`mcpServers` に以下を追加します：

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

    保存後、Windsurf を再起動します。
  </Tab>

  <Tab title="リモートアクセス" icon="globe">
    先に[リモートアクセス設定](/docs/ja/use-in-remote)を完了し、デスクトップアプリのトンネルが{" "}

    <Badge stroke color="green">
      ● 接続済み
    </Badge>

    の状態であることを確認してください。

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "serverUrl": "https://mcp.linkly.ai/mcp",
          "headers": {
            "Authorization": "Bearer ${env:LINKLY_API_KEY}"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  設定ファイルは `${env:VAR_NAME}` 構文をサポートしており、環境変数で API Key を管理して設定ファイルへの平文書き込みを避けられます。
</Tip>

## 使い始める

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

* 「ドキュメントの中から API 設計に関する内容を検索して」
* 「プロジェクトの要件ドキュメントを読んで重要な点をまとめて」

## よくある質問

<AccordionGroup>
  <Accordion title="Cascade にツールが表示されない">
    Windsurf
    が完全に再起動されていること（ウィンドウを閉じるだけでなく）、および設定ファイルの
    JSON 形式が正しいことを確認してください。Cascade の設定で MCP
    サーバーのステータスを確認できます。
  </Accordion>

  <Accordion title="ツール数の上限">
    Windsurf Cascade は最大 100 個のツール（すべての MCP
    サーバーの合計）をサポートしています。ツールの合計数が上限を超えると、一部のツールが利用できない場合があります。
  </Accordion>
</AccordionGroup>