Docs
集成自定义客户端
如果你的内部工具或 agent 平台已经支持 MCP，可以把灵稿作为一个本地 HTTP MCP server 接入。客户端只需要发起 tools/list 和 tools/call，并按工具返回的 JSON 结果处理成功、失败和重试。
客户端实现要点
- Transport
- 使用 HTTP MCP endpoint：http://127.0.0.1:7654/mcp。开发时以应用内显示的 endpoint 为准。
- 工具发现
- 先调用 list-tools 获取 xhs_* 工具、描述、输入 schema 和 read / destructive 标记。
- 错误处理
- 工具失败会返回结构化错误码。客户端应区分 validation、account required、publish status unknown 等情况，而不是盲目重试。
- 人工确认
- 对 destructive 工具加入确认层，特别是发布、删除、取消任务和批量修改项目归属。