Gemini CLI MCP 配置：一条命令5步接好

Gemini CLI 接 MCP 服务器有两种姿势：一条命令 gemini mcp add，或者编辑 .gemini/settings.json 手写 mcpServers。前者适合现成的 stdio/HTTP 服务器，后者适合要传环境变量、要自定义参数的服务。配完统一用 /mcp list 验证，整个过程 5 分钟以内。基础用法可以看 Gemini CLI 使用教程，免费额度规则见 Gemini CLI 免费额度指南。

前置准备

先确认三样：Gemini CLI 已安装（官方仓库 google-gemini/gemini-cli）；需要 npx 启动的服务器要先有 Node.js；网络能访问服务器地址。远程 HTTP 服务器还需要有访问凭证或 API key，按服务器文档准备。

方式一：gemini mcp add 一条命令

命令结构是 gemini mcp add [选项] 服务器名 启动命令或地址。常用选项两个：-s 指定作用域（user 存用户级配置，project 存项目级配置），-t 指定传输方式（stdio 或 http，SSE 服务器按文档转 http）。

官方文档（Google 官方配置文档）里最完整的例子是接 Maps Code Assist：

1. 执行命令：

gemini mcp add -s user -t http maps-code-assist-mcp https://mapscodeassist.googleapis.com/mcp

1. 看到已添加到用户设置的确认消息即成功。

2. 验证：

/mcp list

输出类似：

Configured MCP servers:
maps-code-assist-mcp - Ready (2 tools)
Tools:
- retrieve-google-maps-platform-docs
- retrieve-instructions

出现 Ready 和工具数量就说明接好了。本地 stdio 服务器同理，把 -t 换成 stdio，地址换成启动命令，比如 gemini mcp add -s project playwright npx -y @playwright/mcp@latest 这类写法（具体包名以服务器文档为准）。

方式二：settings.json 手写配置

要传环境变量的服务器用配置文件更稳。在项目目录建 .gemini/settings.json，写进 mcpServers 字段：

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"],
      "env": {
        "INTEGRATION_IDE": "Gemini"
      }
    }
  }
}

这是腾讯云 CloudBase 官方接入示例：command 是启动命令，args 是参数数组，env 传环境变量。改完重启 Gemini CLI 再对话，让它调用 cloudbase 的工具即可。

验证与常用命令

任何时候在 Gemini CLI 对话里输入 /mcp list 都能看到已配置的服务器和各自工具数。加错了用 /mcp remove 服务器名 移除。user 和 project 两个作用域互不影响，同一个服务器名在两个作用域都存在时，以更具体的为准。

常见报错速查

安全提醒

MCP 服务器拿到的是执行权限，能跑代码、改文件。官方文档的提醒很直接：只添加可信来源的服务器。环境变量里别硬编码密钥，用 .env 或密钥管理方案传递。

想在 n8n 里接 MCP 的流程参考 n8n MCP 接入教程，浏览器调试场景看 Chrome DevTools MCP 指南。