Notion MCP 服务器

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

这是什么？

这个工具充当AI助手（如Claude）和您的Notion工作区之间的桥梁。它允许AI：

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

逐步设置指南

前提条件

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

1. 获取您的Notion API密钥

前往 https://www.notion.so/my-integrations
单击蓝色的 "+ New integration" 按钮
填写详细信息：
- 名称：选择一个名称，如“Claude Assistant”或“AI Helper”
- Logo：可选
- 关联的工作区：选择您的Notion工作区
单击 "Submit"
在下一页中，找到 "Internal Integration Token" 部分
单击 "Show" 并复制令牌（它以 secret_ 开头）

2. 设置此服务器

下载仓库

选项A：作为ZIP下载（推荐给初学者）

前往GitHub仓库: https://github.com/Sjotie/notionMCP/
单击右上角的绿色“Code”按钮
选择“Download ZIP”
下载完成后，将ZIP文件解压到您计算机上的某个位置
- Windows: 右键点击ZIP文件并选择“全部解压缩”
- Mac: 双击ZIP文件以解压

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

打开命令提示符或终端
- Windows: 按 Win+R，输入 cmd，然后按 Enter
- Mac: 从应用程序 > 实用工具中打开终端
导航到您想要存储仓库的位置
```
cd path/to/desired/location
```

克隆仓库

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

导航到项目目录

下载或克隆后，您需要使用 cd（更改目录）命令导航到项目文件夹：

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

打开命令提示符或终端
使用 cd 命令导航到您解压ZIP文件的位置：
```
cd path/to/extracted/folder/notionMCP
```
例如：
- 在Windows上：cd C:\Users\YourName\Downloads\notionMCP
- 在Mac上：cd /Users/YourName/Downloads/notionMCP

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

仓库应该已经被克隆到一个名为 "notionMCP" 的文件夹中
如果您在克隆后仍然在同一终端窗口中，只需输入：
```
cd notionMCP
```

如何知道您在正确的目录中：

使用 cd 命令后，您可以检查当前的位置：
- 在Windows上：输入 dir 并按 Enter - 您应该能看到像 server.js 这样的文件
- 在Mac上：输入 ls 并按 Enter - 您应该能看到像 server.js 这样的文件

安装依赖

一旦你进入 notionMCP 目录，请安装所需的依赖项：

npm install

这将安装所有必要的 Node.js 包。你应该会看到一个进度条，最终会显示一条消息表明安装已完成。它可能会说“X 个包正在寻找资金”——这是完全正常的，意味着安装成功了。

3. 连接到 Notion 页面

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

打开 Notion 并导航到你希望 AI 访问的页面或数据库
点击右上角的 "•••"（三个点）
选择 "添加连接"
查找并选择你之前创建的集成
对于你想让其可访问的任何其他页面或数据库重复此步骤

4. 连接到 Claude 桌面版

找到你的 Claude 桌面版配置文件：
- Windows: %APPDATA%\Claude\claude_desktop_config.json （在文件资源管理器地址栏中输入此路径）
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json （在 Finder 中，按 Cmd+Shift+G 并粘贴此路径）

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

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

替换：
- 将 C:\\path\\to\\notion-mcp-server\\server.js 替换成 server.js 文件的实际路径
  - Windows: 在路径中使用双反斜杠 (\\)
  - Mac: 使用正斜杠 (/)
- 将 your_notion_api_key_here 替换成你的 Notion API 密钥
保存文件并重启 Claude 桌面版

5. 测试连接

在 Claude 中开始一个新的对话
请求 Claude 与你的 Notion 工作区进行交互，例如：
- “显示我的 Notion 数据库列表”
- “在我的任务数据库中创建一个标题为 '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: 在整个工作区查找内容

故障排除

常见问题：

Claude 中的“连接失败”
- 确保 claude_desktop_config.json 中的服务器路径是正确的
- 检查您的 Notion API 密钥是否有效
- 确保已安装 Node.js
访问 Notion 内容时出现“访问被拒绝”
- 确保您已与集成共享页面/数据库
- 检查您的 API 密钥是否具有必要的权限
服务器无法启动
- 确保所有依赖项都已安装（npm install）
- 检查 .env 文件是否存在并包含您的 API 密钥

获取帮助

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

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

许可证

MIT