Notion 接入教程
返回连接器① 获取 Notion 集成令牌
- 打开 https://www.notion.so/my-integrations → New integration(内部集成)。
- 在「配置」页找到「集成令牌 → 访问令牌」,点眼睛显示、复制按钮复制,形如 ntn_xxxxxxxx。
在「功能」里按需勾选读取/更新/插入内容等权限,然后点「保存连接」:
把要操作的页面/数据库共享给该集成:在「内容访问权限」标签里搜索/选择页面(或在目标页面右上 ••• →「连接」添加)。不做这步,令牌再对也读不到内容。
② 在平台里开通 Notion(两种方式)
方式 A · 应用市场一键安装(推荐)
到「我的连接器 → 应用市场」找到 Notion 模板 → 点「安装」→ 填入你自己的 ntn_ 令牌 → 完成。生成的连接器归你私有、只有你可见可用。
方式 B · 新建连接器(需管理员开放 stdio 权限)
「我的连接器 → 新建连接器」,按下表填:
| 传输 | stdio |
| command | npx |
| args(每行一个) | -y @notionhq/notion-mcp-server |
| env | NOTION_TOKEN=${NOTION_TOKEN} |
| 密钥 | NOTION_TOKEN=ntn_你的令牌 |
③ 启用并验证
- 在连接器上点「启用」→「检查」,正常显示「健康 · N 工具」。
- 点「工具」可看到 Notion 工具列表。
- 到「对话」选模型,用自然语言让它查/改 Notion;写操作可在「审批设置」里设为需确认或放行。
常见问题
- 异常 · command_missing / FileNotFoundError: npx:运行平台的服务器未安装 Node.js(stdio 类 MCP 靠 npx 启动)。请联系管理员在服务器安装 Node.js(提供 npx)。
- 工具能列出但调用返回空/无权限:目标页面没共享给集成(见 ①.3)。
- 模型把 <|…tool_calls|> 当文本输出:所选模型不支持工具调用,请改用支持 function-calling 的模型。
- 令牌请妥善保管;泄露后到 Notion 集成后台「Refresh」重置。
🔒 隐私说明
你配置的所有 MCP 账号信息(令牌、密钥等)均经过平台 加密存储,且后台与管理员都无法查看明文;接口响应、日志、导出一律脱敏。请放心填写。