跳到内容

全部开发者文档

Changeloop MCP 服务器

一个让智能体在编辑器里处理你的 changelog 的 MCP 服务器:读取待审核、已定时和已发布的条目,编辑它们,立即发布或在设定的时间发布,或者丢弃它们。下文介绍如何连接 Claude Code、十个工具,以及智能体不能做什么。

MCP 服务器

POST https://api.changeloop.dev/mcp

如果你在 Claude Code、ChatGPT 或其他支持 Model Context Protocol 的代理中工作,可以将其直接连接到你的 changelog。这样代理就能查看待审核的内容、编辑文字、并在不离开编辑器的情况下发布。这与网页应用相同的审核门槛:在有内容批准之前,不会有任何东西公开。

连接 Claude Code

先创建一个 API 密钥(设置,API 密钥),然后在请求头中带上密钥添加服务器:

claude mcp add --transport http changeloop \
  https://api.changeloop.dev/mcp \
  --header "Authorization: Bearer clapi_YOUR_KEY"

对于改为读取 JSON 配置的客户端,同样的内容看起来是这样的:

{
  "mcpServers": {
    "changeloop": {
      "type": "http",
      "url": "https://api.changeloop.dev/mcp",
      "headers": { "Authorization": "Bearer clapi_YOUR_KEY" }
    }
  }
}

目前还没有 OAuth 流程。认证方式是请求头中的 API 密钥,这正是上面两条命令所做的事情。在“设置”中撤销该密钥会在代理的下一次请求时断开其连接。

代理能做什么

共有十个工具,这个列表是刻意保持简短的。这个产品能做的其他任何事情都可以用同一个密钥通过 REST API 访问;每一个暴露给代理的工具,都是多一个可能被诱导调用的手段。

  • list_pending_entries、list_published_entries、get_entry - 读取你的条目。待处理的条目不是公开的。
  • update_entry - 修改条目的标题或 markdown 正文。feed 提供的 HTML 是由我们的净化器从你的 markdown 重新渲染而来;代理无法提供 HTML。
  • approve_entry - 发布。这是公开且即时的,并会通知 GitHub 上任何已关联的反馈。只有待处理的条目才能被批准,已定时的条目则需要传入 publish_now: true 才能批准,这样它会立即发布,而不是等到设定的时间。
  • discard_entry - 将条目排除在 changelog 之外。可从网页应用中撤销。
  • get_changelog_info - 你的 feed ID 以及提供你 changelog 的地址。
  • list_scheduled_entries、schedule_entry、unschedule_entry - 查看已定时的条目,最早的排在前面。可以为待处理的条目设定发布时间并注明时区,时间可设在一分钟到 90 天之后,也可以把它改到新的时间,或者取消定时,让条目回到待处理状态。汇总无法定时发布。

它做不到的事

每个工具都限定在该密钥所属的团队范围内,且没有任何一个工具接受团队作为参数,因此即使有什么东西尝试,也没有办法指向另一个团队。服务器不接受浏览器会话,只接受密钥:请求必须有意地附带凭据。而且密钥无法管理密钥,也无法下载数据导出,因此以这种方式连接的代理无法为自己签发第二个凭据,也无法在一次调用中提取你的数据。

API 密钥

以上内容都是匿名的,不需要任何凭据。经过身份验证的 API——你的设置、你的审核收件箱——是另一个界面,它既接受已登录的浏览器会话,也接受 API 密钥。密钥是为脚本和代理准备的:任何需要在没有人操作键盘的情况下访问你的 changelog 的东西。

在应用的“设置”下的“API 密钥”标签页中创建一个。密钥只会在你创建它的那一刻显示一次,之后就不会再显示:我们只存储它的哈希值,因此没有任何界面能第二次向你展示它。如果丢失了,请将其撤销并创建另一个。

在编辑器里审核 changelog

Changeloop 根据每个已合并的 pull request 起草条目,并保留到你审核为止,可以在网页应用里审核,也可以通过这个 MCP 服务器。一个仓库免费,无需信用卡。

免费开始

阅读开发者文档