Antigravity 里装官方插件还是自建 MCP?以 Notion 为例拆解异同与选型
以 Notion 为例拆解 Antigravity 官方/合作插件与独立自建 MCP 在打包形式、传输协议、命名空间与跨端复用上的异同,给出完整平滑切换步骤、四项避坑指南与选型建议。
1. 起因与结论先行
今天整理本机 Antigravity 的 ~/.gemini/config/mcp_config.json 时,我顺手测了一下配置在里面的 Notion MCP,接着又在插件市场里翻到了 Notion 官方出品的插件(antigravity-plugins-partners/plugin/notion)。同一台机器上,既有手配的 Notion MCP,又有现成的 Notion 插件,就像 Chrome DevTools 也同时存在独立 chrome-devtools-mcp 和官方 chrome-devtools-plugin 一样。
实际把 Notion 从独立 MCP 切换到插件并逐项测试之后,省流结论如下:
在 Antigravity 中,插件并不是另一套工具协议,它底层依然挂载 MCP Server,但额外打包了配套 Skills、生命周期托管和原生连接配置。选型上,标准 SaaS 且需要场景工作流时优先用官方/合作插件;本地自建脚本、需要精细定制启动参数或跨客户端复用时,用独立 MCP;两者可按服务混用,但同一个外部服务只留一个,不要同时开启。
以 Notion 为例,两者的核心差异可以直接对照下面这张表:
| 对比维度 | Antigravity 插件(Notion 插件) | 独立 / 自建 MCP(~/.gemini/config/mcp_config.json) |
|---|---|---|
| 包含内容 | MCP Server + 12 个场景化 Skills(含会议准备、项目周报、Spec 转任务、调研文档等) | 纯工具层(Tools),只提供底层 API 读写与检索能力,不带流程规范 |
| 连接方式 | 直接使用原生 Streamable HTTP("serverUrl": "https://mcp.notion.com/mcp"),不依赖本地 Node | 常见需要 npx -y mcp-remote@latest 桥接(或用 Stdio 拉起本地自写脚本) |
| 配置与启停 | Antigravity 插件面板统一安装、更新与热切换,无需手改 JSON | 手动维护 mcp_config.json,增删改参数或加 "disabled": true |
| 工具命名空间 | 带插件前缀(实测暴露服务名为 notion_notion) | 直接使用配置里的 key(如 notion) |
| 跨客户端复用 | 仅在 Antigravity 体系内生效 | 同一套 JSON 结构可迁移到 antigravity-cli、Claude Code、Codex 等客户端 |
| 远端权限边界 | 取决于 Notion 账号套餐,换插件不会解锁更高阶接口 | 同左,完全取决于账号本身 |
2. 拆开看:插件和独立 MCP 在机制上差在哪?
很多人一开始会误以为“插件 = 官方原生内置接口,MCP = 第三方协议”。去本地目录翻一下插件和定制系统的文档,就会发现它们不是替代关系,而是**“打包方式”和“纯连接配置”**的区别。
2.1 插件是一个组合包,MCP 只是其中一块
按照 Antigravity 的定制体系设计,Plugin 是一个可整体启停的分发单元(Bundle),标准目录可以同时包含四类东西:
plugin.json:插件清单(名称、版本、作者、仓库等元数据);mcp_config.json:插件自带的 MCP Server 配置;skills/:教 Agent 怎么按标准套路使用这些工具的工作流指南;- 可选的
rules/AGENTS.md和hooks.json。
以我安装的 Notion 插件(位于 ~/.gemini/config/plugins/notion/)为例,它由 Notion Labs 发布,目录里除了一个仅 3 行的 mcp_config.json,还附带了 12 个场景化 Skill:notion-setup、notion-meeting-prep、notion-research-documentation、notion-weekly-project-digest、notion-database-designer、notion-spec-to-implementation 等。
也就是说,如果只配独立 MCP,Agent 拿到的是一把“能读写页面的锤子”;装上插件后,Agent 还同时拿到了“怎么写周报、怎么把 Spec 拆成任务数据库”的操作手册。
2.2 传输协议与维护成本:原生 Streamable HTTP vs 本地桥接
Antigravity 目前支持两种 MCP 传输机制:Stdio(拉起本地可执行文件或脚本)和 Streamable HTTP(直接连远端 url / serverUrl),不支持旧版 HTTP+SSE(2024-11-05 规范),遇到只支持旧 SSE 的服务端时必须套一层 mcp-remote 做 Stdio 桥接。
对比我本机的两份 Notion 配置,差异很直观:
- 独立手配版本(
~/.gemini/config/mcp_config.json):
每次启动都要靠本地"notion": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.notion.com/mcp"] }npx拉起一个桥接进程,依赖本机 Node 环境。 - Notion 插件内置版本(
~/.gemini/config/plugins/notion/mcp_config.json):
直接走原生远程{ "mcpServers": { "notion": { "serverUrl": "https://mcp.notion.com/mcp" } } }serverUrl,省掉了本地npx mcp-remote桥接进程,后续升级也由插件市场托管。
但独立 MCP 也有插件替代不了的强项:完全掌控本地执行命令和启动参数。比如我本机还有一个自建的本地 Gmail MCP,就是通过 uv 直接拉起本地 Python 脚本(Stdio 模式);再比如 chrome-devtools-mcp,我在 Antigravity 主配置里把参数从 --isolated 改成了 --autoConnect,用来直连当前登录态的 Chrome。这类私有工具和精细参数调整,写在自己的 mcp_config.json 里最直接。
2.3 跨客户端配置边界:主配置、CLI 与其他 AI 工具各自独立
检查本机配置时我顺便对比了几套客户端,发现它们各自读自己的配置文件:
- Antigravity 主配置:
~/.gemini/config/mcp_config.json(权限白名单在~/.gemini/config/config.json) - Antigravity CLI:
~/.gemini/antigravity-cli/mcp_config.json - Claude Code:
~/.claude.json顶层mcpServers - Codex:
~/.codex/config.toml下的[mcp_servers.*]
插件机制只服务于 Antigravity 自身;而独立 MCP 的配置思路与启动命令几乎可以原封不动复制到其他客户端。
2.4 远端账号限制不会因为换了插件就消失
在切换前,我先用独立 Notion MCP 跑了一次 notion-get-tool-access 检查工具可用性。在当前个人账号套餐下,基础的 fetch、create_pages、update_page、list_recent_pages、create_comment 等均为 available,但可以看到明确的服务端边界:
query_data_sources标记为available_with_limit;query_multiple_data_sources、query_meeting_notes、connector_search、评论修改/删除/解决以及建议编辑(*_suggested_edit)均返回plan_required或full_version_required;search虽然可用,但按编辑人过滤(filters.edited_by_user_ids)、按时间范围过滤(filters.last_edited_date_range)、仅搜标题(filters.title_only)以及非相关性排序(sort)都会提示需要 Business 或 Enterprise 套餐。
这部分能力边界在 Notion 服务端判定,底层连的是同一个 https://mcp.notion.com/mcp 端点,从独立 MCP 换成官方/合作插件并不会自动解锁付费功能。
3. 完整复现:以 Notion 为例,从独立 MCP 平滑切到插件
如果你之前已经在 mcp_config.json 里配过 Notion,想试着切到插件,建议按下面四步走,避免出现“两套工具同时挂在上下文里”的尴尬状态。
Step 1:先停用原来的独立 MCP 条目
打开 ~/.gemini/config/mcp_config.json,给原来的 "notion" 加上 "disabled": true(先禁用比直接删掉更稳妥,万一想回退去掉这一行就行):
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.notion.com/mcp"
],
"disabled": true
}
}
}
Step 2:在 Marketplace 安装并启用 Notion 插件
在 Antigravity 插件市场搜索并安装 Notion 插件(Catalog ID 为 antigravity-plugins-partners/plugin/notion)。安装完成后,插件文件会落在 ~/.gemini/config/plugins/notion/,无需手动去改 ~/.gemini/config/config.json。
Step 3:核对新旧工具组是否切换干净
开启一轮新对话或刷新后,检查两处变化:
- 原来的
notionMCP 工具组已清空,没有两套工具并存; - 新工具组以
notion_notion的服务名挂载,同时 12 个notion-*Skills 变为可用状态。
Step 4:用只读探针验证连通性
分别调用 notion_notion 下的只读工具做一次最小验收:
- 调用
notion-get-self(参数{}):确认返回当前工作区名称、ID 与登录账号信息; - 调用
notion-list-recent-pages(参数{"limit": 3}):确认能正常拉取最近访问的数据库与页面列表。
两项都正常返回,就说明 OAuth 登录态与插件连接都已接通。
4. 实测踩到的四个细节与避坑清单
- 同时开着插件和独立 MCP,上下文平白多出一倍工具定义
- 现象:安装 Notion 插件后如果没关
mcp_config.json,Agent 会同时看到notion和notion_notion两套几乎一模一样的几十个工具。 - 解法:同一服务严格二选一。切插件后立即在
mcp_config.json设"disabled": true或删掉原条目。
- 现象:安装 Notion 插件后如果没关
- 切换之后,以前点过“始终允许”的操作又开始弹窗确认
- 现象:明明之前在
config.json里已经给notion-fetch、notion-update-page点过自动放行,切到插件后又得重新点允许。 - 根因:旧白名单保存在
~/.gemini/config/config.json的userSettings.globalPermissionGrants.allow中,规则名是mcp(notion/notion-fetch)、mcp(notion/notion-update-page);而插件暴露的服务名变成了notion_notion,旧规则名不再命中。 - 解法:不用手改
config.json,后续遇到写操作弹窗时重新点一次允许即可(长期不用的旧规则也可以顺手清理)。
- 现象:明明之前在
- 桌面端好好的,切到
antigravity-cli工具却不见了或行为不一样- 现象:在 Antigravity 主客户端里配置好了工具,换到命令行
antigravity-cli时发现少了某个本地服务,或者浏览器连接行为不对。 - 根因:主配置(
~/.gemini/config/mcp_config.json)和 CLI 配置(~/.gemini/antigravity-cli/mcp_config.json)是两份独立文件。比如我本机主配置里有本地gmail脚本且chrome-devtools用--autoConnect,而 CLI 版里没有gmail、chrome-devtools用的是--isolated,反而多了另外两个工具。 - 解法:排查“为什么换了个入口工具变了”时,记得两边配置文件分开核对。
- 现象:在 Antigravity 主客户端里配置好了工具,换到命令行
- 换完插件仍然调不通会议搜索或跨源检索
- 现象:切到 Notion 官方插件后,
query_meeting_notes或connector_search等高阶能力依旧受限。 - 根因:这是 Notion 账号套餐权限策略(
plan_required/full_version_required)导致的,和本地用插件还是手配 MCP 没有关系。 - 解法:先调用一次
notion-get-tool-access查看当前账号的完整工具权限表,确认是配置问题还是套餐限制,避免无效折腾。
- 现象:切到 Notion 官方插件后,
5. 选型建议与适用边界
综合这次实测,我在 Antigravity 里的配置策略很明确——按服务做混合选型,而不是一刀切:
- 优先用官方 / Marketplace 插件的场景:
- 对接 Notion、Canva、Chrome DevTools 这类有官方或合作方维护插件的标准服务;
- 希望直接复用配套 Skills(例如让 Agent 按规范帮我整理会议纪要、写周报、拆项目 Spec);
- 想减少本地
npx mcp-remote进程维护,直接用插件面板一键启停和更新。
- 继续用独立 / 自建 MCP 的场景:
- 自己写的本地私有脚本或内部服务(例如本地 Python/Node MCP);
- 需要精细调整 CLI 参数(比如切换无头模式、隔离模式或自动附着当前浏览器);
- 只把远程服务当纯数据读写接口、不想动已配置好的
mcp(<name>/...)白名单,或者需要让多套 AI 客户端保持完全一致的 JSON 配置结构。
