Content is user-generated and unverified.

Claude Desktop + MCP + Notion API 完整設定指南

為完全沒有程式背景的Windows用戶提供詳細的逐步指南，讓您能成功設定Claude Desktop的MCP功能連接到Notion API。

第一部分：準備工作和軟體安裝

準備清單

在開始之前，請確保您具備：

  • Windows 10或11系統（Windows 7也可使用但不推薦）
  • 穩定的網路連接
  • 管理員權限（用於安裝軟體）
  • Notion帳戶和工作區
  • 至少30分鐘的時間完成整個設定過程

步驟1：下載並安裝Claude Desktop

1.1 下載Claude Desktop

  1. 開啟瀏覽器，前往 claude.ai/download
  2. 點擊「Download for Windows」按鈕下載 Claude-Setup.exe
  3. 截圖建議：顯示下載頁面，突出顯示Windows下載按鈕

1.2 安裝Claude Desktop

  1. 找到下載的 Claude-Setup.exe 檔案（通常在下載資料夾）
  2. 右鍵點擊檔案，選擇「以系統管理員身分執行」
  3. 依照安裝精靈的指示完成安裝
  4. 安裝完成後，使用您的Anthropic帳戶登入
  5. 截圖建議：安裝精靈截圖和登入畫面

步驟2：安裝Node.js（MCP功能必需）

2.1 為什麼需要Node.js MCP功能需要Node.js來運行各種伺服器，這是連接到Notion API的關鍵組件。

2.2 安裝Node.js

  1. 前往 nodejs.org
  2. 下載「LTS」版本（長期支援版本，更穩定）
  3. 執行下載的安裝程式
  4. 安裝時保持所有預設設定
  5. 安裝完成後重新啟動電腦

2.3 驗證安裝

  1. 按 Windows鍵 + R 開啟執行對話框
  2. 輸入 cmd 並按Enter開啟命令提示字元
  3. 輸入 node --version 並按Enter
  4. 應該顯示版本號碼（例如：v20.11.0）
  5. 輸入 npm --version 確認npm也已安裝
  6. 截圖建議：命令提示字元顯示版本資訊

第二部分：Notion API設定

步驟3：創建Notion Integration

3.1 前往Notion開發者控制台

  1. 開啟瀏覽器，前往 www.notion.so/my-integrations
  2. 確保您已登入正確的Notion帳戶
  3. 在右上角確認您選擇了正確的工作區
  4. 截圖建議：整個「My integrations」控制台頁面

3.2 創建新的Integration

  1. 點擊「+ New integration」按鈕
  2. 填寫Integration資訊：
    • Name：輸入描述性名稱（如「Claude MCP Assistant」）
    • Logo：選擇上傳圖片（可選）
    • Associated workspace：選擇您的工作區
  3. 點擊「Submit」建立Integration
  4. 截圖建議：Integration創建表單，顯示所有欄位

步驟4：配置Integration權限

4.1 設定基本權限 成功創建Integration後，您會被重新導向到設定頁面：

  1. 點擊「Capabilities」標籤
  2. 為MCP使用案例選擇以下權限：
    • ✅ Read content - 讀取頁面和資料庫內容
    • ✅ Update content - 修改現有頁面和資料庫
    • ✅ Insert content - 創建新頁面和資料庫條目
    • ✅ Read user information without email addresses - 基本用戶資訊
  3. 點擊「Save changes」儲存設定
  4. 截圖建議：Capabilities設定頁面，顯示已選擇的權限

4.2 獲取API Token

  1. 點擊「Secrets」標籤
  2. 複製顯示的「Internal Integration Token」
  3. 重要：這個token以「secret_」開頭，請完整複製
  4. 將token暫時儲存在安全的地方（稍後會用到）
  5. 截圖建議：Secrets頁面（將token部分模糊處理）

步驟5：將Integration連接到Notion頁面

5.1 為什麼需要這個步驟 即使創建了Integration，它仍無法存取任何頁面，直到您明確授予權限。這是最容易被忽略但最關鍵的步驟。

5.2 連接頁面或資料庫

  1. 在Notion中開啟您想要連接的頁面或資料庫
  2. 點擊頁面右上角的「•••」（三個點）選單
  3. 向下滾動找到「Add connections」選項
  4. 點擊「Add connections」
  5. 搜尋您剛創建的Integration名稱
  6. 選擇您的Integration並點擊「Invite」
  7. 確認權限對話框中點擊「Allow access」
  8. 截圖建議：三個點選單、連接搜尋介面、權限確認對話框

重要提醒：您需要為每個想要通過MCP存取的頁面或資料庫重複此步驟。

第三部分：Windows系統準備

步驟6：顯示檔案副檔名

6.1 為什麼需要顯示副檔名 這有助於識別JSON檔案並避免安全風險。

6.2 Windows 11設定方法

  1. 開啟「設定」（Windows鍵 + I）
  2. 前往「系統」→「開發人員選項」
  3. 在「檔案總管」區段中
  4. 開啟「顯示檔案副檔名」開關
  5. 截圖建議：Windows 11設定頁面

