Notion_mcp_server

🚀 配置 Notion API 密钥和权限

本项目主要用于指导用户完成 Notion API 密钥的创建、权限配置，以及相关代码和工具的使用设置，帮助用户顺利使用 Notion API 进行开发。

🚀 快速开始

🔑 创建 Notion API 密钥

1. 访问 Notion 集成：访问 Notion 集成，并使用您的 Notion 账户登录。
2. 创建新集成：点击 "New Integration"，填写所需的字段（例如集成名称），然后选择您要连接的工作区。
3. 保存集成：提交后会生成一个 API 密钥。请将此密钥复制并安全保存，用于后续的 API 请求认证。
4. 获取 API 密钥：复制生成的 API 密钥，并确保其安全性。

🔐 配置页面权限以使用集成

1. 打开 Notion 页面：打开您要赋予权限的 Notion 页面。
2. 共享页面：点击页面顶部右侧的 "Share" 按钮。
3. 邀请集成：在 "Invite" 文本框中输入您的集成名称，并从下拉列表中选择它。这样可以授予该集成对页面的访问权限。
4. 设置权限：确保集成具有执行所需操作（例如读取、写入）的必要权限。

💻 代码更新

在 notion_sdk.py 文件中，将 PAGE_ID 更新为之前创建的页面 ID。您可以通过复制页面链接来获取该 ID。

示例中的 Notion 页面 ID

https://www.notion.so/MCP-Parent-Page-1d21f7216bdb80789f88fccd964b5031

📄 Curl 示例

以下是一个使用 Notion API 创建新页面的示例：

curl --location --request POST 'https://api.notion.com/v1/pages' \
--header 'Authorization: Bearer $NOTION_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Notion-Version: 2021-05-13' \
--data '{
"parent": { "page_id": "1d21f7216bdb80789f88fccd964b5031" },
"properties": {
"title": [
{
"text": {
"content": "新页面标题"
}
}
]
}
'

🛠️ 在 Claude 中设置

安装 uv 工具

如果您使用的是 Mac，请通过以下命令安装：

brew install uv

验证安装是否成功：

uv --version

运行 Python 脚本：

uv run