Notion MCP Server

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. 点击蓝色的 "+ New integration" 按钮
3. 填写详细信息：
   • Name：选择一个名称，例如 "Claude Assistant" 或 "AI Helper"
   • Logo：可选
   • Associated workspace：选择你的 Notion 工作区
4. 点击 "Submit"
5. 在下一页找到 "Internal Integration Token" 部分
6. 点击 "Show" 并复制令牌（以 secret_ 开头）

2. 设置此服务

下载代码仓库

选项 A：下载 ZIP（推荐新手使用）

1. 前往 GitHub 代码仓库：https://github.com/Sjotie/notionMCP/
2. 点击右上角的绿色 "Code" 按钮
3. 选择 "Download ZIP"
4. 下载完成后，将 ZIP 文件解压到电脑上的某个位置
   • Windows：右键点击 ZIP 文件并选择 "Extract All"
   • Mac：双击 ZIP 文件进行解压

选项 B：使用 Git 克隆（适合熟悉 Git 的用户）

1. 打开命令提示符或终端
   • Windows：按 Win+R，输入 cmd，然后按 Enter
   • Mac：从“应用程序”>“实用工具”中打开 Terminal
2. 前往要存放代码仓库的位置

   cd path/to/desired/location
   

3. 克隆代码仓库

   git clone https://github.com/Sjotie/notionMCP/
   

前往项目目录

下载或克隆后，你需要使用 cd（更改目录）命令前往项目文件夹：

如果你下载了 ZIP（选项 A）：

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

2. 使用 cd 命令前往 ZIP 文件的解压位置：

   cd path/to/extracted/folder/notionMCP
   

   例如：

   • Windows：cd C:\Users\YourName\Downloads\notionMCP
   • Mac：cd /Users/YourName/Downloads/notionMCP

如果你使用 Git 克隆（选项 B）：

1. 代码仓库应该已克隆到名为 "notionMCP" 的文件夹中
2. 如果克隆后你仍处于同一个终端窗口，只需输入：

   cd notionMCP
   

如何确认你位于正确的目录：

• 使用 cd 命令后，你可以查看当前位置：
  • Windows：输入 dir 并按 Enter——你应该能看到 server.js 等文件
  • Mac：输入 ls 并按 Enter——你应该能看到 server.js 等文件

安装依赖项

进入 notionMCP 目录后，安装所需的依赖项：

npm install

这将安装所有必需的 Node.js 软件包。你应该会看到进度条，最终会显示安装完成的提示。提示可能类似于 "X Packages are looking for funding"——这完全正常，表示安装成功。

3. 连接 Notion 页面

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

1. 打开 Notion，并前往你希望 AI 访问的页面或数据库
2. 点击右上角的 "•••"（三个点）
3. 选择 "Add connections"
4. 找到并选择你之前创建的集成
5. 对希望开放访问的其他页面或数据库重复上述操作

4. 连接到 Claude Desktop

1. 找到 Claude Desktop 配置文件：

   • 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 Desktop

5. 测试连接

1. 在 Claude 中开始新的对话
2. 请 Claude 与你的 Notion 工作区交互，例如：
   • “列出我的 Notion 数据库”
   • “在我的 Tasks 数据库中新建一个标题为 ‘Test Task’ 的页面”

可用工具

该服务为 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