6.3 Windows 10設定方法

  1. 開啟檔案總管
  2. 點擊「檢視」標籤
  3. 勾選「檔案名稱副檔名」核取方塊
  4. 截圖建議：檔案總管檢視選項

步驟7：使用Windows記事本編輯配置檔案

為什麼選擇記事本？

對於完全沒有程式背景的用戶，Windows記事本是最佳選擇：

  • 零學習成本 - 每個人都會用記事本
  • 無需額外安裝 - Windows內建工具
  • 操作簡單 - 就像編輯普通文字檔案
  • 完全夠用 - 我們只需要複製貼上，不需要複雜功能

7.1 確保檔案正確開啟

由於我們要編輯.json檔案，需要確保用記事本開啟：

  1. 右鍵點擊 claude_desktop_config.json 檔案
  2. 選擇「開啟檔案」
  3. 如果有多個選項，選擇「記事本」
  4. 如果記事本不在清單中，點擊「選擇其他應用程式」
  5. 滾動找到「記事本」並選擇

7.2 安全編輯原則

雖然使用記事本，但遵循這些簡單原則能避免錯誤：

  • 完全選取舊內容後再貼上 - 避免留下舊的內容片段
  • 貼上後立即儲存 - 按 Ctrl + S 確保變更生效
  • 不要手動修改 - 只貼上我們提供的完整代碼

第四部分：創建和編輯配置檔案

步驟8：找到Claude Desktop配置檔案

8.1 檔案位置 Claude Desktop的配置檔案位於： %APPDATA%\Claude\claude_desktop_config.json

8.2 開啟配置檔案

  1. 按 Windows鍵 + R 開啟執行對話框
  2. 輸入 %APPDATA%\Claude 並按Enter
  3. 如果您看到 claude_desktop_config.json 檔案，請繼續到步驟9
  4. 如果沒有看到檔案，您需要創建一個新檔案

8.3 創建新的配置檔案（如果不存在）

  1. 在Claude資料夾中右鍵點擊空白區域
  2. 選擇「新增」→「文字檔案」
  3. 將檔案命名為 claude_desktop_config.json
  4. 確保副檔名是 .json 而不是 .txt

步驟9：備份原始檔案

9.1 為什麼要備份 在修改任何配置檔案之前，創建備份可以讓您在出現問題時輕鬆恢復。

9.2 備份步驟

  1. 右鍵點擊 claude_desktop_config.json
  2. 選擇「複製」
  3. 在同一個資料夾中右鍵點擊並選擇「貼上」
  4. 將複製的檔案重新命名為 claude_desktop_config.json.backup

步驟10：使用記事本編輯配置檔案

10.1 開啟檔案進行編輯

  1. 右鍵點擊 claude_desktop_config.json
  2. 選擇「開啟檔案」→「記事本」
  3. 如果記事本不在選單中，選擇「選擇其他應用程式」並找到記事本

10.2 安全的複製貼上步驟

重要：按照以下順序操作，避免格式錯誤

  1. 完全清空檔案內容
    • 按 Ctrl + A 選取全部內容
    • 按 Delete 鍵刪除所有內容
    • 確保檔案完全空白
  2. 複製正確的配置代碼 將以下內容完整複製（包含所有大括號和引號）：
json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@makenotion/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "在這裡貼上您的Notion API token"
      }
    }
  }
}
  1. 貼上到記事本
    • 確保游標在檔案開頭（空白檔案的左上角）
    • 按 Ctrl + V 貼上
    • 檢查內容是否完整貼上

10.3 插入您的Notion Token

  1. 找到 "NOTION_TOKEN": "在這裡貼上您的Notion API token"
  2. 只替換 在這裡貼上您的Notion API token 這段文字
  3. 保留雙引號，最終應該看起來像： "NOTION_TOKEN": "secret_abc123def456..."

10.4 儲存檔案

  1. 按 Ctrl + S 儲存檔案
  2. 確保檔案名稱仍然是 claude_desktop_config.json
  3. 如果Windows詢問檔案格式，選擇「純文字檔案」

10.5 安全檢查清單 在繼續之前，確認：

  • 檔案以 { 開頭，以 } 結尾
  • 您的Notion token已正確插入並保留雙引號
  • 檔案已儲存（標題列沒有星號*）
  • 檔案名稱是 claude_desktop_config.json

第五部分：驗證和測試

步驟11：重新啟動Claude Desktop

11.1 完全關閉並重新開啟

  1. 完全關閉Claude Desktop（不只是最小化）
  2. 等待5秒鐘
  3. 重新開啟Claude Desktop
  4. 等待應用程式完全載入

步驟12：檢查MCP連接

12.1 尋找MCP圖標 成功配置後，您應該在Claude Desktop的輸入區域看到：

  • 一個小錘子圖標或工具圖標
  • 通常位於輸入框的左下角或右下角

12.2 測試可用工具

  1. 點擊MCP圖標
  2. 您應該看到「notion」伺服器列在可用工具中
  3. 如果看到，恭喜！配置成功了
  4. 截圖建議：顯示MCP圖標和工具清單的界面

步驟13：執行功能測試

