结论先说
- 先分清你敲的是
agy还是gemini,两者的配置文件分家了:新版 Antigravity CLI(agy)把 MCP 独立拆到了~/.gemini/config/mcp_config.json;仍在跑旧版 Gemini CLI(gemini)的用户则继续配在~/.gemini/settings.json的mcpServers字段下。 - 远程服务器地址的字段名变了:在旧 Gemini CLI 里远程 HTTP 地址常写
httpUrl;迁移到 Antigravity CLI 后,官方标准字段是url(兼容serverUrl),且只原生支持 Streamable HTTP(/mcp),不支持旧版纯/sse直连。 - 两代终端都提供交互式
/mcp斜杠命令:进会话后输入/mcp可查看各服务握手状态与工具列表;旧版还支持在终端直接敲gemini mcp add命令快速写入配置。 - 首次运行
agy可一键迁移旧配置:如果本机已有.gemini/settings.json,第一次启动agy时按向导勾选即可自动转换生成新的mcp_config.json。 - 谷歌账号准备与多工具订阅入口:使用 Gemini、Google AI Studio 与 Antigravity 需具备符合地区与年龄要求的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 的 谷歌邮箱成品号),跨平台付费订阅总览见 AI 会员充值中心。

图:本站根据 Antigravity 官方迁移文档 与 MCP 文档 整理的示意图
本文根据 Google Antigravity 官方文档《Model Context Protocol (MCP)》《Migrating from Gemini CLI》《CLI Reference》与 Gemini CLI 官方文档整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Google 官方网站。
适用于谁
- 从原 Gemini CLI(
gemini命令)升级到 Antigravity CLI(agy命令)后,发现以前写在settings.json里的 MCP 工具读不出来的开发者; - 仍在用 API Key 或企业许可跑 Gemini CLI,搜「gemini cli 配置 mcp」想知道
gemini mcp add命令和项目级配置放哪的人; - 配好本地
npx或远程/sse地址后在终端报连接失败、找不到可执行程序的人。
一、配置文件到底在哪个目录(两代 CLI 路径对照)
自 2026 年 6 月个人 Google 账号从 Gemini CLI 转向 Antigravity CLI 后(背景详见 Gemini CLI 与 Antigravity CLI 关系及安装教程),很多网上的旧教程还在教人往 settings.json 里塞 mcpServers,结果在 agy 里完全不生效。对照官方迁移说明,两套路径的准确位置如下:
| 配置维度 | 新版 Antigravity CLI(agy) | 原 Gemini CLI(gemini,API Key / 企业版可用) |
|---|---|---|
| 本机全局配置 | ~/.gemini/config/mcp_config.json | ~/.gemini/settings.json(内含 mcpServers) |
| 当前项目级配置 | .agents/mcp_config.json(或装入项目插件) | .gemini/settings.json(位于仓库根目录) |
| CLI 自身设置文件 | ~/.gemini/antigravity-cli/settings.json | 与全局 settings.json 合用同一文件 |
| 远程端点字段名 | "url"(兼容 "serverUrl",走 Streamable HTTP) | "httpUrl" 或 "url" |
在 Windows PowerShell 里,~ 对应的就是你的用户主目录 C:\Users\<用户名>\。如果你把个人密钥(如 GITHUB_TOKEN 或数据库连接串)写进了 env 字段,请只放在本机全局目录里,不要放进项目级配置提交到 Git 仓库。
二、标准 JSON 写法与命令行添加步骤
1. 在 Antigravity CLI(agy)里写 mcp_config.json
打开或新建 ~/.gemini/config/mcp_config.json,本地命令行工具走 Stdio(填 command、args、env),远程托管服务走 Streamable HTTP(填 url):
json
{
"mcpServers": {
"filesystem-local": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
},
"github-remote": {
"url": "https://api.githubcopilot.com/mcp/",
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
},
"legacy-sse-bridge": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://old-server.example.com/sse"]
}
}
}
保存后在终端启动 agy,在输入框敲 /mcp 回车,就能调出状态面板核对每个服务器是否已连上并列出发现的工具函数。关于两种传输协议的底层差异,可延伸阅读 MCP 的 stdio、SSE 和 Streamable HTTP 区别说明。
2. 在原 Gemini CLI(gemini)里用 gemini mcp add 命令添加
如果你是通过付费 Gemini API Key 或企业许可继续使用 gemini 命令行,除了手改 .gemini/settings.json,还可以直接用自带的子命令往用户级(--scope user)或项目级(--scope project)追加服务:
bash
# 添加本地 Stdio 类型的 MCP 服务器到当前用户全局配置
gemini mcp add --scope user sqlite-local npx -y @modelcontextprotocol/server-sqlite ./app.db
# 添加远程 HTTP 类型的 MCP 服务器并附带认证头
gemini mcp add --transport http --scope project --header "Authorization: Bearer YOUR_TOKEN" team-docs https://mcp.example.com/mcp
# 查看已配置的服务器列表;进入交互会话后可用 /mcp reload 热重载
gemini mcp list
三、常见连接报错与逐项排查

