Claude Code 教學/第 6 篇・共 8 篇

MCP——幫 Claude Code 接上你的工具

你有沒有叫過 Claude Code 幫你「上網查一下」「讀這個 Notion」，結果它做不到？不是它笨，是它手上沒有那個工具。這篇教你用 MCP 幫它接上外部工具，最後親手讓它爬到一篇文章。

上一篇我們用 Skill 教 Claude Code「怎麼把一件事做好」。但你很快會遇到另一種牆：有些事它不是不會做，是手邊根本沒有那個工具。你叫它「上網幫我查一下這頁寫什麼」，它可能回你「我沒辦法直接連網頁」；你叫它「讀我的 Notion」，它也碰不到。這一篇就是來拆這道牆的——而且做完，你會親手讓它爬到一篇文章。

一、先看它撞牆

台灣的柚智夫妻與雷蒙那支教學裡有個很好的示範：他想叫 Claude Code 去抓一個網頁上的內容，結果卡住——Claude Code 預設能讀你電腦裡的檔案、能執行指令，但它沒有內建「瀏覽網頁」這件事。就像一個很強的助理坐在你旁邊，但他手上沒有瀏覽器，你叫他查網頁，他只能兩手一攤。

解法不是換一個更強的 AI，而是幫它接上工具。這就是 MCP 在做的事。

二、MCP 是什麼——別被「它只是包了個 API」誤導

先給你官方的講法（我去查了 Claude Code 官方文件，2026 年 7 月）：

MCP（Model Context Protocol，模型情境協議）是一套開放標準，用來把 AI 和各種工具接起來。接上 MCP server 之後，Claude Code 就能存取你的工具、資料庫和 API。

中文圈流傳一種說法是「MCP 就是把 API 包一層」，這個講法會誤導你。MCP 不是某個 API 的包裝，它是一套共通語言。 打個好懂的比方：MCP 像 USB 插座。以前每種裝置都有自己的接頭，你得為每個工具寫一套對接；有了 USB 這個統一規格，任何裝置插上就能用。MCP 就是 AI 世界的 USB——它讓 AI 用同一套方式去「知道某個工具能做什麼、該怎麼呼叫它」，不管那個工具是網頁瀏覽器、Notion、資料庫還是你公司的內部系統。

「協議（protocol）」就是一份大家講好的規格。像郵局規定信封上地址怎麼寫，寄件、收件雙方照著做就能通。MCP 規定 AI 和工具之間怎麼互相介紹、怎麼呼叫，於是任何照這規格做出來的工具，Claude Code 都接得上。

所以你要做的事，白話講就是一句：幫 Claude Code 插上它需要的那個「工具插座」。

三、動手做：裝一個會讀網頁的 MCP，讓它爬到一篇文章

我們就從最有感的開始——讓它能讀網頁。這一節做完，你會得到一個可驗證的小成果：Claude Code 幫你抓回一篇網頁文章的內容。

會讀網頁的 MCP server 有好幾個（例如 Playwright、Firecrawl），它們各自的官網都會給你一行「安裝指令」。加一個 MCP 的官方指令長這樣：

claude mcp add --transport http <你取的名字> <server 網址>

如果是要在你電腦本機跑的那種（例如 Playwright 用瀏覽器實際開頁面），指令是這個形式——-- 後面接的是實際要跑的程式：

claude mcp add <你取的名字> -- <啟動這個 server 的指令>

你不需要背這些。 這正是前幾篇那個心法的用處：不會就直接問它。你可以打開 Claude Code，直接說「我想讓你可以讀網頁，幫我裝一個能爬網頁的 MCP，一步步帶我」，它會告訴你該貼哪一行、去哪裡申請、卡住怎麼辦。

裝的時候卡住，很正常

雷蒙在影片裡示範時就當場卡了兩關，這兩關新手都會遇到，先讓你有心理準備：

  1. 少了 Node.js：有些 MCP server 要靠 Node 才能跑，你電腦沒裝就會報錯。解法不用你查——把錯誤訊息貼回去給 Claude Code，它會說「你需要先裝 Node」，甚至直接幫你跑 brew install node。
  2. 要申請 API Key：有些服務（例如 Firecrawl）要你去它官網註冊、拿一把 key 貼進設定，它才肯幫你做事。好消息是這類服務通常有免費額度（Firecrawl 當時是每月 500 頁免費），夠你學。申請流程也可以讓 Claude Code 帶你走。

