文档集成

Rust · 0.1.0

集成

明确认证方式和数据流,再接入脚本、MCP 客户端或事件接收端。

先选择接口

集成请求都应发往应用实例地址。这个文档网站只提供静态参考,不会代理你的凭据。根据数据流方向,选择最简单的合适接口。

需求接口起点
脚本读取或修改资源带已授权个人令牌的 RESTAPI 访问
向 MCP 客户端提供受支持工具实例 MCP 端点及工具目录MCP
接收笔记事件已授权的出站 Webhook 接收端Webhook
转写音频已配置的音频提供方音频转写
使用社区客户端单独评估的外部应用客户端兼容性

先建立只读连接

通过自己的私密凭据管理方式设置应用地址 MEMOS_URL 和令牌 MEMOS_TOKEN。下面的请求读取当前账号,不会创建令牌或修改记录。允许写入前,确认返回的是预期账号。非本地连接应使用 HTTPS。

curl --fail-with-body \
  -H "Authorization: Bearer $MEMOS_TOKEN" \
  "$MEMOS_URL/api/v1/auth/me"

验证完整边界

使用合成笔记测试集成。检查一次允许的读取、一次应被拒绝的读取;如需写入,再测试一个可撤回且能在应用中核对结果的修改。令牌只用于认证账号,不会让所有资源都可写。启用 AI 或 Webhook 前,应明确哪些笔记或文件内容会离开实例,以及接收方是谁。

设计重试与撤销

分页读取时保留并继续使用分页令牌,直到列表完整。写入后超时,应先核对资源再重试;即使响应丢失,服务端也可能已经完成操作。事件接收端应能处理重复投递。令牌与 Webhook 密钥不要进入日志,不再需要集成时撤销访问。

本节指南