MCP 设置:把 Merlin Project 连接到 Claude Code

Claude Desktop 在聊天窗口里回答关于计划的问题。可一旦回答还要继续往下走,比如变成每周五就躺在文件里的状态报告,您就需要一个能从命令行运行的客户端。Claude Code 正是这样的客户端。它对话的是与 Claude Desktop 相同的 MCP 服务器,但把回答作为文本输出在终端里,而文本可以重定向、可以传递,也可以在固定时间生成。本文给出连接命令、检查方法,以及那条让报告在没有聊天窗口的情况下诞生的调用。

本文的视频

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

您需要什么

  • 当前版本的 Merlin Project,MCP 服务器已安装,项目已共享(步骤见 Claude Desktop 一文的第 1、2 步)
  • Claude Code,已安装,并且启动过一次且已登录

Merlin 这边的共享,和其他任何客户端一样,都是同一次点击:

一次点击即可共享这一个项目:工具栏中的 AI Tools,然后开启 允许 AI 工具与文档交互。其他项目对服务器始终不可见。

第二点是最常见的错误:装了 Claude Code 却从没启动过,连接命令就会扑空。所以请先启动一次 Claude Code,登录,然后再退出。

第 1 步:把服务器告诉 Claude Code

打开终端,输入这条命令:

连接 Terminal

claude mcp add --transport stdio merlin-project -- /usr/local/bin/merlinproject-mcp

这条命令说了三件事:让 Claude Code 注册一个名为 merlin-project 的服务器,通过 stdio 与它对话,并为此启动双短横线后面的那个程序。中间的 -- 把给 Claude Code 的选项与 Merlin 服务器的启动命令分开,后面的一切都属于服务器。Claude Code 会以「Added stdio MCP server merlin-project」作答。

第 2 步:检查注册

条目是否干净地写进去了,第二条命令会告诉您:

检查 Terminal

claude mcp get merlin-project

输出会列出名称、传输方式(stdio)和路径。三者都对上,服务器就注册好了。至于连接是否真的通,得问一个真问题才看得出来。

第一个问题:哪些活动有滑坡的风险?

用 claude 启动 Claude Code,提出视频里的那个问题:

提示词: 哪些活动即将延误?

根据现有计划,找出当前项目中所有有落后风险的活动。检查进度、剩余工期和依赖关系。为每项活动说明可能延误多少天,哪些后续活动会受影响,以及项目结束日期是否面临风险。

在提示词库中查看 ›

Claude Code 会调用 Merlin 服务器,返回一张来自共享项目真实数据的表格。首次调用时,Claude Code 会询问是否可以使用该工具;请确认。

为什么要用终端?把回答写进文件

到这一步为止,聊天窗口也能做到。区别在于:回答是文本,而终端里的文本可以继续加工、写进文件、交给脚本。同一件差事,不用聊天窗口,直接从命令行执行,并把回答重定向进文件:

不用聊天窗口,回答写入文件 Terminal

claude -p "List all tasks of the active project that are at risk of slipping, as a table with task, planned finish and responsible resource." > at-risk.md

-p 开关代表打印模式:Claude Code 执行任务,输出回答,然后退出。> 把输出导入文件 at-risk.md。打开它,表格就在里面。

离周五那份报告只差一步了:凡是能从命令行运行的东西,您的 Mac 都能在固定时间自行启动,比如通过 launch agent 或日历自动化。周五 16 点,报告已经躺在那里,无人敲过一个键。那份报告长什么样、还该包含什么,我们放在专门讲自动周报的视频里。

再把服务器移除

如果哪天想删掉这个条目:

移除 Terminal

claude mcp remove merlin-project

如果连接不通

  • 提示「Claude Code not found」? Claude Code 没装上,或者终端不认得这个路径。检查安装,重新打开终端。
  • 命令能跑,却收不到来自计划的回答? Claude Code 从未启动并登录过,或者项目在 Merlin 里没有共享。
  • 路径不对? Merlin Project 的安装程序会显示路径。用 claude mcp get merlin-project 对照,若有出入就移除后重新注册。

速查表

练手可以用示例项目 Produktlaunch Phoenix。更愿意在聊天窗口里看报告的人,请用 Claude Desktop;终端里的 OpenAI 对应方案是 Codex。全部指南:

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

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

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