Notion MCP Server

Not 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 Assistant”或“AI Helper”
   • 徽标：可选
   • 关联工作区：选择您的 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 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 密钥有效
• 验证您的集成是否可以访问页面/数据库

执照

麻省理工学院