Sensefold

官方

每个AI的个人上下文:搜索、读取并写回你的私有Markdown库,其中包含文章、帖子、PDF、笔记以及捕获的ChatGPT/Claude/Gemini/Grok对话。远程服务器,OAuth 2.1粘贴并授权或可撤销的分层Agent密钥(只读/编辑/完全)。每次Agent编辑都有版本记录且可回滚。

你可以用 Sensefold MCP 做什么?

  • 搜索已保存的库 — 让助手使用 search_hub 按含义和关键词跨语言查找已保存的文章、话题或笔记。
  • 读取已保存的项目 — 让助手使用 get_item 将任何捕获内容(包括转录、OCR 文本或你自己的笔记)检索为干净的 Markdown。
  • 保存新内容 — 指示助手使用 save_linksave_note 将 URL 添加或直接写入新笔记到你的库中。
  • 带版本控制的编辑笔记 — 让助手使用 update_noteupdate_tags 修改内容,每次更改都可以从项目历史中还原。
  • 检查使用情况 — 让助手调用 get_quota 以在批量保存前确认你的套餐、剩余积分和存储空间。

文档

你的智能体可以读取什么

你捕获的所有内容都会以 Markdown 格式存入一个私有资料库,因此智能体无需自行解析网页、PDF 或聊天记录:

  • 文章和新闻通讯:从任意页面剪藏,自动生成摘要和标签。
  • 帖子串:来自 X、Reddit、LinkedIn、Threads、Bluesky 和 Hacker News,包含评论。
  • YouTube 视频:附带文字记录和章节指南。
  • PDF 和图片:支持 OCR,扫描页面和截图也能成为可搜索的文本。
  • 你自己的笔记:可被索引搜索,且不会被 Sensefold 的自动增强功能改写。你授权的智能体可以编辑它们,所有修改都有版本记录并可回滚。
  • 保存的 AI 对话:来自 ChatGPT、Claude、Gemini 和 Grok,通过 Chrome 扩展以带说话人标签的 Markdown 格式捕获。

搜索是混合式的,既支持关键词也支持语义搜索,并且支持跨语言:用英文提问也能找到你上个月保存的中文帖子。每条结果都带有指向原始条目的链接,智能体可以引用。完整的来源矩阵见功能文档

两分钟完成连接

或者让智能体自行配置

将这段提示词交给你的智能体。它会阅读设置指南,并与你一起配置 MCP 连接。无需下载或安装技能。

Read https://sensefold.app/for-agents/skill.md and help me connect Sensefold.

按客户端设置

地址在所有地方都一样,只是菜单不同。以下每个客户端在文档中都有分步指南。

Claude.ai 和 Claude Desktop

打开 Customize → Connectors → Add custom connector,粘贴 Sensefold 地址,然后点击 Add。Claude 会打开浏览器进行登录;在同意屏幕上选择权限层级。无需创建密钥。之后 Claude 就可以搜索你保存的文章和帖子串、按标题阅读笔记,并将对话结论保存为新笔记。

完整指南 →

Claude Code

运行 claude mcp add --transport http sensefold https://api.sensefold.app/mcp,然后输入 /mcp 并选择 Authenticate 以在浏览器中完成 OAuth。在无头或 CI 机器上,请改用 --header "Authorization: Bearer $SENSEFOLD_AGENT_KEY" 并附带一个可撤销的 Agent 密钥。读取工具带有只读提示,因此搜索无需确认提示即可运行。

完整指南 →

ChatGPT

在 Settings → Security and login 下开启 Developer mode,然后将 Sensefold 添加为使用 MCP 地址的连接。ChatGPT 通过 OAuth 授权,并使用 searchfetch 别名来基于你的资料库提供答案。ChatGPT 网页版维护自己的连接列表,与 Codex 分开。

完整指南 →

Codex

