一、在 Notion 工作区新建数据库

二、获取数据库 ID

1. 复制数据库链接
• 打开目标数据库页面，或者右键点击工作空间下的页面
• 右键点击该页面，或者点击右上角的 ••• → 拷贝链接/Copy link

2. 解析数据库 ID（其实就是页面ID）
• 链接格式示例：https://www.notion.so/{workspace}?v={view_id}
• 提取 ?v= 参数前的 32 位哈希值（上面{workspace}的值）（例：b4f9d8...e6f5a4b3c）
• 注意：确保链接权限已设置为 Public

三、创建 Notion 集成并获取 API 密钥

1. 创建新集成
• 访问 Notion 集成管理页面
• 点击 集成 → 新集成

1. 配置集成参数
• 名称：建议使用有项目标识的名称如cherry-studio
• 关联工作区：选择目标工作区
• 权限设置：保持默认的读取内容、更新内容和插入内容及读取用户信息勾选

1. 获取密钥
• 创建成功后，在集成详情页复制 内部集成密钥
• 密钥格式：ntn_ 开头的字符串

四、绑定集成与数据库

1. 授权数据库访问
• 打开目标数据库/页面，或找到工作空间页面
• 点击右上角 ••• → 找到集成/Add connections



• 搜索并选择刚创建的集成

2. 验证连接状态
• 成功连接后，集成名称旁显示绿色状态点
• 如未显示，请刷新页面或检查数据库权限设置

五、配置 Cherry Studio

1. 打开并进入设置界面
• 导航至 Cherry Studio 的 数据配置-->Notion 配置

1. 填写配置参数

2. 测试连接
• 保存配置后，点击 Notion密钥 后面的检查，显示连接成功即可。

六、验证与调试

1. 常见问题排查
• 检查集成是否已关联数据库
• 确认数据库 ID 正确性
• 验证 API 密钥是否有效（一定要带前缀 ntn_）

注意事项

1. Notion API 存在 3-5 秒的缓存延迟

2. 敏感操作建议在测试环境先行验证

3. 定期轮换 API 密钥以保障安全

七、如果你使用 Notion Next

八、导出到Notion博客