MCP 设置:把 Merlin Project 连接到 Codex

Codex 是 OpenAI 的终端智能体,对已经持有 OpenAI 订阅的人来说,它就是 Claude Code 的对应方案。和所有 MCP 客户端一样,在您把 Merlin 服务器告诉它之前,Codex 并不认识您的项目计划;告诉之后,它就能直接从共享的项目里读取活动、日期和资源。为此只需终端里的一行。本文讲清这条命令的构成、如何检查连接,并以一份来自真实计划数据的干系人汇报收尾。

本文的视频

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

您需要什么

  • 当前版本的 Merlin Project,MCP 服务器已安装,项目已共享
  • Codex,已安装并已登录;没有登录,连接命令就会扑空

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 步:把服务器告诉 Codex

打开终端,输入这一行:

连接 Terminal

codex mcp add merlin-project -- /usr/local/bin/merlinproject-mcp

这一行分成两半。双短横线之前的内容是对 Codex 说的:记住一个名为 merlin-project 的服务器。之后的内容,是 Codex 要为这个服务器启动的程序。Codex 会确认服务器已登记。

第 2 步:在会话中检查

登记到此完成。至于 Codex 在运行中的会话里是否也看得见它,要用 Codex 自身的一条命令来查。用 codex 启动,然后输入:

在运行中的 Codex 会话里检查 Codex

/mcp

Codex 会列出已连接的服务器,merlin-project 就在其中。

第一个问题:干系人汇报

现在轮到真正要紧的那个问题。您想用几句话说清项目现状,再加上已达成的里程碑和接下来的关键日期,写成可以直接发给委托方的样子:

提示词: 如何向指导委员会汇报?

根据当前项目数据为指导委员会撰写一份干系人更新:最多半页,没有专业背景的读者也能看懂。结构:用一句话说明总体状态,自上次更新以来的进展,当前风险,需要做出的决策。避免使用术语,并为每项风险注明受影响的里程碑。

在提示词库中查看 ›

Codex 通过 MCP 读取计划,用真实日期写出这份汇报。明天若有活动挪动,明天的 Codex 就写出更新后的版本。首次调用工具时,Codex 会征求您的同意。

如果服务器没有出现

  • 命令找不到? Codex 没装上,或终端里缺少路径。检查安装,重新打开终端。
  • 已登记却不在 /mcp 里? 结束 Codex 会话再重新启动;运行中的会话不会重新读取配置。
  • 回答是空的? 在 Merlin 中通过「AI Tools」共享项目,并把路径与安装程序对照一遍。

检查清单

练手可以用示例项目 Produktlaunch Phoenix。更多汇报格式在 提示词库 里。终端中 Claude 一侧的对应方案,连同用于自动报告的调用,见 Claude Code 一文。全部指南:

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

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

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