连接器Notion
官方参考资料
按配置、页面授权、访问令牌和资源库能力查阅 Notion 官方资料。
本指南说明 EasyXAI 中的实际操作。遇到 Notion 后台入口变化或需要了解权限细节时，可对照以下官方资料；Notion 新界面的 Connection 对应旧资料中常见的 Integration。
配置与授权
| 主题 | 官方资料 | 阅读重点 |
|---|---|---|
| 开发者后台 | Notion Developer tools | 新建连接及认证方式 |
| OAuth 连接 | Public connections | 安装范围、客户端凭证和创建流程 |
| 页面授权 | Authorization | 页面选择器、回调和用户授权 |
| 读取与写入能力 | Connection capabilities | Read content、写入能力及变更后的重新授权 |
| 内部连接 | Internal connections | 机器人身份、安装令牌及页面共享 |
| 个人令牌 | Personal access tokens | 用户权限、令牌到期时间和工作空间策略 |
EasyXAI 已处理授权回调与凭据保存，用户无需部署官方代码示例。OAuth 回调地址以 EasyXAI 当前部署为准，不要照抄第三方教程的 localhost 或示例域名。
资源库与工具能力
| 主题 | 官方资料 | 与本项目的关系 |
|---|---|---|
| 根列表不完整或更新慢 | Search optimizations and limitations | 解释 Notion 搜索的索引延迟与枚举限制 |
| 页面内容读取 | Retrieve block children | 页面由内容块组成，嵌套内容需继续读取 |
| Notion 托管 MCP | Connect to Notion MCP | 了解独立的 MCP 连接流程；EasyXAI 以平台提供的能力为准 |
Notion API 支持的功能不等于 EasyXAI 已全部实现。当前资源库主要整理层级并预览页面文本，不还原全部数据库视图、页面排版或媒体。
回到操作指南
| 当前进度 | 下一步 |
|---|---|
| 为成员准备 OAuth | 配置 OAuth 应用 |
| 准备使用访问令牌 | 访问令牌指南 |
| 连接正常 | 资源库同步 |
| 使用智能体工具 | 在 EasyXAI 中使用 |
| 出现异常 | 常见问题 |