驗證它真的接上了

裝完，在 Claude Code 裡打：

/mcp

這會列出你接上的 MCP server、狀態、以及它提供了哪些工具。如果那個 server 需要登入授權（例如用你的帳號），/mcp 這裡也會帶你走一次 OAuth（跳出瀏覽器讓你按同意）。看到它顯示「已連線」，就成了。

接著就是驗收的一刻——叫它做剛剛做不到的事：「幫我讀 <某個網址>，把重點整理給我。」這次它會真的抓回內容。這就是你的小成果：同一句話，接工具前它做不到，接工具後它做到了。

四、再接一個：Notion MCP

會了一個，其他都同一個套路。PAPAYA 的教學裡示範接 Notion——這樣你就能叫 Claude Code 直接讀寫你的 Notion 筆記。Notion 是「遠端」型的 server，官方文件給的指令是：

claude mcp add --transport http notion https://mcp.notion.com/mcp

裝完一樣打 /mcp，它會跳出 Notion 的授權頁要你登入同意（OAuth），按完就接上了。之後你就能說「把這份會議記錄整理成 Notion 頁面」。

「遠端 server」跟「本機 server」的差別：遠端的（像 Notion）跑在對方的雲端，你用網址接、通常要登入授權；本機的（像 Playwright）跑在你自己電腦上，適合需要直接動用你系統的工具。你不用記這個分類，官方頁面會告訴你該用哪種指令，照貼就好。

五、想讓全家／全隊共用：.mcp.json

你接的 MCP，設定會被記住，下次開一樣在。如果你是在某個專案資料夾裡想讓「打開這個專案的人都自動有這些工具」，可以把設定放進專案根目錄的一個檔案 .mcp.json，跟著專案一起分享出去，別人打開就有（第一次會問他要不要信任、同意才啟用）。這就是官方說的「scope（範圍）」——你可以選這個設定只給自己（user）、只給這個專案（project），或只在當下這台機器（local）。

一般人自己用，裝完能動就好，這段先知道「設定會留著、而且能分享」即可，需要時再細研究。

六、API、CLI、MCP，到底差在哪？

你查資料時會一直看到這三個詞，這裡用最白話一次講清楚，免得你把它們搞混：

  • API：一個服務對外開放的「呼叫窗口」，本來是寫給程式用的。你要自己寫程式碼、帶上金鑰去呼叫。
  • CLI：某個工具的「終端機指令版」，例如很多服務有自己的命令列程式。Claude Code 可以直接幫你在終端機下這些指令。
  • MCP：讓 AI 能「聽懂並使用」工具的那套共通協議。它的重點不是取代 API，而是替 AI 把「這個工具能做什麼、怎麼用」翻譯成 AI 看得懂的樣子，於是 Claude Code 不用你寫程式，就能自己去操作那個工具。

一句話記法：API 是給程式用的窗口、CLI 是給人在終端機下的指令、MCP 是給 AI 用的工具插座。你身為使用者，多數時候只要會「用 MCP 幫 Claude 接上工具」這一件事就夠了。

七、誠實的一節：接工具之前，先想兩件事

MCP 很強，但正因為它讓 AI 能對外面的系統「動手」，有兩條線要守住：

  1. 別亂接來路不明的 MCP server。 你接一個 server，等於讓它有機會對你的資料或系統做事。跟上一篇裝 Skill 一樣的原則：只接官方目錄、或你信得過的來源；看不懂的、隨便一個網站叫你貼的指令，先別貼。
  2. 爬別人的網站、抓別人的內容，有界線。 能技術上做到，不代表可以隨便做。抓公開資訊參考、自用是一回事；大量爬取、繞過付費牆、或把別人的內容拿去散布，可能踩到對方的服務條款甚至法律。動手前想一下「這個網站允許我這樣抓嗎」。

守住這兩條，MCP 會是你把 Claude Code 從「會寫字的助理」變成「能真的幫你辦事的助理」的關鍵一步。

下一篇是這個系列的完結篇：我們把前面學的全部串起來，從一個生活裡的點子，一路做出一個你自己的、真的能跑的小工具。

本文參考素材

回教學列表