Ramidecodes MCP Server Notion

🚀 Notion MCP 服務器

Notion MCP 服務器是一個提供官方 Notion SDK 的模型上下文協議（MCP）服務器，它允許 AI 模型與 Notion 工作區進行交互，為 AI 與 Notion 的結合提供了便利。

🚀 快速開始

🔧 設置你的 Notion 集成

1. 訪問 https://www.notion.so/my-integrations。
2. 創建一個新的集成。
3. 複製 API 密鑰。

🔗 將你的 Notion 頁面連接到集成

為了讓您的集成訪問 Notion 內容，您需要顯式地共享您的頁面或數據庫：

1. 導航到您要通過集成訪問的 Notion 頁面或數據庫。
2. 點擊右上角的“共享”按鈕。
3. 在“添加人員、組或集成”字段中，從下拉列表中選擇您的集成。
4. 點擊“邀請”。
5. 對每個頁面或數據庫重複上述操作。

⚠️ 重要提示

集成僅能訪問顯式共享給它的頁面和數據庫。父頁面不會自動授予對子頁面的訪問權限。

🤖 添加到你的 AI 助手

你可以將此 MCP 服務器添加到 Claude Desktop、Cursor AI 或 Claude.ai，使用以下配置格式之一：

命令行格式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON 配置格式

{
  "name": "Notion",
  "command": {
    "args": [
      "@ramidecodes/mcp-server-notion@latest",
      "-y",
      "--api-key=your-notion-integration-key"
    ],
    "env": {},
    "executable": "npx"
  }
}

請將 your-notion-integration-key 替換為步驟1中的 API 密鑰。

🛠️ 設置說明

• Claude Desktop：設置 > 高級 > 模型上下文協議
• Cursor AI：設置 > AI > MCP 服務器
• Claude.ai：文檔中提到的相應配置方法

✨ 主要特性

以下是服務器提供的主要功能：

1. 🔍 搜索：允許 AI 模型查詢 Notion 內容。
2. 📊 數據庫操作：支持 CRUD 操作（創建、讀取、更新、刪除）在 Notion 數據庫中。
3. 📄 頁面管理：包括創建、編輯和刪除頁面的功能。
4. 🧱 塊處理：處理 Notion 頁面中的各種內容塊，如文本、圖像等。

🚧 故障排除

常見問題

1. API 錯誤：檢查 API 密鑰是否正確配置，並確保您的集成有適當的權限。
2. 連接問題：確保你的網絡連接正常，並且 Notion 服務可用。
3. 錯誤信息：查看詳細的錯誤消息以獲取更多調試信息。

解決方法

1. 🔑 重新生成密鑰：如果遇到身份驗證問題，可以嘗試重新生成 API 密鑰。
2. 🔒 檢查權限：確保您的集成具有訪問所需資源的適當權限。
3. 📦 更新依賴項：確保所有相關依賴項已更新到最新版本。

📄 許可證

此項目在 Apache License 2.0 下許可 - 有關詳細信息，請參閱 LICENSE 文件。