Notion 接入教程

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