在 Gemini CLI 中使用 Linkly AI

前置条件

已安装 Gemini CLI
Linkly AI Desktop 已启动，MCP 服务正在运行

bash 通过 npm 安装 npm install -g @google/gemini-cli  bash 通过     Homebrew 安装（macOS） brew install google-gemini/gemini-cli/gemini-cli 

配置步骤

MCP HTTP（推荐）
MCP Stdio
远程访问

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

{
  "mcpServers": {
    "linkly-ai": {
      "httpUrl": "http://127.0.0.1:60606/mcp"
    }
  }
}

需要先安装 Linkly AI CLI。编辑 ~/.gemini/settings.json，在 mcpServers 中添加：

{
  "mcpServers": {
    "linkly-ai": {
      "command": "linkly",
      "args": ["mcp"]
    }
  }
}

需要先完成远程访问配置，桌面端隧道显示● 已连接。编辑 ~/.gemini/settings.json：

{
  "mcpServers": {
    "linkly-ai": {
      "httpUrl": "https://mcp.linkly.ai/mcp",
      "headers": {
        "Authorization": "Bearer <你的 API Key>"
      }
    }
  }
}

配置文件支持 ${env:VAR_NAME} 语法读取环境变量，避免将 API Key 明文写入文件：

"Authorization": "Bearer ${env:LINKLY_API_KEY}"

开始使用

配置完成后，启动 Gemini CLI 并直接提问：

gemini
> 搜索我的文档中关于项目架构的内容

常见问题

配置文件不存在

首次运行 gemini 会自动创建 ~/.gemini/ 目录。也可以手动创建： bash mkdir -p ~/.gemini && touch ~/.gemini/settings.json

工具未被调用

在 Gemini CLI 中运行 /mcp 命令查看已加载的 MCP 服务器列表，确认 linkly-ai 出现在其中。

在 Claude Code 中使用 Linkly AI

在 ZCode 中使用 Linkly AI

AI 助手

编程 AI 代理

AI 工作流

其他

在 Gemini CLI 中使用 Linkly AI

前置条件

配置步骤

开始使用

常见问题

​前置条件

​配置步骤

​开始使用

​常见问题

前置条件

配置步骤

开始使用

常见问题