Antigravity 配置 MCP 服务器教程:mcp_config.json 位置、Streamable HTTP 与排错

在 Google Antigravity 里怎么挂载数据库、GitHub 或内部文档 MCP 工具?本文按官方文档详解 ~/.gemini/config/mcp_config.json 写法、Streamable HTTP 与旧版 SSE 兼容桥接及连接排错。

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

结论先说

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

Antigravity 支持的两种 MCP 传输方式

图:本站根据 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)→ 注入系统提示词 → 按需路由执行」三步:

  1. 在面板核查工具详情:依次打开 更多选项(Additional Options ...)> MCP Servers,检查目标服务是否已正常拉取到工具函数列表;在 Antigravity 2.0 桌面端的左侧「技能与定制(Skills & Customizations)」面板也能统一管理。
  2. 对话中用 @ 直接点名:在聊天画布输入 @ 呼出引用菜单,切到 MCP servers/tools 分类,可以把特定服务或工具直接挂载进当前指令,避免模型在一大堆工具里选错。
  3. 全局级与插件级隔离:写在 ~/.gemini/config/mcp_config.json 里的服务对所有会话常驻生效(挂载过多工具会占用一定上下文空间);只有特定仓库才用的专属数据库或内网工具,建议封装进插件目录 plugins/<名称>/mcp_config.json,系统还会在必要时自动添加命名空间前缀防止同名冲突。关于工作流技能的按需拆分可参考 Antigravity Skills 编写与加载指南。

三、常见报错与连不上排查清单

Antigravity MCP 连接失败常见排查

图:本站根据 Antigravity 官方文档 整理的排错决策示意图

  1. 桌面图标启动后报 spawn npx ENOENT 或找不到 python:在 macOS 或 Windows 直接双击桌面图标启动 IDE 时,图形界面进程有时读不到你在终端 .zshrc / nvm 里配置的节点路径。解决办法是在终端跑 which npx(Windows 跑 where.exe npx)查出完整绝对路径,直接填进 command 字段。
  2. JSON 多了一个末尾逗号导致整份配置静默失效:标准 JSON 不允许对象最后一个属性后面带逗号,粘贴完建议在编辑器里看一眼有没有语法红线。
  3. 沙箱或网络策略拦住了本地服务发请求:如果你的 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。

相关教程

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 条评论

登录 后参与评论

还没有评论,来抢沙发~