Notionmcp

🚀 Notion MCP 服務器

Notion MCP 服務器是一個基於模型上下文協議（MCP）的工具，它能將 Claude 等 AI 助手連接到您的 Notion 工作區。藉助這一集成，AI 助手可以查看、搜索並操作您 Notion 中的數據庫、頁面以及區塊內容，為您的工作帶來更多便利。

🚀 快速開始

該工具在 AI 助手（如 Claude）和您的 Notion 工作區之間搭建了一座橋樑，藉助它，AI 能夠實現以下功能：

• 查看並搜索您的 Notion 數據庫
• 創建和更新頁面
• 管理內容區塊
• 以及其他更多功能！

📦 安裝指南

先決條件

• Node.js（版本 14 或更高）
• Notion 賬戶
• Claude 桌面應用程序（如果您打算與 Claude 一起使用）

安裝步驟

第一步：獲取 Notion API 密鑰

1. 登錄Notion。
2. 進入“設置” > “安全” > “生成 API 密鑰”。
3. 複製生成的 API 密鑰。

第二步：安裝 Node.js

1. 下載並安裝 Node.js（包括 npm）。
   • 訪問Node.js 官方頁面下載適合您操作系統的版本。
2. 安裝完成後，打開終端或命令提示符，輸入以下命令驗證：

   node -v
   npm -v
   

   如果顯示版本號，則安裝成功。

第三步：克隆 Notion MCP 服務器倉庫

1. 打開終端或命令提示符。
2. 運行以下命令克隆倉庫到您的本地機器：

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

3. 切換到克隆後的目錄：

   cd notion-mcp
   

第四步：安裝依賴項

1. 運行以下命令安裝項目所需的依賴項：

   npm install
   

第五步：配置服務器

1. 在項目根目錄中創建一個.env文件。
2. 添加以下內容到.env文件，替換佔位符為您的實際值：

   NOTION_API_KEY=your_notion_api_key_here
   

3. 保存並關閉文件。

第六步：啟動服務器

1. 在終端或命令提示符中運行以下命令啟動服務器：

   npm start
   

2. 如果一切正常，您將在控制檯看到類似以下的輸出：

   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：在整個工作區中搜索內容

故障排除

常見問題：

1. “連接失敗”在 Claude 中出現：

   • 檢查claude_desktop_config.json文件中的服務器路徑是否正確。
   • 確保您的 Notion API 密鑰有效。
   • 確認 Node.js 已安裝。

2. “訪問被拒絕”當訪問 Notion 內容時：

   • 確保您已共享頁面/數據庫與您的集成
   • 檢查 API 密鑰是否具有必要的權限。

3. 服務器無法啟動：

   • 確保所有依賴項已安裝（npm install）。
   • 檢查.env文件是否存在且包含有效的 API 密鑰。

獲取幫助

如果您遇到未在此處列出的問題，請：

• 查看控制檯輸出中的錯誤消息
• 確保您的 Notion API 密鑰有效
• 驗證您的集成是否具有訪問頁面/數據庫的權限

📄 許可證

本項目採用 MIT 許可證。