13.1 基本連接測試 向Claude提出以下請求來測試連接：

  1. "請幫我搜尋我的Notion工作區中關於專案的頁面"
  2. "請告訴我我的Notion資料庫中有哪些頁面"
  3. "請幫我創建一個新的Notion頁面，標題為'測試頁面'"

13.2 預期結果

  • Claude應該能夠存取您的Notion內容
  • 應該能夠搜尋和檢索頁面
  • 應該能夠創建新頁面（如果您授予了相應權限）

第六部分：常見問題和解決方案

問題1：看不到MCP圖標

可能原因和解決方案：

A. Node.js未正確安裝

  • 開啟命令提示字元，輸入 node --version
  • 如果顯示錯誤，重新安裝Node.js並重新啟動電腦

B. 配置檔案格式錯誤

  • 重新複製完整配置 - 刪除檔案所有內容，重新貼上完整的JSON代碼
  • 檢查常見錯誤：
    • 確認檔案以 { 開頭，以 } 結尾
    • 確認所有的引號都是雙引號 " 而不是單引號 '
    • 確認您的token前後都有雙引號
  • 使用線上驗證工具 - 將您的JSON內容複製到 jsonlint.com 檢查是否有格式錯誤

C. 檔案路徑錯誤

  • 確保配置檔案位於正確位置：%APPDATA%\Claude\claude_desktop_config.json
  • 檢查檔案名稱拼寫是否正確

問題2：MCP圖標出現但無法存取Notion

可能原因和解決方案：

A. Notion Token無效

  • 重新生成Notion Integration token
  • 確保token以 secret_ 開頭
  • 檢查token中沒有多餘的空格或字符

B. 頁面未與Integration共享

  • 這是最常見的問題！
  • 確保您已將想要存取的每個頁面/資料庫與Integration連接
  • 重新檢查步驟5.2的連接過程

C. 權限設定不正確

  • 在Notion Integration設定中檢查Capabilities
  • 確保已啟用必要的讀取/寫入權限

問題3：Windows路徑相關錯誤

症狀： 看到如 'C:\Program' is not recognized 的錯誤

解決方案： 在JSON中使用雙反斜線：

json
"command": "C:\\Program Files\\nodejs\\npx.exe"

問題4：環境變數問題

症狀： Token沒有正確傳遞給MCP伺服器

替代配置方法：

json
{
  "mcpServers": {
    "notion": {
      "command": "cmd.exe",
      "args": [
        "/c", 
        "set NOTION_TOKEN=your_actual_token_here && npx -y @makenotion/notion-mcp-server"
      ]
    }
  }
}

問題5：連接測試失敗

診斷步驟：

  1. 檢查Claude Desktop日誌
    • 在Claude Desktop中啟用開發者模式
    • 檢查日誌中的錯誤訊息
  2. 手動測試Notion API
    • 開啟命令提示字元
    • 執行：
bash
   curl -H "Authorization: Bearer your_token_here" -H "Notion-Version: 2022-06-28" https://api.notion.com/v1/users/me
  1. 測試MCP伺服器
    • 在命令提示字元中執行：
bash
   npx @modelcontextprotocol/inspector npx @makenotion/notion-mcp-server

第七部分：進階設定和維護

多個MCP伺服器配置

如果您想連接其他服務，可以在同一個配置檔案中添加多個伺服器：

json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@makenotion/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "your_notion_token"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\username\\Documents"],
      "env": {}
    }
  }
}

安全最佳實踐

  1. 定期輪換API Token
    • 每3-6個月重新生成Notion API token
    • 立即更新配置檔案中的token
  2. 最小權限原則
    • 只授予Integration必要的權限
    • 只與需要的頁面/資料庫共享
  3. 備份配置
    • 定期備份您的配置檔案
    • 考慮使用雲端同步服務

效能最佳化

  1. 監控使用情況
    • 注意Notion API速率限制（平均每秒3個請求）
    • 避免頻繁的大量資料操作
  2. 保持更新
    • 定期檢查Claude Desktop更新
    • 關注MCP協議的變更

結論

恭喜！您已經成功設定了Claude Desktop的MCP功能，並將其連接到Notion API。這個強大的整合讓您能夠：

  • 直接從Claude Desktop搜尋和存取Notion內容
  • 創建和修改Notion頁面和資料庫
  • 將AI助手的能力擴展到您的知識管理工作流程

成功的關鍵因素：

  1. 正確安裝所有必需軟體（Node.js）
  2. 準確配置Notion Integration和權限
  3. 確保頁面與Integration正確共享
  4. 仔細編輯JSON配置檔案
  5. 系統性地測試和驗證每個步驟

如果遇到問題：

  • 參考本指南的故障排除部分
  • 檢查所有步驟是否正確完成
  • 考慮從備份恢復並重新開始
  • 在相關社群論壇尋求幫助時提供具體的錯誤訊息

這個設定過程可能看起來複雜，但一旦完成，您將擁有一個強大的AI輔助工具，能夠無縫整合您的Notion工作區，大幅提升您的生產力和知識管理效率。

Content is user-generated and unverified.
    Claude Desktop + MCP + Notion API Complete Setup Guide for Windows Users | Claude