Not MCP 服务器

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

这是什么？

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

• 查看和搜索您的 Notion 数据库

• 创建和更新页面

• 管理内容块

• 还有更多！

Related MCP server: Notion MCP Server

分步设置指南

先决条件

• Node.js （版本 14 或更高版本）

• Notion 帐户

• Claude 桌面应用程序（如果与 Claude 一起使用）

1. 获取 Notion API 密钥

1. 前往https://www.notion.so/my-integrations

2. 点击蓝色的**“+ 新集成”**按钮

3. 填写详细信息：

   • 名称：选择一个名称，例如“Claude Assistant”或“AI Helper”

   • 徽标：可选

   • 关联工作区：选择您的 Notion 工作区

4. 点击**“提交”**

5. 在下一页上，找到**“内部集成令牌”**部分

6. 单击**“显示”**并复制令牌（以secret_开头）

2. 设置此服务器

下载存储库

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

1. 前往 GitHub 存储库： https://github.com/Sjotie/notionMCP/

2. 点击右上角的绿色“代码”按钮

3. 选择“下载 ZIP”

4. 下载后，将 ZIP 文件解压到计算机上的某个位置

   • Windows：右键单击 ZIP 文件并选择“全部提取”

   • Mac：双击 ZIP 文件进行解压

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

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

   • Windows：按Win+R ，键入cmd ，然后按 Enter 键

   • Mac：从“应用程序”>“实用程序”打开终端

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 个软件包正在寻求资金”之类的信息——这完全正常，表示安装成功了。

3. 连接到 Notion 页面

为了安全起见，Notion 要求您明确授予对每个页面或数据库的访问权限：

1. 打开 Notion 并导航到您希望 AI 访问的页面或数据库

2. 点击右上角的**“•••”** （三个点）

3. 选择**“添加连接”**

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 数据库列表”

   • “在我的任务数据库中创建一个标题为‘测试任务’的新页面”

可用工具

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

• list-databases ：查看所有可访问的数据库

• 查询数据库：从数据库中获取条目

• create-page ：向数据库添加新页面

• update-page ：修改现有页面

• create-database ：创建一个新的数据库

• update-database ：修改数据库结构

• get-page ：查看特定页面

• get-block-children ：查看内容块

• append-block-children ：向页面添加内容

• update-block ：编辑内容块

• get-block ：查看特定块

• 搜索：在整个工作区中查找内容

故障排除

常见问题：

1. 克劳德的“连接失败”

   • 确保 claude_desktop_config.json 中的服务器路径正确

   • 检查您的 Notion API 密钥是否有效

   • 确保已安装 Node.js

2. 访问 Notion 内容时出现“访问被拒绝”

   • 确保您已与集成共享页面/数据库

   • 检查您的 API 密钥是否具有必要的权限

3. 服务器无法启动

   • 确保所有依赖项都已安装（ npm install ）

   • 检查 .env 文件是否存在以及您的 API 密钥

获取帮助

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

• 检查控制台输出的错误消息

• 确保您的 Notion API 密钥有效

• 验证您的集成是否可以访问页面/数据库

执照

麻省理工学院