~/教學/MCP.md
MCP 是什麼?Claude 是手機、App 是插頭:一行 claude mcp add 接上 DeepWiki,直接問 GitHub 專案
MCP 用白話講:一條通用的線,讓 Claude 接上你的 App。跟 API 差在哪、server 和 client 是哪一頭,再用 Claude Code 一行指令接上免費的 DeepWiki。
在 Instagram 看這支 Reels留言關鍵字 #MCP 就會收到這篇
大家都叫你「裝 MCP」,但很少人講 MCP 到底是什麼。這篇是 Reels 裡 MCP 那支的完整版:先看接好之後能做什麼(我問了一個 GitHub 專案怎麼跑起來,三步答完),再用手機和插頭講清楚 MCP、server 和 client、它跟 API 差在哪,最後一步一步在 Claude Code 接上一個免費、不用登入的 MCP server(DeepWiki),指令都可以直接複製。MCP 和 Claude Code 的部分全部照官方文件,我在 2026 年 11 月 12 日核對過。
01先看結果:多打一行,就能問 GitHub 上任何公開專案

我問的是 GitHub 上的開源白板 excalidraw/excalidraw:「這個專案要怎麼在自己電腦上跑起來?」DeepWiki 讀過整個專案,回了三步:裝好 Node.js、Yarn 和 Git;git clone 再進資料夾;執行 yarn 和 yarn start,開 http://localhost:3000。
讀完這篇你會得到:MCP 的白話解釋(手機、插頭、一條線)、server 和 client 各是哪一頭、它跟 API 差在哪,還有在 Claude Code 接上第一個 MCP server 的完整指令:加上去、檢查有沒有接好、接好之後怎麼問。不想碰終端機,最後也有 Claude App 的做法。
02MCP 是什麼:Claude 是手機,App 是插頭,MCP 是那條通用的線

MCP 是 Model Context Protocol 的縮寫。官方的定義是:一個開源標準,讓 AI 應用程式連上外部的系統,例如你的檔案、資料庫、搜尋工具、行事曆。官方自己的比喻是「AI 的 USB-C 孔」:USB-C 讓各種裝置用同一種接頭,MCP 讓 AI 用同一種方式接上各種工具。
我習慣這樣想:Claude 是手機,你的 App(行事曆、Notion、GitHub、資料庫)是插頭,MCP 是那條通用的線。只要一個 App 做了 MCP 這一頭,Claude 就插得上,然後可以讀它的資料、用它的功能。

- MCP server:App 那一頭。官方定義是「提供 context 給 MCP client 的程式」,可以跑在你自己電腦上(本機),也可以跑在網路上(遠端)。
- MCP client:Claude 這一頭,負責跟一個 server 保持連線、把拿到的東西交給 Claude。
- MCP host:嚴格說,Claude Code、Claude Desktop 這種 AI 應用程式叫 host,它每接一個 server,就開一個 client。影片裡說「Claude 是 client」是簡化的講法。
03MCP 跟 API 差在哪:插座形狀統一成一種

API 是每個 App 自己開的一個「插座」:行事曆一種、筆記一種、信箱又一種,參數、登入方式、回傳格式都不一樣。以前要讓 AI 用三個 App,就得幫它各接一條專用的線。
MCP 把插座統一成同一種形狀:每個 MCP server 都用同一套方式告訴 Claude「我有哪些工具、每個工具要什麼參數」,Claude 學會一次,就能接所有的 server。所以 MCP 不是取代 API:很多 MCP server 背後呼叫的還是那個 App 自己的 API,它是幫 AI 包成同一種接頭。
04在 Claude Code 接一個:DeepWiki(免費、不用登入)
DeepWiki 是 Devin 團隊做的 MCP server,官方文件寫它「免費、遠端、不需要登入」,可以查 GitHub 上的公開專案。拿它當第一個練習最剛好:不用申請 API key,也不會碰到你自己的帳號資料。

- 打開終端機(已經裝好 Claude Code),貼上下面第一段指令。-s user 代表「所有專案都能用」;不加的話預設只在目前這個資料夾有效。
- 跑第二段指令檢查,看到 ✔ Connected 就是接好了。在 Claude Code 裡面也可以打 /mcp 看所有 server 的狀態。
- 打開 Claude Code,直接用中文問,把 [owner/repo] 換成你想查的 GitHub 專案。第一次用到這個工具時,Claude Code 會先問你要不要允許。
claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp
claude mcp list

用 DeepWiki 查 [owner/repo]:這個專案要怎麼在我電腦上跑起來?請用繁體中文,列 3 個步驟。
DeepWiki 有三個工具:read_wiki_structure(列出這個專案的文件目錄)、read_wiki_contents(讀文件內容)和 ask_wiki_question(直接問問題)。你不用記,Claude 會自己挑;想讀某個專案的架構,可以說「先列出 [owner/repo] 的文件目錄」。
05不用終端機:在 Claude App 加連接器

在 Claude 的網頁版和桌面版,MCP 叫「連接器」(Connectors)。常見的 App(Google 日曆、Gmail、Notion、Slack、Figma)在連接器目錄裡點一下就能加,登入那個 App 授權就好。
- 官方目錄裡沒有的,可以加「自訂連接器」:Pro、Max 方案是 Customize → Connectors → + Add → Add custom connector。
- 填一個名字和 MCP server 的網址(遠端的才行,例如 [https://伺服器網址/mcp]),看一下登入設定,按 Add。
- Free 方案只能加一個自訂連接器;Team、Enterprise 要由管理員在 Organization settings → Connectors 加。
06要注意
- 只接你信任的 MCP server。Claude Code 官方文件特別提醒:會去抓外部內容的 server,可能讓你暴露在 prompt injection(藏在網頁或文件裡的惡意指令)的風險下。
- 接上之後,Claude 能用那個 App 能做的事。會改資料、寄信、刪東西的工具,Claude Code 執行前會問你,看清楚再按允許。
- 需要 API key 的 server,key 放在 -e 環境變數或設定檔裡,不要貼進對話、也不要 commit 到 GitHub。
- DeepWiki 只看得到公開的 GitHub 專案,它的回答是 AI 根據專案整理的,也可能有錯,照做之前看一下專案自己的 README。
- 影片和這篇的 DeepWiki 回答,是我用測試小程式直接呼叫 DeepWiki 的 MCP server 拿到的(2026 年 11 月 12 日),不是 Claude Code 聊天視窗的截圖;claude mcp add 和 claude mcp list 是在 Claude Code 2.1.190 真的跑過的。
資料來源
下一支 Reel 想學什麼?
我每天測 Claude 和 AI 工具,把真的有用的做成 Reel。追蹤 @vivianlin.tech,新教學一出來就看得到。