图:本站根据 Antigravity MCP 文档 与 Gemini CLI 参考文档 整理的排错示意图
- Windows 终端报
spawn npx ENOENT或子进程瞬间退出:Windows 上的npx实际是.cmd批处理脚本,部分进程拉起方式直接调npx会找不到可执行文件。把"command": "npx"改成"command": "cmd",再把"args"开头加上["/c", "npx", "-y", ...](或者填where.exe npx查出的绝对路径)即可解决。 - 远程
/sse地址填进agy后一直握手失败:Antigravity 官方文档明确说明不再直接支持 2024-11-05 旧版HTTP+SSE传输。如果对方服务端还没提供/mcp端点,请照上文代码块第 3 段用npx -y mcp-remote <SSE地址>做本地 Stdio 桥接。 - 工具太多拖慢每次提问或互相重名:只把高频刚需服务放全局配置,低频工具用
enabledTools/disabledTools(旧版为includeTools/excludeTools)裁剪暴露出来的函数列表。如果你在多款命令行工具之间共用 MCP,也可对照 Claude Code MCP 配置教程 与 Codex MCP 配置教程。需要准备谷歌开发账号或了解各家编程工具订阅时,可查看本站 谷歌账号购买说明 与 充值服务总览。
常见问题
问:第一次装好 agy 错过了自动迁移提示,怎么手动把旧扩展和配置导过来?
答:按官方迁移文档,可以在终端执行 agy plugin import gemini 把旧版 Gemini CLI 扩展导入转换成 Antigravity 插件,或手动把旧 settings.json 里的 mcpServers 对象复制到 ~/.gemini/config/mcp_config.json 并把 httpUrl 改为 url。
问:为什么连上了 MCP 服务器,智能体调用工具时每次都要停下来等我点确认?
答:默认权限策略下,外部未受信的 MCP 写入或变更操作都会触发人工审批,避免第三方工具误删数据。你可以在 /permissions(或配置文件权限列表)里仅对只读安全的查询工具(如 mcp(docs/*))配置自动允许。
问:改完 mcp_config.json 后需要重启整个电脑终端吗?
答:不需要重启系统终端。在 agy 里用 /mcp 面板刷新重连(或在 gemini 里执行 /mcp reload),或者按 Ctrl+D 退出当前会话重进一次即可加载最新配置。
问:没有可用的个人谷歌账号,或者同时想开其他主流 AI 会员怎么办?
答:本站提供即买即发的 谷歌邮箱成品号(登录方法见 谷歌账号购买页),同时支持支付宝、微信支付与 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服务,实时价格与质保细则以各商品页说明为准。
相关教程
- Gemini CLI 怎么用:安装、登录与 2026-06-18 改用 Antigravity CLI 说明
- MCP 的 stdio、SSE 和 Streamable HTTP 有什么区别
- Claude Code MCP 配置教程:claude mcp add 与配置文件位置
- Codex 怎么配置 MCP:codex mcp add 与 config.toml 写法
参考资料
- Antigravity 官方文档:Model Context Protocol (MCP) — https://antigravity.google/docs/mcp
- Antigravity 官方文档:Migrating from Gemini CLI — https://antigravity.google/docs/gcli-migration
- Antigravity 官方文档:CLI Reference — https://antigravity.google/docs/cli/reference
- Gemini CLI 官方文档:CLI Reference — https://geminicli.com/docs/cli/cli-reference
0 条评论
还没有评论,来抢沙发~