输入任意标题、正文关键词或分类开始搜索

按 Esc 关闭,按 Enter 查看完整页面

/ 程序员

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:核对新旧工具组是否切换干净

开启一轮新对话或刷新后,检查两处变化:

  1. 原来的 notion MCP 工具组已清空,没有两套工具并存;
  2. 新工具组以 notion_notion 的服务名挂载,同时 12 个 notion-* Skills 变为可用状态。

Step 4:用只读探针验证连通性

分别调用 notion_notion 下的只读工具做一次最小验收:

  1. 调用 notion-get-self(参数 {}):确认返回当前工作区名称、ID 与登录账号信息;
  2. 调用 notion-list-recent-pages(参数 {"limit": 3}):确认能正常拉取最近访问的数据库与页面列表。

两项都正常返回,就说明 OAuth 登录态与插件连接都已接通。


4. 实测踩到的四个细节与避坑清单

  1. 同时开着插件和独立 MCP,上下文平白多出一倍工具定义
    • 现象:安装 Notion 插件后如果没关 mcp_config.json,Agent 会同时看到 notion 和 notion_notion 两套几乎一模一样的几十个工具。
    • 解法:同一服务严格二选一。切插件后立即在 mcp_config.json 设 "disabled": true 或删掉原条目。
  2. 切换之后,以前点过“始终允许”的操作又开始弹窗确认
    • 现象:明明之前在 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,后续遇到写操作弹窗时重新点一次允许即可(长期不用的旧规则也可以顺手清理)。
  3. 桌面端好好的,切到 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,反而多了另外两个工具。
    • 解法:排查“为什么换了个入口工具变了”时,记得两边配置文件分开核对。
  4. 换完插件仍然调不通会议搜索或跨源检索
    • 现象:切到 Notion 官方插件后,query_meeting_notes 或 connector_search 等高阶能力依旧受限。
    • 根因:这是 Notion 账号套餐权限策略(plan_required / full_version_required)导致的,和本地用插件还是手配 MCP 没有关系。
    • 解法:先调用一次 notion-get-tool-access 查看当前账号的完整工具权限表,确认是配置问题还是套餐限制,避免无效折腾。

5. 选型建议与适用边界

综合这次实测,我在 Antigravity 里的配置策略很明确——按服务做混合选型,而不是一刀切:

  • 优先用官方 / Marketplace 插件的场景:
    • 对接 Notion、Canva、Chrome DevTools 这类有官方或合作方维护插件的标准服务;
    • 希望直接复用配套 Skills(例如让 Agent 按规范帮我整理会议纪要、写周报、拆项目 Spec);
    • 想减少本地 npx mcp-remote 进程维护,直接用插件面板一键启停和更新。
  • 继续用独立 / 自建 MCP 的场景:
    • 自己写的本地私有脚本或内部服务(例如本地 Python/Node MCP);
    • 需要精细调整 CLI 参数(比如切换无头模式、隔离模式或自动附着当前浏览器);
    • 只把远程服务当纯数据读写接口、不想动已配置好的 mcp(<name>/...) 白名单,或者需要让多套 AI 客户端保持完全一致的 JSON 配置结构。