🚀 Notion MCP 服务器

Notion MCP 服务器是一个提供官方 Notion SDK 的模型上下文协议（MCP）服务器，它允许 AI 模型与 Notion 工作区进行交互，为 AI 与 Notion 的结合提供了便利。

🚀 快速开始

🔧 设置你的 Notion 集成

1. 访问 https://www.notion.so/my-integrations。
2. 创建一个新的集成。
3. 复制 API 密钥。

🔗 将你的 Notion 页面连接到集成

为了让您的集成访问 Notion 内容，您需要显式地共享您的页面或数据库：

1. 导航到您要通过集成访问的 Notion 页面或数据库。
2. 点击右上角的“共享”按钮。
3. 在“添加人员、组或集成”字段中，从下拉列表中选择您的集成。
4. 点击“邀请”。
5. 对每个页面或数据库重复上述操作。

⚠️ 重要提示

集成仅能访问显式共享给它的页面和数据库。父页面不会自动授予对子页面的访问权限。

🤖 添加到你的 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. 📦 更新依赖项：确保所有相关依赖项已更新到最新版本。

📄 许可证

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