NotionMCP

笔记官方认证 JavaScript

🚀 Notion MCP 服务器

这是一个模型上下文协议（MCP）服务器，它能将Claude和其他AI助手连接到您的Notion工作区。借助此集成，AI助手可以查看、搜索并操作您的Notion数据库、页面及区块内容。

🚀 快速开始

该工具充当AI助手（如Claude）与您的Notion工作区之间的桥梁。它使AI能够：

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

📦 安装指南

先决条件

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

安装步骤

第一步：获取Notion API密钥

登录Notion。
进入“设置” > “安全” > “生成API密钥”。
复制生成的API密钥。

第二步：安装Node.js

下载并安装Node.js（包括npm）。
- 访问Node.js官方页面下载适合您操作系统的版本。
安装完成后，打开终端或命令提示符，输入以下命令验证：
```
node -v
npm -v
```
如果显示版本号，则安装成功。

第三步：克隆Notion MCP服务器仓库

打开终端或命令提示符。

运行以下命令克隆仓库到您的本地机器：

git clone https://github.com/notion-mcp-server/notion-mcp.git

切换到克隆后的目录：
```
cd notion-mcp
```

第四步：安装依赖项

运行以下命令安装项目所需的依赖项：
```
npm install
```

第五步：配置服务器

在项目根目录中创建一个.env文件。
添加以下内容到.env文件，替换占位符为您的实际值：
```
NOTION_API_KEY=your_notion_api_key_here
```
保存并关闭文件。

第六步：启动服务器

在终端或命令提示符中运行以下命令启动服务器：
```
npm start
```
如果一切正常，您将在控制台看到类似以下的输出：
```
Server is running on port 3000
```

✨ 主要特性

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

0 条评论
分类：笔记