REST API¶

主要接口是 /mcp 上的 MCP。另有 REST 接口用于健康检查、文件链接以及部分服务操作。

健康检查¶

GET /healthz

返回服务器健康状态和基本运行状态。

POST /mcp

供 ChatGPT 和其他 MCP client 使用的 Streamable HTTP MCP endpoint。

REST 工具调用使用一致的成功/错误 envelope。验证错误会返回结构化的 ok: false payload，而不是直接暴露框架异常。

固定的 Skills registry 也可通过 REST 使用：

GET  /tools/skill_list
POST /tools/skill_load       {"name": "debugging"}
POST /tools/skill_read  {"name": "debugging", "path": "checklist.md"}

Skill 目录发生变化后，下一次调用即可看到，且不会改变 MCP 工具列表。

带 token 的文件下载由内置 HTTP app 提供。链接是 bearer URL，支持 TTL、可选的最大下载次数限制和撤销。

公开部署应使用 OAuth。开发时可以启用 localhost bypass，但在公网提供未认证访问是不安全的。