跳到主要内容

连接 Notion

将 Notion 工作区连接到 Rephlo,让 AI 能够在对话中搜索和修改页面及数据库。Notion 连接器适用于 Starter、Pro、Pro+、Elite 和 Enterprise 各订阅方案,以及**试用(Trial)**期间。各方案具体包含的功能请参阅方案与定价。

Notion 在桌面应用的 Settings → Connectors 中完成连接。有关连接器工作原理的背景信息,请参阅连接器概览。

您可以做什么​

当 Notion 已连接并在输入框的 Connectors 菜单中被选中时,模型可以代表您调用以下工具:

  • **搜索(Search)**页面和数据库,可按关键词、标签或日期查找。
  • **读取(Read)**页面内容,包括各个区块(block)和数据库行。
  • **创建(Create)**新页面或数据库行。
  • **更新(Update)**现有页面——追加区块、编辑属性或更改状态。

每次工具调用都会在对话中显示为一张小的面包屑卡片,展示工具名称、状态以及耗时——因此您无需翻阅原始输出,就能清楚看到 AI 具体做了什么。

如何连接​

  1. 在桌面应用中,打开 Settings → Connectors。
  2. 找到 Notion 卡片并点击 Connect。
  3. 系统默认浏览器会打开 Notion 的授权页面。如需要,请先登录。
  4. 选择要让 Rephlo 访问的 Notion 工作区及页面。您可以只授权访问特定的页面和数据库——Notion 并不要求授予整个工作区的访问权限。
  5. 批准授权。浏览器会将控制权交还给 Rephlo,卡片状态会切换为 Connected 徽章。

Notion 连接器——Connect 状态与带状态徽章的 Connected 状态

设置中的 Notion 连接器卡片,连接前与连接后的状态对比。

整个流程采用 OAuth 2.1 配合 PKCE 和动态客户端注册(Dynamic Client Registration)。不存在任何共享凭据,也无需复制粘贴 API 密钥——您的访问权限仅限于您自己的账户,并可随时在 Notion 自身的集成设置中撤销。

Rephlo 请求的权限​

权限AI 可以做什么
Read content读取您已明确共享给该连接器的页面和数据库。
Update content编辑您已共享的页面和数据库行。
Insert content在您已共享的工作区中添加新页面和新行。

Rephlo 永远无法访问您在授权步骤中未共享给该连接器的页面。您可以随时重新执行连接流程,以扩大或缩小共享范围。

您的数据存放在哪里​

  • 授权令牌以加密方式存储在您的设备上,位于 Rephlo 的应用数据文件夹中。它们不会离开您的设备——Rephlo 的后端不会看到这些令牌。
  • 工具调用结果(例如搜索返回的某个页面)仅在对话会话处于活跃状态时保留在内存中。完整结果不会保存到磁盘;对话中的面包屑只会显示简短的文本摘要。
  • 您设备上的审计日志会记录每一次连接、断开、刷新和工具调用——仅记录连接器名称、工具名称、耗时和状态。工具参数和结果内容永远不会被记录。

在对话中使用 Notion​

请确保在输入框的 Connectors 菜单中已选中 Notion。然后只需自然地提问即可——例如:"Find my Q3 planning page in Notion and summarize the open tasks."(在 Notion 中找到我的 Q3 规划页面并总结未完成的任务)。AI 会调用搜索和读取工具,您也会在其工作过程中看到相应的面包屑。

断开连接​

点击 Notion 卡片上的 Disconnect 将会:

  1. 取消所有正在进行中的 Notion 工具调用。
  2. 关闭与 Notion 的连接。
  3. 尽力(best-effort)撤销与 Notion 之间的访问令牌和刷新令牌。
  4. 清除已缓存的工具列表以及本地数据库中的连接记录。

过去 Notion 工具调用产生的历史对话面包屑会予以保留——它们只是历史记录,而非有效凭据。

如果您还希望从 Notion 一侧撤销 Rephlo 的访问权限(建议进行完整清理时执行),请打开 Notion 的 Settings & Members → Integrations,并移除 Rephlo。

故障排查​

"Authorization failed — please try again." 通常是浏览器会话过期,或登录过程被中断所致。请在 Notion 卡片上再次点击 Connect。

连接显示 "Needs re-auth." 说明您的访问权限已过期,或已在 Notion 一侧被撤销。请打开该卡片的详情面板并重新授权。

"Some tools are unavailable because they need additional permissions." 表示您授予的权限少于 Rephlo 所请求的权限。请点击 Reconnect 并接受完整的权限集合,以恢复所有工具的可用性。

某次工具调用报出协议错误(protocol error)。 这几乎总是 Notion 出现短暂中断所致。请几分钟后重试——对话会继续进行,只有失败的那次调用会受影响。

某次工具调用超时。 长时间运行的操作(大范围搜索、大页面读取)可能会触及每次调用 60 秒的限制。请尝试缩小查询范围,或将任务拆分为更小的请求。

后续内容​

我们会持续定期添加更多连接器——请查看连接器概览,了解当前已支持及即将推出的完整最新列表。您也可以立即添加自行运维的服务器;请参阅自定义 MCP 服务器。