Notion 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，使用以下配置格式之一：

命令行格式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON 配置格式

{
  "name": "Notion",
  "command": {
    "args": [
      "@ramidecodes/mcp-server-notion@latest",
      "-y",
      "--api-key=your-notion-integration-key"
    ],
    "env": {},
    "executable": "npx"
  }
}

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

设置说明

• Claude Desktop: 设置 > 高级 > 模型上下文协议
• Cursor AI: 设置 > AI > MCP 服务器
• Claude.ai: 文档中提到的相应配置方法

可用工具

以下是服务器提供的主要功能：

1. 搜索: 允许 AI 模型查询 Notion 内容。
2. 数据库操作: 支持 CRUD 操作（创建、读取、更新、删除）在 Notion 数据库中。
3. 页面管理: 包括创建、编辑和删除页面的功能。
4. 块处理: 处理 Notion 页面中的各种内容块，如文本、图像等。

故障排除

常见问题

1. API 错误: 检查 API 密钥是否正确配置，并确保您的集成有适当的权限。
2. 连接问题: 确保你的网络连接正常，并且 Notion 服务可用。
3. 错误信息: 查看详细的错误消息以获取更多调试信息。

解决方法

1. 重新生成密钥: 如果遇到身份验证问题，可以尝试重新生成 API 密钥。
2. 检查权限: 确保您的集成具有访问所需资源的适当权限。
3. 更新依赖项: 确保所有相关依赖项已更新到最新版本。

功能

• 支持多种 Notion 操作，包括搜索、创建和管理内容。
• 强大的错误处理机制，提供详细的错误消息。
• 环境变量配置，简化设置流程。

许可证

此项目在 Apache License 2.0 下许可 - 有关详细信息，请参阅 LICENSE 文件。