在 Codex 应用中,打开 Settings → MCP servers → Add server,选择 Streamable HTTP,粘贴地址,重启,然后选择 Authenticate。从命令行:codex mcp add sensefold --url https://api.sensefold.app/mcp 然后 codex mcp login sensefold。应用、CLI 和 IDE 扩展在每台机器上共享同一份配置。

完整指南 →

Cursor

打开 Customize → MCPs → New MCP server,添加一个条目,其 url 为 Sensefold 地址。Cursor 会提示你登录;Connected 下的工具数量随后会显示层级。如果你更喜欢使用密钥,可以添加一个 Authorization 头,从环境变量中读取密钥,而不是将密钥粘贴到文件中。

完整指南 →

OpenClaw

使用 openclaw mcp add sensefold --url https://api.sensefold.app/mcp --transport streamable-http --auth oauth --no-probe 注册服务器,然后运行 openclaw mcp login sensefold 并在浏览器中批准访问。如果回调页面无法加载,请复制 code 参数并使用 openclaw mcp login sensefold --code 完成。使用 openclaw mcp doctor sensefold --probe 进行验证。

完整指南 →

Hermes Agent

运行 hermes mcp add sensefold --url https://api.sensefold.app/mcp --auth oauth,在浏览器中批准连接,并启用发现的工具。hermes mcp test sensefold 确认连接。远程 Hermes 网关无法接收回环回调;请在那里使用其远程 OAuth 辅助工具或 Agent 密钥。

完整指南 →

其他 MCP 客户端

任何支持 Streamable HTTP 的客户端都可以连接。OAuth 2.1 客户端会自动发现授权服务器并自行注册,无需预先注册客户端 ID。仅支持静态头的客户端可以发送 Authorization: Bearer 并附带 Agent 密钥。VS Code 在 .vscode/mcp.json 中使用与 Claude Code 相同的 JSON 条目;MCP Inspector 是快速检查工具列表的好方法。有关确切模式,请参阅 MCP 工具参考,设置请参阅 VS Code 指南任意 MCP 客户端指南,连接失败时请参阅故障排除

安全模型

OAuth 优先。 浏览器客户端通过 OAuth 2.1 授权,并获得一个你可以在 Sensefold 设置中查看和撤销的连接;已撤销的行仍会显示为历史记录,但不再授予任何权限。Agent 密钥 覆盖无头场景:在 Settings → Agents 中创建,带有层级,仅显示一次,前缀为 lexi_agent_v1_,可撤销且可轮换。

层级决定智能体可见范围。 read_only 连接列出六个工具,edit 列出十个,full 列出十一个。列表只是可见的一半:每次调用都会在服务器端根据层级进行检查。

写入操作有版本记录。 update_noteupdate_tags 会创建修订版本,你可以从条目的历史记录中进行差异对比和回滚。保存和删除会记录在 Activity 中;删除会进入回收站并可恢复。更新和删除必须发送来自最新读取的 expectedVersion,这样两个智能体就不会静默地互相覆盖。

Settings → For agents in the Sensefold web app: the MCP server address with a Copy button, the manual Agent key form with Read only, Edit, and Full access tiers, and the list of connections and keys.

Settings → For agents 在网页应用中:连接列表在底部,其上方是 Agent 密钥表单,作为无头场景的备用方案。

你的笔记始终属于你。 自动增强功能会为捕获内容生成摘要和标签,但绝不会改写你撰写的笔记。只有具有编辑层级的智能体才能修改笔记,而且你可以撤销修改。

你的智能体可以调用的工具

三个层级共九个工具,外加两个只读别名。连接后自检:客户端的工具列表应显示只读 6 个工具、编辑 10 个、完整 11 个。

