连接 AI 客户端

Vesper 提供一个 MCP 服务器，Claude 等支持 MCP 的 AI 客户端可以搜索、读取你的记录，Pro 用户还可以让它写入。你用平常的话问，比如"我去年春天搬家时写了什么？"，客户端会去 Vesper 里查。

服务器地址是 https://noted-this.date/mcp，也可以在 设置 → 连接 → AI 客户端（MCP） 里复制。

添加到客户端

Claude（网页版和桌面应用）

1. 打开 Settings → Connectors，选择 Add custom connector。
2. 名称填 Vesper，粘贴服务器地址。
3. 点 Connect。Vesper 会在浏览器里打开，接着按下面授权访问的步骤操作。

Claude Code

claude mcp add --transport http vesper https://noted-this.date/mcp

然后在 Claude Code 里运行 /mcp，选择 vesper 完成授权。如果你只用 Claude Code，也可以改用命令行工具和它的 skill，占用的上下文更少。

其他客户端

支持远程 MCP 服务器和 OAuth 登录的客户端都可以用。很多客户端接受这样的配置：

{ "mcpServers": { "vesper": { "url": "https://noted-this.date/mcp" } } }

授权访问

客户端连接时，Vesper 会在浏览器里打开：

1. 登录（如果还没登录）。
2. 用 passkey 解锁空间。
3. 看清客户端申请的权限，点 允许。

客户端拿不到你的 passkey。它得到的是一个只能打开这个空间、只在你允许范围内有效的 token。Free 套餐下它只能读，Pro 下还可以写。每次有客户端获得授权，Vesper 都会发邮件通知你。

要停止某个客户端的访问，在那个客户端里删除这个连接。Vesper 的设置里暂时还不会列出 AI 客户端。

客户端能做什么

工具	作用	需要权限
list_entries	按时间倒序列出记录，含照片	读
search_entries	正文或标签包含关键词的记录	读
get_entry	一条记录的完整 Markdown、元数据和照片	读
list_photos	照片及拍摄时间、地点和相机参数	读
list_tags	标签及使用次数	读
create_entry	写一条新记录。照片只能在应用里添加。	写（Pro）
update_entry	修改正文、标签、可见性、置顶、收藏或归档	写（Pro）
change_tag	在所有记录上重命名或移除一个标签	写（Pro）
delete_entry	永久删除一条记录	写（Pro）

列表和搜索工具接受 fromDate、toDate（都是 UTC 的 YYYY-MM-DD，toDate 包含当天）和 tag。结果按页返回，每页 50 条记录或 24 条记录的照片，客户端用 next 取下一页。

可以这样问

• "总结一下我上周写了什么。"
• "我今年在诺丁汉拍过哪些咖啡馆？"
• "找出我记下 Mia 推荐的那几本书的记录。"
• "给所有跟跑步有关的记录加上 跑步 标签。"（Pro）