> ## 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/zh/use-cli)。

    编辑 `~/.gemini/settings.json`，在 `mcpServers` 中添加：

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

  <Tab title="远程访问" icon="globe">
    需要先完成[远程访问配置](/docs/zh/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>