Antigravity CLI(原 Gemini CLI)怎么配置 MCP 服务器:settings.json 位置、添加命令与报错排查

在终端用 Antigravity CLI(agy)或原 Gemini CLI 时,MCP 服务器到底配在 settings.json 还是 mcp_config.json?本文按官方文档讲清两代 CLI 的配置文件路径差异、命令行添加方法与连接排错。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 其他 账号

结论先说

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

Antigravity CLI 与原 Gemini CLI 的 MCP 配置对照

图:本站根据 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

三、常见连接报错与逐项排查

CLI 配置 MCP 常见报错排查决策

图:本站根据 Antigravity MCP 文档 与 Gemini CLI 参考文档 整理的排错示意图

  1. Windows 终端报 spawn npx ENOENT 或子进程瞬间退出:Windows 上的 npx 实际是 .cmd 批处理脚本,部分进程拉起方式直接调 npx 会找不到可执行文件。把 "command": "npx" 改成 "command": "cmd",再把 "args" 开头加上 ["/c", "npx", "-y", ...](或者填 where.exe npx 查出的绝对路径)即可解决。
  2. 远程 /sse 地址填进 agy 后一直握手失败:Antigravity 官方文档明确说明不再直接支持 2024-11-05 旧版 HTTP+SSE 传输。如果对方服务端还没提供 /mcp 端点,请照上文代码块第 3 段用 npx -y mcp-remote <SSE地址> 做本地 Stdio 桥接。
  3. 工具太多拖慢每次提问或互相重名:只把高频刚需服务放全局配置,低频工具用 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 等主流服务,实时价格与质保细则以各商品页说明为准。

相关教程

参考资料

  • 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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 单独备份导出 NotebookLM 笔记本与 Gemini 记录:只勾选指定服务不下载整个云端硬盘的步骤

    想把 NotebookLM 里的几十个研究笔记本、来源副本与音频概览,连同 Gemini 聊天记录一起备份到本地,又怕 Google Takeout 把整个云端硬盘和相册全打包?本文讲清先取消全选、精准勾选两项服务、解压目录查看与跨号迁移的做法。

    Gemini0
  2. 02

    Google Workspace 企业/教育版管理员怎么在后台给成员开启 Gemini 应用、NotebookLM 与设置年龄访问权限

    团队成员或学校师生登录 Google Workspace 账号时提示无权使用 Gemini 或打不开 NotebookLM?本文按 Google 管理控制台官方文档整理服务开关路径、组织部门(OU)与群组放行、18 岁年龄访问权限设置及对话保留合规配置。

    Gemini0
  3. 03

    安卓手机默认助手换成 Gemini 后设闹钟、发短信或控制智能家居失灵怎么办:Workspace 与实用程序扩展开启步骤

    安卓手机把默认语音助手从 Google Assistant 换成 Gemini 后,喊它定闹钟、开手电筒、发短信或开关智能灯全都没反应?本文按官方帮助中心整理实用程序(Utilities)、Google Home 与 Workspace 关联应用开启步骤及锁屏放行设置。

    Gemini0
  4. 04

    Gemini 写长代码或长文档到一半突然停住、格式截断怎么无缝续写:锚点接续指令与 Canvas 分块修改技巧

    让 Gemini 写几百行代码或万字长文时经常写到一半突然停住、Markdown 代码块没闭合,直接回「继续」又重头抄一遍?本文整理字面锚点续写指令、代码块防乱码补齐法与 Canvas 局部圈选修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音频播客(Audio Overview)高阶玩法:用自定义引导词控制对谈深度、受众水平与重点章节(附模板)

    NotebookLM 生成的中文音频播客总是泛泛而谈、漏掉核心章节或夹杂生僻英文缩写?本文按官方帮助中心整理来源勾选过滤、四种播客格式搭配与三维自定义引导词写法,附 4 套可直接复制的中文控场模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 视频、网页或扫描版 PDF 提示「无法导入来源」怎么办:无字幕、反爬与纯图 PDF 逐项解决

    往 NotebookLM(Gemini Notebook)塞 YouTube 链接、外文网页或扫描教材时总是亮红叹号提示无法导入来源?本文按官方帮助中心逐项排查无字幕视频、反爬动态页与加密纯图 PDF 的替代导入步骤。

    Gemini0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~