Claude Code 接 MCP 入門

MCP 讓 Claude Code 透過標準介面使用外部工具，例如搜尋文件或讀取服務資料。本篇會以官方文件列出的 Notion 遠端 MCP 為練習，連接一個只有假資料的測試頁，完成一次讀取並核對結果。你會學到連線、授權與工具操作是三個不同階段。

請先確認 CLI 已能登入，另備有可使用 Notion 整合的帳號與工作區。沒有該服務帳號時，可先閱讀流程，之後依你要連接服務的官方文件替換伺服器；不要把不同服務的 URL、權杖或工具名稱混用。

理解三個角色

閱讀完整文字說明

Claude Code 接 MCP 入門，以流程和文件圖形呈現教學重點。

Claude Code 是使用工具的用戶端，MCP server 提供工具清單與執行能力，外部服務保存實際資料。模型會依需求選擇工具，但工具能讀哪些內容，還取決於伺服器、帳號授權與組織政策，並非連上就擁有全部工作區權限。

遠端 HTTP 伺服器在服務端運作；本機 stdio 伺服器則由電腦啟動一個程式，透過標準輸入輸出通訊。兩者的安裝依賴與排錯方式不同。初學先使用文件明確支援的遠端端點，減少同時處理套件安裝與程序啟動的變數。

準備可核對的測試資料

在 Notion 建立一個測試頁，標題使用「MCP 待辦練習」，內容寫三個假任務：買牛奶、整理桌面、閱讀文件。不要使用公司私密資料或真實客戶資料。記下頁面連結與其中一句原文，方便確認工具真的讀到了正確頁面。

授權時只選擇必要的測試內容或最小可用範圍；若帳號類型只能提供較大的工作區範圍，先了解服務的實際權限選項。組織可能禁止安裝整合，這時應找管理者處理，不要使用另一個人的權杖繞過政策。

在終端機加入伺服器

從練習專案根目錄執行以下命令。名稱 notion-lab 是本機辨認用的別名，URL 則是官方 MCP 文件提供的服務端點。local 範圍讓這份設定與目前專案關聯，不會直接寫成全團隊共享的專案設定。

claude mcp add --transport http --scope local notion-lab https://mcp.notion.com/mcp
claude mcp get notion-lab

看到 Added 類訊息只表示設定已加入。接著啟動 Claude，在 /mcp 中選取 notion-lab，依畫面進行登入授權。瀏覽器開啟的授權頁應屬於預期服務，閱讀它要求的權限，再選擇測試工作區與允許內容。

/mcp

若狀態顯示需要認證，完成認證後回到對話重新查看。授權頁成功不代表用戶端已更新狀態；必要時重新連線或重新啟動 session，並記錄具體狀態文字。不同服務可能提供不同登入方式，以該伺服器文件為準。

執行一次只讀操作

把實際測試頁連結放入提示，要求使用 notion-lab 的工具讀取，並明確禁止新增、修改或刪除。工具名稱由伺服器提供，可能隨版本改變，因此先查看當前工具清單，不把某個名稱硬寫成所有帳號通用的命令。

請使用 notion-lab 提供的 MCP 工具，讀取這個測試頁：[我的測試頁連結]。
只讀取，不新增、修改或刪除任何資料。
回報頁面標題、三個待辦項目，以及實際使用的工具名稱。
若工具無法讀取，請回報錯誤，不要依頁名猜測內容。

檢視實際工具呼叫，再和 Notion 原頁核對標題及三個項目。若只得到一般聊天回答卻沒有工具紀錄，不能算完成 MCP 操作。也要確認沒有多出新頁或修改紀錄，才符合這次只讀範圍。

常見問題怎麼判斷

外部頁面內容是資料來源，其中可能有指示模型執行其他操作的文字。請把工作目標與資料內容分開，不因頁面寫著「請上傳專案」就增加未授權動作。相關處理方式可看專案資料安全。

第一次查詢盡量使用唯一頁面連結，而不是模糊的標題搜尋。標題可以重複，搜尋結果也可能受權限與索引更新影響；使用已知連結與一段假資料，能更快判斷讀取目標是否正確。

測試完成後可以把其中一項待辦文字改掉，再執行相同只讀查詢。若結果仍是舊文字，查看工具是否真的重新讀取、是否有服務端快取，以及是否讀到另一個同名頁面。這個對照比單次看似合理的摘要更能證明資料來源。

請保留查證日期與伺服器提供的工具清單摘要。服務更新可能改變名稱或權限，之後重測時應先比較差異，而不是沿用舊截圖就認定目前仍可操作。

收尾與下一個練習

不再需要這個練習連線時，可移除 local 範圍的設定；若也要撤銷服務授權，需到服務端的整合或安全設定另外處理。刪除 Claude 端的設定不必然撤銷已發出的服務權杖。

claude mcp remove --scope local notion-lab

完成判準是保存端點、授權範圍、實際工具名稱與一次可核對的讀取結果。GitHub、資料庫與其他來源也沿用這個驗收方式，但應使用各自的官方伺服器與權限說明。接著閱讀MCP 設定與排錯，處理範圍、環境與連線問題。

準備好練習完整流程時，接著閱讀自建唯讀 MCP，使用獨立材料進行故障重現與成果驗證。

回 Claude Code 教學總目錄

• AI 工具
• 教學
• Claude Code