MCP 设置:把 Merlin Project 连接到 Antigravity

Antigravity 是 Google 的智能体编辑器,它配置 MCP 服务器的方式与 Claude Desktop 属于同一类:在一个 JSON 文件里放上一段,告诉编辑器该启动哪个程序。但有一处脾气把 Antigravity 和其他客户端区分开来:它只在启动时读取这个文件。于是保存之后看不到连接的人,往往会在一个早就正确的文件里找毛病。下面可以查到通往配置的点击路径、可复制的配置块,以及那次少了就什么都不会发生的重启。

本文的视频

视频(德语)嵌在 本文的德语版 中。

您需要什么

  • 当前版本的 Merlin Project,MCP 服务器已安装,项目已共享
  • Mac 版 Antigravity

Merlin 这一侧对所有客户端都一样:

  1. 安装服务器。 在 Merlin Project 中打开 Merlin Project 菜单,选择 Install MCP Server。Merlin 会在您的 Mac 上放置一个小程序,它是 AI 客户端与计划之间的桥梁。安装程序会显示路径,即 /usr/local/bin/merlinproject-mcp。
  2. 共享项目。 打开项目,点击工具栏中的 AI Tools。勾选 允许 AI 工具与文档交互 后,该图标显示为实心。共享只对这一个项目生效,其他项目对服务器始终不可见。一旦有客户端连上,图标就会变蓝。
一次点击即可共享这一个项目:工具栏中的 AI Tools,然后开启 允许 AI 工具与文档交互。其他项目对服务器始终不可见。

本地 · 只读 · 外部无法访问。 服务器只读取您共享的项目,不改动您的任何数据,外部也无人能够访问它。云端客户端能看到所读数据的哪些部分,数据保护那篇文章有说明。

第 1 步:写入配置

通往配置文件的路要经过智能体会话:

  1. 在 Antigravity 中打开一个智能体会话。
  2. 在侧边面板点击 … 菜单,选择 MCP Servers。
  3. 在 MCP 商店顶部点击 Manage MCP Servers,然后点 View raw config。文件 mcp_config.json 会打开。
  4. 加入下面这段并保存。

merlin-project 的配置块 mcp_config.json

{
  "mcpServers": {
    "merlin-project": {
      "command": "/usr/local/bin/merlinproject-mcp"
    }
  }
}

要紧的一点:只做添加。若文件中已有内容,请勿删除任何一行,否则 Antigravity 会丢失您此前配置好的其他服务器。

第 2 步:重启 Antigravity

保存后看一眼 MCP 列表:Merlin 不在。配置明明写好了,Antigravity 却不显示连接。原因是:Antigravity 只在启动时读取这个文件。 只要应用还在运行,它就不知道您添了什么,保存多少次都一样。

所以第二步是彻底重启。关窗口不够,请用 Cmd+Q 退出 Antigravity 再重新打开。之后,merlin-project 就会出现在已连接服务器的列表里。跳过这一步的人看不到连接,只好在一个早已正确的文件里找毛病。

第一个问题:把一个阶段变成清单

重启之后就可以提问了。视频里把一组活动输出成清单,好让它直接发给团队:

提示词: 如何把一个阶段变成检查清单?

把当前项目中分组 {PHASE} 的所有活动导出为 Markdown 检查清单:每项活动一行,包含复选框、分配的资源和日期。把已完成的活动标记为完成。清单应能直接粘贴到笔记或 Wiki 中。

在提示词库中查看 ›

把占位符换成阶段的名称,比如「4 Go-to-Market」。Antigravity 会从计划中读取活动、分配和进度,交出清单和表格,两者都能直接接着用。

如果重启后仍然什么都没有

  • 检查 JSON。 少一个逗号,Antigravity 就会丢弃整个文件。请从本页复制这段。
  • 检查路径。 Merlin Project 的安装程序会显示路径,它必须与文件中的值完全一致。
  • 检查共享。 项目是否已在 Merlin 中通过「AI Tools」共享?
  • 真的退出了吗? 红色的关闭按钮并不会退出应用。到程序坞里看看 Antigravity 是否还在运行,然后按 Cmd+Q。

检查清单

练手可以用示例项目 Produktlaunch Phoenix。更多导出格式在 提示词库 里。全部设置指南:

如果您对这篇博客文章有任何疑问或希望参与讨论,欢迎您在我们的论坛中发帖。

规划项目, 让计划真正奏效。

一款管理项目计划的应用,在所有 Apple 设备上原生运行。