MCP 服务器

Notion MCP Server

一个模型上下文协议服务器，可以将 Claude 和其他 AI 助手连接到您的 Notion 工作区，从而允许 AI 与数据库、页面和块进行交互。

Tools

create-page

Create a new page in a database

update-page

Update an existing page

create-database

Create a new database

update-database

Update an existing database

get-page

Retrieve a page by its ID

get-block-children

Retrieve the children blocks of a block

append-block-children

Append blocks to a parent block

update-block

Update a block's content or archive status

get-block

Retrieve a block by its ID

Search Notion for pages or databases

list-databases

List all databases the integration has access to

query-database

Query a database

README

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”
- 徽标：可选
- 关联的工作区：选择您的 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 Packages are looking for funding”之类的话 - 这是完全正常的，意味着它有效。

3. 连接到 Notion 页面

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

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

4. 连接到 Claude Desktop

找到您的 Claude Desktop 配置文件：
- 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 Desktop

5. 测试连接

在 Claude 中开始新的对话
要求 Claude 与您的 Notion 工作区进行交互，例如：
- "Show me a list of my Notion databases"
- "Create a new page in my Tasks database with title '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 中显示“Connection failed”
- 确保 claude_desktop_config.json 中的服务器路径正确
- 检查您的 Notion API 密钥是否有效
- 确保已安装 Node.js
访问 Notion 内容时显示“Access denied”
- 确保您已与您的集成共享页面/数据库
- 检查您的 API 密钥是否具有必要的权限
服务器无法启动
- 确保已安装所有依赖项 (npm install)
- 检查 .env 文件是否存在以及是否包含您的 API 密钥