🚀 Notion MCP 服务器
Notion MCP 服务器是一个提供官方 Notion SDK 的模型上下文协议 (MCP) 服务器，它能让 AI 模型与 Notion 工作区进行交互，为 AI 与 Notion 的协同工作提供了便利。
🚀 快速开始
🔧 设置你的 Notion 集成
- 访问 https://www.notion.so/my-integrations 。
- 创建一个新的集成。
- 复制 API 密钥。
📎 将你的 Notion 页面连接到集成
为了让您的集成访问 Notion 内容，您需要显式地共享您的页面或数据库：
- 导航到您要通过集成访问的 Notion 页面或数据库。
- 点击右上角的“共享”按钮。
- 在“添加人员、组或集成”字段中，从下拉列表中选择您的集成。
- 点击“邀请”。
- 对每个页面或数据库重复上述操作。
⚠️ 重要提示
集成仅能访问显式共享给它的页面和数据库。父页面不会自动授予对子页面的访问权限。
➕ 添加到你的 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：按照文档中提到的相应配置方法进行设置。
✨ 主要特性
以下是服务器提供的主要功能：
- 🔍 搜索：允许 AI 模型查询 Notion 内容。
- 📊 数据库操作：支持 CRUD 操作（创建、读取、更新、删除）在 Notion 数据库中。
- 📄 页面管理：包括创建、编辑和删除页面的功能。
- 🧱 块处理：处理 Notion 页面中的各种内容块，如文本、图像等。
📚 详细文档
- 支持多种 Notion 操作，包括搜索、创建和管理内容。
- 具备强大的错误处理机制，能提供详细的错误消息。
- 支持环境变量配置，可简化设置流程。
🚧 故障排除
常见问题
- API 错误：检查 API 密钥是否正确配置，并确保您的集成有适当的权限。
- 连接问题：确保你的网络连接正常，并且 Notion 服务可用。
- 错误信息：查看详细的错误消息以获取更多调试信息。
解决方法
- 🔑 重新生成密钥：如果遇到身份验证问题，可以尝试重新生成 API 密钥。
- 🔒 检查权限：确保您的集成具有访问所需资源的适当权限。
- 📦 更新依赖项：确保所有相关依赖项已更新到最新版本。
📄 许可证
此项目在 Apache License 2.0 下许可 - 有关详细信息，请参阅 LICENSE 文件。