Day 28:API 是「講話的窗口」,MCP 是「AI 專用的統一插座」——新手不用怕
用點餐比喻搞懂兩者差在哪、長什麼樣子、什麼時候該做、Vibe Coding 怎麼上手
API 是「兩個系統講話的窗口」——你的網頁跟後端資料庫講話、你的 App 跟 LINE 講話, 都是透過 API。MCP 是「AI 助手專用的統一插座」——讓 AI(像 Claude)不用為每個工具 各學一套規矩,插上同一種插座就能用。
先講結論
API 是「兩個系統講話的窗口」——你的網頁跟後端資料庫講話、你的 App 跟 LINE 講話, 都是透過 API。MCP 是「AI 助手專用的統一插座」——讓 AI(像 Claude)不用為每個工具 各學一套規矩,插上同一種插座就能用。
一句話記法:API 讓「程式」跟「程式」講話;MCP 讓「AI」跟「工具」講話。 什麼是 API?先用點餐比喻
想像你在餐廳吃飯: 你(App/網頁)不會自己衝進廚房煮菜 你看菜單(API 文件),知道可以點「牛肉麵」「不要蔥」 你跟服務生(API)說要點什麼 服務生把單子拿去廚房(後端資料庫/邏輯),端菜出來給你
API(Application Programming Interface)就是那個服務生——它負責「接單」跟「上菜」, 你不需要知道廚房裡怎麼運作,只要照著菜單的規矩點餐,就拿得到你要的東西。 具體長什麼樣子(外形)
一支 API 通常長這樣,三個部分缺一不可: 一個網址(endpoint):GET https://carebit.me/v1/company/cmc01/modules 一種打法(method):GET(我要拿資料)/POST(我要新增一筆)/PATCH(我要改一筆) 傳進去、拿出來的資料:通常是一包 JSON,長這樣:
就這樣。API 的「外形」不是什麼神秘的東西,就是「一個網址 + 一種打法 + 一包資料」。 用途
讓原本不認識的兩個系統可以互相交換資料: 你的網頁前端 ↔ 後端資料庫 你的 App ↔ LINE、Google 日曆、金流公司 你的公司系統 ↔ 另一家公司的系統
沒有 API,每個系統就是一座孤島,什麼都要人工複製貼上。 什麼是 MCP?「AI 專用」的統一插座
問題來了:世界上有成千上萬支 API,Gmail 一種寫法、Notion 一種寫法、Google Drive 又一種。 如果 AI 助手要學會操作每一個,就要為每一個都寫一套「怎麼跟它講話」的程式——很累, 而且每家公司的 API 規矩都不一樣。
MCP(Model Context Protocol)就是為了解決這個問題訂出來的一套「統一規格」。
比喻:如果 API 是「每家餐廳自己的菜單格式都不一樣」(有的用點餐機、有的服務生手寫、 有的要打電話),MCP 就是規定「所有餐廳都要用同一種點餐 App」——AI 學會用這個 App 一次, 就能點任何一家餐廳的菜,不用每家重學。 具體長什麼樣子(外形)
一個 MCP server(通常是一支小程式,可以自己寫也可以裝別人寫好的), 對外開放幾個「工具」(tool),每個工具長這樣:
AI 助手(像 Claude Code)連上這支 MCP server,看到「喔,有一個叫 searchfiles 的工具」, 就知道可以直接呼叫它,不用你自己先去 Google Drive 搜好再貼給 AI 看。
MCP server 內部通常還是在打真正的 API——它是一層「翻譯」,把「原本亂七八糟的各家 API 規矩」翻譯成「AI 看得懂的統一格式」。所以 MCP 不是取代 API,是建在 API 上面的一層。 用途
讓 AI 助手可以直接操作外部工具跟資料,而不是每次都要你自己複製貼上: 幫你查 Gmail、讀 Google Drive 檔案、寫 Notion 幫你操作公司內部系統(前提是你自己包一支 MCP server 接上去) 什麼時候需要 API?什麼時候需要 MCP?
情境 需要什麼 --- --- 網頁前端要跟後端資料庫拿資料 API App 要串 LINE 登入、金流、地圖 API 兩家公司系統要互相交換訂單資料 API 想讓 Claude / ChatGPT 直接讀你公司的資料庫回答問題 MCP(包在你的 API 外面) 想讓 AI 助手直接幫你操作 Notion、Gmail、Slack MCP(通常別人已經做好了,直接裝) 只是想讓 AI 讀一份文件回答問題 都不需要,直接貼上去問就好
判準很簡單:只是「人」要用,做 API 就好;想讓「AI」自己動手操作,才需要多包一層 MCP。 Vibe Coding 新手怎麼打造自己的 API 跟 MCP
好消息:你不需要先變成資深工程師。Vibe Coding 的精神是——你負責講清楚「我要什麼」, AI 負責把架構搭出來,你負責判斷「這樣對不對、安全不安全」。 打造一支 API,三句話就能開始
跟 AI(Claude Code)說清楚這三件事,它就能幫你把 API 生出來: 誰要用這支 API:「我的網頁要查某個員工今天有沒有預約健身房」 要傳什麼進去:「員工工號」 要拿什麼出來:「有沒有預約、時段是幾點」
AI 會幫你選好框架(通常是 Node.js + Express)、寫好路由、接上資料庫。你要做的事是: 測試它、確認資料傳回來是對的、確認別人(沒登入的人)不能亂查別人的資料(這是最常被 忽略但最重要的一步——很多資安事故都是「API 做出來了,但忘記檢查是不是本人在查」)。 打造一支 MCP,比 API 多一層「翻譯」
如果你已經有一支 API,想讓 AI 助手能直接操作它,最快的路是:
跟 Claude Code 說:「幫我把這支 API 包成一個 MCP server,開放兩個工具: 一個查資料、一個新增資料。」
AI 會幫你把 API 包上 MCP 的規格外殼,讓任何裝了這個 MCP server 的 AI 助手都能用。 新手不用自己去啃 MCP 的技術規格書——先讓 AI 幫你搭出第一版,你再看懂它做了什麼, 這本身就是最快的學習路徑。 一個提醒
不管是 API 還是 MCP,只要它會改資料(新增/修改/刪除),就一定要有「這是誰在操作、 他有沒有權限」的檢查。這不是進階功能,是從第一版就要有的東西——AI 幫你把功能生出來 很快,但「這樣安全嗎」永遠是你自己要盯的部分。 本篇由 claude-code(claude-sonnet-5) 於開發過程中產生。 repo:RedBallFlow @ 2dadd0de 標籤:api mcp vibe-coding beginner claude-code