今天若想就项目向 AI 提问，您得先导出计划再上传文件；下周计划一变，一切重来。因此 Merlin Project 自带了一个 MCP 服务器，它是 Mac 上的一个小程序，AI 客户端借助它直接读取打开着的计划，而不是拿一份副本工作。Claude Desktop 是通往那里最省事的一条路，因为只需在一个配置文件里加上一段。本文按顺序走完三个步骤，从安装服务器到向计划提出第一个问题。
本文的视频
视频（德语）嵌在 本文的德语版 中。它以示例项目「Produktlaunch Phoenix」演示整个设置过程，那是一个小型产品发布项目，五个阶段、二十来个活动、八项资源。最后 Claude 向计划查询已达成的里程碑和接下来的日期，答案直接来自 Merlin 中此刻打开的项目。下面的步骤本身也是完整的。
您需要什么
- 当前版本的 Merlin Project
- Mac 版 Claude Desktop；一个免费的 Claude 账户就够了
- 一个已打开、允许 Claude 读取的项目
没有别的了。既不用终端也不用 Node 包，更不必花半小时读文档。MCP 是 Model Context Protocol 的缩写，是一项开放标准，如今各大 AI 供应商都已支持。它规定 AI 客户端如何调用一个程序提供的工具，在我们这里就是 Merlin 服务器的读取查询。
第 1 步和第 2 步：准备 Merlin Project
- 安装服务器。 在 Merlin Project 中打开 Merlin Project 菜单，选择 Install MCP Server。Merlin 会在您的 Mac 上放置一个小程序，它是 AI 客户端与计划之间的桥梁。安装程序会显示路径，即
/usr/local/bin/merlinproject-mcp。 - 共享项目。 打开项目，点击工具栏中的 AI Tools。勾选 允许 AI 工具与文档交互 后，该图标显示为实心。共享只对这一个项目生效，其他项目对服务器始终不可见。一旦有客户端连上，图标就会变蓝。
本地 · 只读 · 外部无法访问。 服务器只读取您共享的项目，不改动您的任何数据，外部也无人能够访问它。云端客户端能看到所读数据的哪些部分，数据保护那篇文章有说明。
这两步对所有客户端都一样。日后再接入 Claude Code、Codex 或 Antigravity 时，它们已经完成了。
第 3 步：把服务器告诉 Claude Desktop
Merlin 这边准备好了，但 Claude 还不知道有这个服务器。这是唯一需要您短暂动一下文件的步骤。
- 在 Claude Desktop 中打开 Settings，进入 Developer。
- 点击 Edit Config。Claude 会在访达中高亮出
claude_desktop_config.json。 - 用文本编辑器打开该文件，例如 TextEdit。
- 粘贴下面这段并保存。
merlin-project 的配置块 claude_desktop_config.json
{
"mcpServers": {
"merlin-project": {
"command": "/usr/local/bin/merlinproject-mcp"
}
}
}只做添加。 若文件中已有内容，请勿删除任何一行，否则 Claude 会丢失您已配置好的其他工具。若已存在 mcpServers 条目，只添加内层的 merlin-project 段。
- 彻底退出 Claude Desktop（Cmd+Q）并重新启动。Claude 只在启动时读取配置文件。
重启后，merlin-project 会出现在工具列表中。连接即告建立，而当 Claude 第一次读取计划时，Merlin Project 里的 AI Tools 图标会变成蓝色。
向计划提出的第一个问题
问问 Claude 您的项目现在进展到哪一步。视频里用的提示词收录在我们的提示词库中，可以直接从这里复制：
提示词: 我的项目目前进展如何？
概括当前项目的状态。分三步进行：先说明整体进度和计划结束日期，再列出最近达成的里程碑，最后列出接下来的日期。突出与计划相比发生了哪些变化，只列出最重要的十点。Claude 会从共享的项目中读取活动、里程碑和日期并加以汇总。不用导出，不用副本；明天您挪动一个日期，明天 Claude 就给出新的答案。从资源负荷到干系人汇报，更多问题都在 提示词库 里。
如果 Claude 看不到服务器
最常见的错误同时也是最简单的：保存之后没有彻底退出 Claude Desktop。关掉窗口并不够。请用 Cmd+Q 退出应用再重新打开。另有三处可查：
- 检查路径。 Merlin Project 的安装程序会显示服务器路径，它必须与配置块中的值完全一致。
- 检查 JSON。 少一个逗号或一个花括号，Claude 就会忽略整个文件。请从本页复制这段，不要手敲。
- 检查共享。 项目是否已通过「AI Tools」共享？服务器只读取已开启访问的项目。装好了服务器却没有共享项目，回应就是一个空列表。
检查清单
想照着做：示例项目
如果您想先不用自己的项目练手，请下载视频中的示例项目 Produktlaunch Phoenix。它已经在进行中，前几个阶段已完成，Claude 能在其中找到里程碑和日期，和视频里一样。
其他客户端
Claude Desktop 是最省事的入口。若您在编辑器或终端里工作，或手上的数据不能离开 Mac，合适的指南在这里：
- Claude Desktop （本文）: 一个文件里加一段，重启
- LM Studio: 下载模型，一个文件里加一段
- Claude Code: 一条命令
- Codex: 一条命令
- Antigravity: 一个文件里加一段，彻底重启
- ChatGPT: 复制桥接或智能助理
- 哪个 AI 客户端适合您？
所有客户端的完整参考见 MCP 文档。
如果您对这篇博客文章有任何疑问或希望参与讨论，欢迎您在我们的论坛中发帖。
