Notion MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于将 Claude 和其他 AI 助手连接到您的 Notion 工作区。此集成允许 AI 助手与您的 Notion 数据库、页面和块进行交互。

这是什么？

此工具充当 AI 助手（如 Claude）和您的 Notion 工作区之间的桥梁。它允许 AI 执行以下操作：

• 查看和搜索您的 Notion 数据库
• 创建和更新页面
• 管理内容块
• 以及更多！

逐步设置指南

前提条件

• Node.js（版本 14 或更高版本）
• 一个 Notion 帐户
• Claude 桌面应用程序（如果与 Claude 一起使用）

1. 获取您的 Notion API 密钥

1. 转到 https://www.notion.so/my-integrations
2. 单击蓝色的 "+ 新建集成" 按钮
3. 填写详细信息：
   • 名称：选择一个名称，例如“Claude 助手”或“AI 助手”
   • 徽标：可选
   • 关联的工作区：选择您的 Notion 工作区
4. 单击 "提交"
5. 在下一页上，找到 "内部集成令牌" 部分
6. 单击 "显示" 并复制令牌（它以 secret_ 开头）

2. 设置此服务器

1. 将此存储库下载到您的计算机

   • 如果您有 Git：git clone [repository-url]
   • 或者下载并解压缩 ZIP 文件

2. 打开命令提示符或终端

   • Windows：按 Win+R，键入 cmd，然后按 Enter
   • Mac：从“应用程序”>“实用工具”打开“终端”

3. 导航到您下载此存储库的文件夹：

   cd path/to/notion-mcp-server
   

4. 安装所需的依赖项：

   npm install
   

5. 创建一个配置文件：

   • 复制 .env.example 并将其命名为 .env
   • 在文本编辑器中打开 .env 文件
   • 将 your_notion_api_key_here 替换为您之前复制的令牌
   • 保存文件

3. 连接到 Notion 页面

出于安全考虑，Notion 要求您明确授予对每个页面或数据库的访问权限：

1. 打开 Notion 并导航到您希望 AI 访问的页面或数据库
2. 单击右上角的 "•••"（三个点）
3. 选择 "添加连接"
4. 查找并选择您之前创建的集成
5. 对您要使其可访问的任何其他页面或数据库重复此操作

4. 连接到 Claude 桌面

1. 找到您的 Claude 桌面配置文件：

   • Windows：%APPDATA%\Claude\claude_desktop_config.json （在文件资源管理器地址栏中键入此路径）
   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json （在 Finder 中，按 Cmd+Shift+G 并粘贴此路径）

2. 在文本编辑器中打开该文件。如果它不存在，请使用以下内容创建它：

   {
     "mcpServers": {
       "notion": {
         "command": "node",
         "args": [
           "C:\\path\\to\\notion-mcp-server\\server.js"
         ],
         "env": {
           "NOTION_API_KEY": "your_notion_api_key_here"
         }
       }
     }
   }
   

3. 替换：

   • C:\\path\\to\\notion-mcp-server\\server.js 为 server.js 文件的实际路径
     • Windows：在路径中使用双反斜杠 (\\)
     • Mac：使用正斜杠 (/)
   • your_notion_api_key_here 为您的 Notion API 密钥

4. 保存文件并重新启动 Claude 桌面

5. 测试连接

1. 在 Claude 中开始一个新的对话
2. 要求 Claude 与您的 Notion 工作区进行交互，例如：
   • "显示我的 Notion 数据库列表"
   • "在我的任务数据库中创建一个新页面，标题为 '测试任务'"

可用工具

该服务器为 AI 助手提供以下工具：

• list-databases：查看所有可访问的数据库
• query-database：从数据库中获取条目
• create-page：向数据库添加新页面
• update-page：修改现有页面
• create-database：创建一个新数据库
• update-database：修改数据库结构
• get-page：查看特定页面
• get-block-children：查看内容块
• append-block-children：向页面添加内容
• update-block：编辑内容块
• get-block：查看特定块
• search：在您的工作区中查找内容

故障排除

常见问题：

1. Claude 中显示“连接失败”

   • 确保 claude_desktop_config.json 中的服务器路径正确
   • 检查您的 Notion API 密钥是否有效
   • 确保 Node.js 已正确安装

2. 访问 Notion 内容时显示“访问被拒绝”

   • 确保您已与您的集成共享页面/数据库
   • 检查您的 API 密钥是否具有必要的权限

3. 服务器无法启动

   • 确保已安装所有依赖项 (npm install)
   • 检查 .env 文件是否存在以及是否包含您的 API 密钥

获取帮助

如果您遇到此处未涵盖的问题，请：

• 检查控制台输出中的错误消息
• 确保您的 Notion API 密钥有效
• 验证您的集成是否有权访问页面/数据库

许可证

MIT