在 Gemini CLI 中使用 Linkly AI

前置条件

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

npm install -g @google/gemini-cli

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", "--client", "gemini-cli"]
    }
  }
}

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

{
  "mcpServers": {
    "linkly-ai": {
      "httpUrl": "https://mcp.linkly.ai/mcp"
    }
  }
}

启动 gemini 后，Gemini CLI 会自动打开浏览器跳到 linkly.ai 授权：登录后确认授权页上写的跳转地址是本机地址（localhost 或 127.0.0.1，Gemini CLI 在本机接收授权结果），再点同意。浏览器没有自动打开，或授权过期后，在 Gemini CLI 中运行 /mcp auth linkly-ai 重新授权。

授权需要在能打开浏览器的电脑上进行，没有图形界面的 SSH 会话里无法完成。不再使用时，可以在控制台「安全」页的「已授权的应用」里撤销。

开始使用

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

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

常见问题

配置文件不存在

首次运行 gemini 会自动创建 ~/.gemini/ 目录。也可以手动创建：

mkdir -p ~/.gemini && touch ~/.gemini/settings.json

工具未被调用

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

AI 助手

编程 AI 代理

AI 工作流

其他

在 Gemini CLI 中使用 Linkly AI

前置条件

配置步骤

开始使用

常见问题

​前置条件

​配置步骤

​开始使用

​常见问题

前置条件

配置步骤

开始使用

常见问题