Notion MCP Server 配置与使用说明

支持客户端

• Claude Desktop
• Cursor
• VS Code / Cline

安装命令

npx -y @notionhq/notion-mcp-server

配置示例

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_xxx\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

需要设置环境变量：OPENAPI_MCP_HEADERS。不要把这些值提交到公开仓库。

权限范围与安全提示

可读写 Notion 页面，建议只授权特定页面的 Integration

• network-access
• credential-required

风险评分：4/10

常见报错

unauthorized

确认 Integration Token 有效且已连接到目标页面

object_not_found

确认 Integration 已被添加到目标页面或数据库

来源

• 官方文档 / 仓库

最近核验：2026-05-18。客户端版本和配置格式可能变化，使用前请以官方文档为准。

相关工具