search_hubread_only按含义和关键词搜索你保存的所有内容。支持跨语言:查询可以是英文、中文或混合语言。
list_itemsread_only浏览最近的保存内容,或按日期和来源筛选。
get_itemread_only以干净的 Markdown 文本读取单个条目,支持分窗口或按匹配段落读取。
get_quotaread_only检查你的套餐、积分余额和限制。
save_linkedit保存一个 URL;捕获后运行摘要、标签和 OCR。
save_noteedit将新笔记写入你的资料库,原样存储。
update_noteedit替换条目的文本。支持修订:可从条目历史记录中进行差异对比和回滚。
update_tagsedit替换条目的标签。支持修订:可从条目历史记录中进行差异对比和回滚。
delete_itemfull将条目移至回收站。你可以恢复它。
search / fetchread_only遵循 ChatGPT 连接器约定的别名;它们映射到 search_hub 和 get_item。

模式、重试约定和权限矩阵:MCP 工具参考 →

示例提示词

连接后,你可以像往常一样与 AI 对话。它会自行决定何时调用 Sensefold。

基于你已读过的内容做出决策

搜索我的 Sensefold 资料库中所有关于定价模型的保存内容,阅读最相关的三个条目,并在我们设计自己的定价模型之前总结其中的权衡取舍。

在不同 AI 中继续之前的对话

找到我上周保存的关于选择搬家城市的 ChatGPT 对话,阅读它,并从其未解决的问题继续。

将结论写回以备下次使用

保存一篇标题为“Sync layer decisions, September”的笔记,包含本帖子串的结论,标签为 architecture 和 decisions。

积分与限制

MCP 访问已包含在 Starter 和 Pro 套餐中。没有单独的智能体套餐或席位,也没有每个智能体的连接数限制。保存是免费的;AI 处理消耗积分,因此智能体保存与从应用或扩展保存一样消耗积分。get_quota 返回套餐、剩余积分和存储空间,因此智能体可以在批量保存前进行检查。套餐和积分包见定价页面

常见问题

Sensefold MCP 服务器 URL 是什么?

https://api.sensefold.app/mcp. 它是一个远程 Streamable HTTP 服务器,因此无需在本地安装或运行任何东西。将其粘贴到任何支持远程服务器的 MCP 客户端中,或在 Authorization 头中发送 Bearer Agent 密钥。

如何将 Claude 连接到我的已保存文章和笔记?

在 Claude 中,打开 Customize → Connectors → Add custom connector,粘贴 Sensefold MCP 地址,并完成 OAuth 登录。Claude Code 使用 claude mcp add --transport http,然后执行 /mcp Authenticate 步骤。无论哪种方式,Claude 都可以搜索、读取,并且(在编辑层级下)写入你的资料库。

Sensefold 支持 ChatGPT 吗?

支持。ChatGPT 在开发者模式下将 Sensefold 添加为远程 MCP 连接,通过 OAuth 授权,并使用搜索和获取工具基于你保存的内容提供答案。Codex 使用 codex mcp add 和 codex mcp login 连接。

Cursor 或 Claude Code 可以读取我的笔记吗?

可以。两者都是 MCP 客户端。使用 read_only 层级,它们可以搜索和读取所有条目,包括你自己的笔记;使用编辑层级,它们可以保存和更新笔记,并且每次更新都有版本记录且可回滚。

我需要 API 密钥吗?

不需要。带有浏览器的客户端通过 OAuth 2.1 授权,这会在 Sensefold 设置中创建一个可撤销的连接。Agent 密钥适用于无头和 CI 机器:在 Settings → Agents 中创建,仅显示一次,可撤销且可轮换。

给智能体写入权限安全吗?

写入权限是有范围且可逆的。工具列表由层级决定,每次调用都会在服务器端进行检查。update_note 和 update_tags 有修订支持,保存和删除会记录在 Activity 中,删除会进入回收站,并发编辑由 expectedVersion 检查保护。你可以随时从设置中撤销任何连接。

连接智能体需要额外费用吗?

不需要。MCP 访问已包含在 Starter 和 Pro 套餐中;没有单独的智能体套餐或席位。智能体保存与从应用保存运行相同的增强流程,因此消耗积分的方式相同,get_quota 会报告余额。

给你的智能体一些值得阅读的内容。

保存免费。AI 消耗积分。你的资料库,几分钟内完成连接。

开始免费试用