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

# Gemini CLI で Linkly AI を使う

> Linkly AI のローカルナレッジベースを Google Gemini CLI に統合して、ターミナル AI エージェントがあなたのプライベートドキュメントを検索・閲覧できるようにします

## 前提条件

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

<CodeGroup>
  `bash npm でインストール npm install -g @google/gemini-cli ` `bash
      Homebrew でインストール（macOS） brew install
      google-gemini/gemini-cli/gemini-cli `
</CodeGroup>

## 設定手順

<Tabs>
  <Tab title="MCP HTTP（推奨）" icon="globe">
    `~/.gemini/settings.json` を編集して、`mcpServers` に以下を追加します：

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

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

    `~/.gemini/settings.json` を編集して、`mcpServers` に以下を追加します：

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

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

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

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

    `~/.gemini/settings.json` を編集します：

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "httpUrl": "https://mcp.linkly.ai/mcp",
          "headers": {
            "Authorization": "Bearer <あなたの API Key>"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  設定ファイルは環境変数を読み取る `${env:VAR_NAME}` 構文をサポートしており、API Key をファイルに平文で書き込むことを避けられます：

  ```json theme={null}
  "Authorization": "Bearer ${env:LINKLY_API_KEY}"
  ```
</Tip>

## 使い始める

設定完了後、Gemini CLI を起動して直接質問します：

```bash theme={null}
gemini
> ドキュメントの中からプロジェクトアーキテクチャに関する内容を検索して
```

## よくある質問

<AccordionGroup>
  <Accordion title="設定ファイルが存在しない">
    初回の `gemini` 実行時に `~/.gemini/`
    ディレクトリが自動作成されます。手動で作成することもできます： `bash mkdir
            -p ~/.gemini && touch ~/.gemini/settings.json `
  </Accordion>

  <Accordion title="ツールが呼び出されない">
    Gemini CLI で `/mcp` コマンドを実行して読み込み済みの MCP
    サーバーリストを確認し、linkly-ai
    がリストに表示されていることを確認してください。
  </Accordion>
</AccordionGroup>