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

# GitHub Copilot で Linkly AI を使う

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

## 前提条件

* [VS Code](https://code.visualstudio.com) がインストール済みで GitHub Copilot 拡張機能が有効になっていること
* Linkly AI Desktop が起動しており、MCP サービスが実行中であること

## 設定手順

<Tabs>
  <Tab title="MCP HTTP（推奨）" icon="globe">
    <Steps>
      <Step title="コマンドパレットを開く">
        VS Code で `Cmd+Shift+P`（macOS）または `Ctrl+Shift+P`（Windows）を押して、`MCP: Add Server` を入力します。
      </Step>

      <Step title="HTTP タイプを選択して情報を入力">
        **HTTP or HTTPS endpoint** を選択し、以下を入力します：

        * URL：`http://127.0.0.1:60606/mcp`
        * Server ID：`linkly-ai`

        保存場所を選択します（User Settings はすべてのプロジェクトに適用、Workspace Settings は現在のプロジェクトのみに適用）。
      </Step>
    </Steps>

    設定ファイルを直接編集することもできます。`.vscode/mcp.json` またはユーザー MCP 設定に以下を追加します：

    ```json theme={null}
    {
      "servers": {
        "linkly-ai": {
          "url": "http://127.0.0.1:60606/mcp"
        }
      }
    }
    ```
  </Tab>

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

    `.vscode/mcp.json` またはユーザー MCP 設定に以下を追加します：

    ```json theme={null}
    {
      "servers": {
        "linkly-ai": {
          "command": "linkly",
          "args": ["mcp"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

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

## 使い始める

設定完了後、Copilot Chat（`Cmd+Shift+I`）で直接質問するだけで、GitHub Copilot が自動的に Linkly AI のツールを呼び出します。例えば：

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

## よくある質問

<AccordionGroup>
  <Accordion title="Linkly AI ツールが見つからない">
    コマンドパレットで `MCP: List Servers` を実行して、linkly-ai
    サーバーのステータスが Running
    であることを確認してください。エラーが表示される場合は、Linkly AI Desktop
    が起動しているか確認してください。
  </Accordion>

  <Accordion title="Workspace と User Settings の違い">
    * **User
      Settings**：すべてのプロジェクトに適用されます。個人使用に適しています -
      **Workspace
      Settings**（`.vscode/mcp.json`）：現在のプロジェクトにのみ適用されます。チームで共有するために
      Git にコミットできます
  </Accordion>
</AccordionGroup>