返回博客
语言
文章ZH

JoyfulWords MCP Server:把 Claude Code、Codex 等 AI Agent 接入内容工作流

JoyfulWords HTTP MCP Server 可以让 Claude Code、Codex 等 AI Agent 连接文章、素材和内容生产工作流,而不是停留在单次起稿。

JoyfulWords 现在支持 MCP 服务,可以稳定地给 AI Agent,比如 Claude Code、Codex,提供 HTTP MCP Server 接口:https://api.joyword.link/mcp。只需要把这个地址发给 AI Agent,让它帮忙安装即可。

这篇文章解释的是:为什么内容创作工具需要 MCP server for AI agents,Claude Code MCP 应该怎么接入,以及连接失败时应该先检查哪些点。

那么,为什么这样一个文章编辑器会接入 AI Agent 呢?如果说 AI Agent 能够生成一篇完美的文章,那么就连这个编辑器都不必存在。但现实是,很多事情并不是一段提示词就能说清楚的,有时候不一定是 AI 不够聪明,而是我们自己,都在不断书写的过程中,慢慢的清晰化自己要表达的每一个细节。

之前写一篇文章,会查阅资料、修改措辞、反复斟酌,要耗费比较大量的时间。而 AI,应该是帮助我们缩短这个时间,而不是完全替代我们。

所以现在更常见的方式是:我先把自己的想法、判断和想表达的方向丢给 AI,让它帮我搭出一副文章骨架。这个阶段,我并不期待 AI 一次就写出一篇真正像“我”写的文章。它最擅长的不是替我完成表达,而是把混乱的念头整理成结构:先讲什么,后讲什么,哪些观点需要展开,哪些地方应该收住。

这对我来说很重要。因为很多时候,写作最大的阻力不是不会写,而是不知道从哪里开始。AI 可以很快给我一个初稿框架,让我从“面对空白”变成“面对一个可以修改的东西”。这一步已经能节省大量时间。

什么是给 AI Agent 用的 MCP Server

MCP,也就是 Model Context Protocol,是一种让 AI Agent 连接外部工具和数据源的标准方式。它的价值不是让你来回复制粘贴,而是让 Agent 可以发现并调用外部能力。

对 JoyfulWords 来说,MCP Server 不是一个泛用接口,而是 AI Agent 和内容工作台之间的连接层。它后续可以围绕这些能力展开:

  • 文章和草稿
  • 素材收集
  • 文章优化流程
  • 图片和内容生产上下文
  • 发布准备和内容复用流程

这样 AI Agent 参与的就不只是“生成几段文字”,而是文章生产前后的完整工作。

为什么 HTTP MCP 很重要

JoyfulWords 暴露的是标准 HTTP MCP endpoint。它的好处是,很多 Agent 客户端可以直接连接远程服务,不需要你本地构建插件或维护桌面桥接。

Claude Code 的安装命令形态是:

claude mcp add --transport http --client-id joyfulwords-mcp-server joyfulwords https://api.joyword.link/mcp

安装后,重启 Claude Code,再运行 /mcp 检查 JoyfulWords 服务是否出现。

AI 负责骨架,我负责判断

AI 写出来的文章常常会有一个问题:它太完整,也太平淡。

很多句子看起来没有错,结构也合理,但读起来会有一点生硬。它像是把信息摆放整齐了,却没有真正经过人的生活经验、语气习惯和表达取舍。尤其是一些需要体现个人色彩的地方,如果完全交给 AI,文章就很容易变成一篇堆砌词语的内容。

那么我希望,有一个地方,可以保存 AI 书写的这些文章,我可以很方便的修改,JoyfulWords 就是我给自己的答案。尽管市面上有很多编辑器、笔记软件,它们使用起来却不够顺手,因为它们来自 AI 出现之前的时代,很多 AI 功能没有原生内置。

JoyfulWords 帮我给文章长出血肉

在这个阶段,JoyfulWords 对我最大的帮助,就是把文章从“有结构”推进到“像一篇自己的文章”。

当 AI 已经给出骨架之后,我会继续在 JoyfulWords 里打开,再浏览一遍,哪些段落太像模板,哪些句子太硬,哪些观点需要更贴近日常语言,我可以直接修改,也可以请 AI 帮忙修改某一段话,帮我尝试不同的语气:更直接一点,更克制一点,更口语一点,或者更适合发布给社交媒体。

我也会用素材搜索补充文章细节,如果能提供一些例子、一张图、一个真实场景,往往比一整段抽象描述更有说服力。素材搜索可以让我更快地在网络中找到可以放进文章里的参考内容,让文章不只是观点堆叠。

如果网络图片不够,或者存在版权、水印(这在现在的 google 上太常见了),我可以使用一键生图,利用 AI 创建新的图片,或者将现有图片风格化。

甚至还可以直接利用 ai 输出网络上现在很火的信息图功能,这些图片把大量文字、装饰等融入一张图片,真正的“一图胜千言”。

常见 MCP 连接问题

如果 AI Agent 没有成功连接 JoyfulWords MCP,先检查这几个点:

  • endpoint 写错:生产 MCP 地址是 https://api.joyword.link/mcp
  • transport 选错:客户端要求 transport 时,使用 HTTP。
  • client id 不一致:支持显式 client id 时,使用 joyfulwords-mcp-server
  • OAuth 没完成:有些客户端需要先通过浏览器完成授权。
  • 客户端没重启:Claude Code 添加 MCP 后,可能需要重启后再运行 /mcp

这些检查通常能区分问题是在安装、OAuth,还是工具发现阶段。

人类真正需要的是协作,不是替代

我不太把 AI 写作理解成“机器可以日产万篇”,这些水文没有意义,而且终究会被平台淘汰,因为平台的核心是用户留存,而用户并不需要在上网冲浪时,看到 AI 在教育自己。如果他们需要,他们大可以直接问 AI 就是了。

所以我觉得 AI 日产万篇的最佳场景,可能也就是生成要求机械、快速、没有感情的新闻稿。

我更认可的方式是协作:AI 帮我建立结构,我来继续打磨语言、补充素材、生成图片,而我自己负责最终的判断。哪些内容保留,哪些内容删掉,哪些表达需要更像我的语气,哪些地方必须加入我的特点。

这种配合的好处是,它既没有牺牲个人表达,也没有把效率丢掉。我不需要把大量时间消耗在整理大纲、反复找素材、手动调整每一句话上,但文章最后仍然可以保留我的视角、我的节奏和我的取舍。

JoyfulWords 的后续改进

我不打算在 JoyfulWords 中加入 AI 批量生文章,而是聚焦于对 AI Agent 生成文章之后的管理和改动,所以会继续提供更多的 AI 功能,以便使用。在使用时如果发现一些问题,可以直接给我留言。

对于 JoyfulWords ,我没有设计简单的订阅模式,而是直接记录底层使用消耗,每一条消耗都记录在案,我觉得订阅只需要一个就够了,那就是 AI Agent,其他都没必要。

好了,就这样。

Best Regards~