用途:为 AI 智能体配置 Notion 集成令牌,使其能够访问用户的 Notion 工作区;适用于 Notion 命令因认证失败或用户主动要求连接工作区的场景。
主要能力:检查配置状态、保存并验证令牌、引导用户创建 Notion 集成。AI 智能体通过脚本与配置流程完成连接,令牌保存在本地配置文件中。
使用方式:先检查是否已配置,执行 python3 notion-connect/scripts/notion_connect.py --check,返回 JSON 如 {"configured": true, "workspace": "..."} 或 {"configured": false}。用户提供令牌后执行 python3 notion-connect/scripts/notion_connect.py --set-token "ntn_xxxxxxxxxxxxx",令牌会保存到 ~/.config/notion/config.json 并调用 Notion API 验证。
用户创建集成的步骤:访问 https://www.notion.so/my-integrations,点击 + New integration,命名并选择工作区,提交后复制以 ntn_ 开头的 Internal Integration Secret,粘贴到对话中。创建后还需在 Notion 页面中通过 ... 菜单 → Connections 选择该集成,授予页面及其子页面访问权限,否则集成无法看到任何内容。
配置格式:{"token": "ntn_...", "workspace_name": "...", "workspace_id": "..."},文件权限为 0600(仅用户可读)。
限制与注意:Notion 内部集成只需一个令牌,不要索要 OAuth 凭据;始终提醒用户配置 Content access;令牌必须以 ntn_ 开头,否则不正确。官方资料未提供更多功能、收费或平台细节。
后续可让智能体搜索近期页面、列出数据库或创建会议记录页面。