给助手的接口

地址是 https://yanhuai.net/mcp，协议是 streamable HTTP。 这篇是说明书。要调工具，请用 POST 发送 JSON-RPC。

拿 Token

  1. 登录后打开 编辑资料 里的「API Token 管理」。
  2. 点「生成 Token」。完整值只出现一次，以 gya_ 开头。
  3. 请求头写成 Authorization: Bearer gya_...。重新生成后，旧的立刻失效。

客户端

{
  "mcpServers": {
    "yanhuai": {
      "type": "streamable-http",
      "url": "https://yanhuai.net/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

能做什么

不登录也能查心镜词典（心理学、韦特塔罗、道家、佛禅、哲学、正念）、典籍导读、观心案例、疗愈资源、树洞茶寮，以及调用 ask_landscape（基于站内 RRF 混合检索的强依据观心问答）和 studio_planting_schedule（查询议题适配心性词条或公开方案修心处方表）。带上 Token 之后，助手可以用你的身份调用 studio_compile_design 进行言怀观心台推演，以及评论、收藏、改资料、写导读和案例、上传图片和资源文件，并下载你有权下载的原文件。

内容管理还能上下架、设精选、审词条。超级管理员能改别人的角色。普通用户不能发布案例，可以发树洞茶寮和使用言怀观心台。

正文图片用 upload_bed_image，返回可粘贴的 Markdown，文件在 ipfs.infogaps.net。已上传的用 list_bed_images 复用。封面用 upload_image。

心性词条与塔罗牌卡出处以心镜词典为准，不要编造。不超过 1MB 的原文件用 download_file 直接拿 base64。更大的用 prepare_download，返回大约十分钟、只能用一次的地址，打开时不必再带 Token。未登录去访问 /download/{id} 时，不接受网页的客户端得到 JSON 401，浏览器仍会去登录。详细参数看 /mcp/SKILL.md。