Not MCP 服务器

公开官方 Notion SDK 的模型上下文协议 (MCP) 服务器，允许 AI 模型与 Notion 工作区交互。

快速入门

1. 设置你的 Notion 集成

1. 前往https://www.notion.so/my-integrations

2. 创建新集成

3. 复制 API 密钥

2. 将你的 Notion 页面连接到集成

为了让您的集成能够访问 Notion 内容，您需要明确地与其共享您的页面或数据库：

1. 导航到您想要通过集成访问的 Notion 页面或数据库

2. 点击右上角的“分享”按钮

3. 在“添加人员、群组或集成”字段中，从下拉列表中选择您的集成

4. 点击“邀请”

5. 对每个想要访问的页面或数据库重复此操作

**注意：**集成只能访问已明确与其共享的页面和数据库。子页面会自动继承父页面的访问权限。

3. 添加到你的AI助手

您可以使用以下任一配置格式将此 MCP 服务器添加到 Claude Desktop、Cursor AI 或 Claude.ai：

命令行格式

JSON 配置格式

将your-notion-integration-key替换为步骤 1 中的 API 密钥。

设置说明

• Claude Desktop ：设置 > 高级 > 模型上下文协议

• 光标 AI ：设置 > AI > MCP 服务器

• Claude.ai（Web） ：配置文件 > 设置 > API 和集成 > 模型上下文协议

Related MCP server: Notion MCP Server

可用工具

服务器提供了与 Notion 交互的工具：

• 搜索：查找页面或数据库

• 数据库：查询和检索数据库条目

• 页面：创建、检索和更新页面

• 块：管理内容块（段落、列表等）

• 用户：列出用户并获取用户信息

• 评论：创建并列出评论

• 链接预览：为 URL 创建链接预览

替代设置方法

使用环境变量

您可以使用.env文件，而不是直接传递 API 密钥：

1. 创建.env文件：

2. 运行服务器：

带有环境变量的 JSON 配置（适用于 Claude Desktop）

您还可以使用 JSON 配置格式的环境变量：

命令行选项

故障排除

如果遇到“无法创建客户端”错误：

• 在 Windows 上，尝试在 npx 命令之前使用cmd /c

• 在 macOS/Linux 上，尝试使用 npx 的完整路径

• 在将命令添加到 AI 助手之前，请在终端中测试该命令

常见问题

• “无法访问资源”错误：确保您已与您的集成共享特定的 Notion 页面或数据库（请参阅步骤 2）

• 集成未出现在共享菜单中：请尝试刷新页面或重新启动浏览器

• 功能受限：检查您的集成是否在 Notion 集成设置中启用了适当的功能

特征

• 通过官方 SDK 提供完整的 Notion API 支持

• 符合 MCP 规范，可实现无缝 AI 集成

• 适用于所有 Notion 操作的综合工具

• 强大的错误处理功能，提供详细的消息

• 使用环境变量轻松配置

有关每个工具的详细文档，请参阅工具文档。

执照

该项目根据 Apache License 2.0 获得许可 - 有关详细信息，请参阅LICENSE文件。