结论先说
- 本机全局 MCP 配置文件固定在
~/.gemini/config/mcp_config.json:Windows 对应C:\Users\<你的用户名>\.gemini\config\mcp_config.json;如果想随项目或团队插件分发,则放在plugins/<插件名>/mcp_config.json。 - 官方原生支持 Stdio(本地进程)与 Streamable HTTP(远程服务)两种传输:远程地址用
url字段(兼容旧键名serverUrl),通常指向服务端的/mcp路径。 - 不支持旧版纯
HTTP+SSE(/sse)直连:这是最容易踩的坑。如果远端服务只实现了 2024-11-05 旧版 SSE 协议,官方给出的标准解法是在本地用mcp-remote跑成 Stdio 桥接模式。 - 配完先去面板验活:点击界面右上角「更多选项(Additional Options
...)> MCP 服务器(MCP Servers)」,能一眼看到每个服务的连接绿灯与已发现的工具清单。 - 谷歌账号准备与主力编程订阅入口:使用 Antigravity 全系列客户端需登录符合开放地区与年龄条件的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 自动发卡的 谷歌邮箱成品号);多工具主力开发订阅总览见 AI 会员充值中心。

图:本站根据 Antigravity MCP 官方文档 整理的示意图
本文根据 Google Antigravity 官方 MCP 文档(antigravity.google/docs/mcp)整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是软件界面截图。本站(bigolab.com)不是 Google 官方网站。
适用于谁
- 想给 Antigravity 接入本地数据库查询、浏览器测试、Figma 设计稿或公司内部接口工具的开发者;
- 照搬其他编辑器里的远程
/sse地址写进配置却一直报连接失败的人; - 配完 JSON 文件后在工具栏看不到新工具,想知道去哪看报错状态的人。
一、mcp_config.json 放哪、标准语法怎么写
Antigravity 把所有外部 MCP 服务统一收口在 mcpServers 对象下。你可以同时混合配置本地命令行启动的进程与远端托管的微服务:
json
{
"mcpServers": {
"sqlite-local": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "./data/app.db"],
"env": {
"DB_READONLY": "true"
}
},
"team-docs-remote": {
"url": "https://mcp.example.com/mcp"
},
"legacy-sse-bridge": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://old-mcp.example.com/sse"]
}
}
}
三种典型写法的字段要求对照如下:
- 本地 Stdio 服务:必填
command(可执行程序名,如node、python3或二进制路径),可选填参数数组args与注入子进程的环境变量对象env。底层语言服务器(Language Server)会自动拉起子进程并通过标准输入输出通信。 - 远程 Streamable HTTP 服务:必填
url,指向符合 MCP 2025-03-26 规范的端点(常见后缀为/mcp)。 - 旧版 SSE 兼容桥接:当第三方平台只给了一个
/sse结尾的旧地址时,不要填在url里,而是像上面第 3 个示例那样通过npx -y mcp-remote <旧地址>转成标准流接入。
如果你平时还在用 Codex 或 Claude Code,想复用同一批 MCP 服务定义,可以对照本站已有的 Codex 配置 MCP 服务器教程 与 Claude Code 接入 GitHub MCP 实战。需要准备合规谷歌开发账号或开通双工具会员时,可查看 谷歌账号购买页 与 Claude Code 订阅充值页。
二、连接成功后怎么调用与管理作用域
配置保存并成功握手后,Antigravity 会自动走完「查询可用工具(Tool Discovery)→ 注入系统提示词 → 按需路由执行」三步:
- 在面板核查工具详情:依次打开 更多选项(Additional Options
...)> MCP Servers,检查目标服务是否已正常拉取到工具函数列表;在 Antigravity 2.0 桌面端的左侧「技能与定制(Skills & Customizations)」面板也能统一管理。 - 对话中用
@直接点名:在聊天画布输入@呼出引用菜单,切到 MCP servers/tools 分类,可以把特定服务或工具直接挂载进当前指令,避免模型在一大堆工具里选错。 - 全局级与插件级隔离:写在
~/.gemini/config/mcp_config.json里的服务对所有会话常驻生效(挂载过多工具会占用一定上下文空间);只有特定仓库才用的专属数据库或内网工具,建议封装进插件目录plugins/<名称>/mcp_config.json,系统还会在必要时自动添加命名空间前缀防止同名冲突。关于工作流技能的按需拆分可参考 Antigravity Skills 编写与加载指南。
三、常见报错与连不上排查清单

图:本站根据 Antigravity 官方文档 整理的排错决策示意图
- 桌面图标启动后报
spawn npx ENOENT或找不到python:在 macOS 或 Windows 直接双击桌面图标启动 IDE 时,图形界面进程有时读不到你在终端.zshrc/nvm里配置的节点路径。解决办法是在终端跑which npx(Windows 跑where.exe npx)查出完整绝对路径,直接填进command字段。 - JSON 多了一个末尾逗号导致整份配置静默失效:标准 JSON 不允许对象最后一个属性后面带逗号,粘贴完建议在编辑器里看一眼有没有语法红线。
- 沙箱或网络策略拦住了本地服务发请求:如果你的 MCP 工具需要访问外网接口,记得去「设置(Settings)」确认网络访问策略(Internet Access Policy)未被设为全局拒绝。客户端初次上手设置见 Google Antigravity 下载安装教程。
常见问题
问:挂载十几个 MCP 服务器会影响代码响应速度和配额吗?
答:会有影响。每个已激活 MCP 服务暴露出来的工具名称和参数结构都会被注入系统提示词。不常用的重型工具建议拆到插件里按项目开关,日常保持精简。
问:mcp_config.json 里的密钥(如 GITHUB_TOKEN)能提交到代码库吗?
答:绝对不要把明文密钥提交进 Git。包含个人 Token 的服务请一律放在本机用户目录 ~/.gemini/config/mcp_config.json 下,不要放进共享仓库。
问:为什么改了远程端点地址还是连旧地址?
答:前往 Additional Options (...) > MCP Servers 面板手动点一次刷新或重连,让语言服务器重新执行工具发现握手即可。
问:国内没有可用的个人谷歌账号,或者重度写代码想搭配其他编程订阅怎么办?
答:可在本站即时选购带独立 2FA 的 谷歌邮箱成品号(首登顺序与 3 天首登质保细则见 谷歌账号购买页),支持支付宝、微信支付与 AlipayHK;若日常还需要高配额终端智能体互补,也可自助兑换 Claude Code 订阅 或 ChatGPT Plus。
0 条评论
还没有评论,来抢沙发~