iT邦幫忙

2025 iThome 鐵人賽

DAY 2
1

想必各位都知道我們要做一個東西要做得好,重點是什麼?就是要先有好的概念且對這個AI助手有一定的認識,今天我們要做的不是別的事情,不外乎就是要來介紹各元件是如何協作的,且會介紹一些我們會用到的一些術語,讓你可以講出去讓別人覺得你很有料 ( 就是這麼膚淺 )。


什麼是 API 與 MCP?

1. API (Application Programming Interface) - 應用程式的「點餐櫃檯」

你可以把 API 想像成一家餐廳的點餐櫃檯或服務生

  • 你(USER)不會直接衝進廚房自己做菜。( 對吧 ! 對…吧 ? )
  • 你會走到櫃檯(API),看著菜單(API 文件),告訴店員(API)你要一份「鮪魚蛋餅,加好事多胡椒鹽」(請求)。
  • 店員會把你的需求,用廚房聽得懂的方式下單。
  • 最後,廚房(應用程式本身,如 Notion 或 Claude)把做好的餐點交給店員,再由店員送到你手上(回應)。
    我們可以看網路上一個很常見的一個示意圖,簡單來說,API 就是兩個不同軟體之間溝通的橋樑和規則。 它讓我們的程式可以用一種標準化的方式,去「請求」另一個程式為我們服務,而不需要知道它內部複雜的運作細節。
    https://ithelp.ithome.com.tw/upload/images/20250916/20178023N733lekhIG.png
    而我們要使用 API 就必須要擁有相對應的API key,所以後面會交各位如何取得自己需要的API key。
    我自己有在網路上看到這張圖供參。
    https://ithelp.ithome.com.tw/upload/images/20250916/20178023LNH1sGZ6x8.png

2. MCP (Master Control Program) - 我們系統的「大腦中樞」

MCP 指的是一個主控系統。在我們的專案中,它不是一個現成的工具,而是我們賦予 Python 後端腳本 的一個角色
如果說 API 是「服務生」,那麼 MCP 就是那位運籌帷幄的「餐廳經理」
它的職責不是親自做菜或端盤子,而是指揮調度

  • 接收客人(USER)的需求。
  • 判斷這個需求需要哪些食材(例如,需要先問問 Claude 顧問的意見)。
  • 指揮服務生(API 呼叫)去跟廚房(Notion、Claude)溝通。
  • 將拿回來的結果組合、加工,最終完成客人的訂單。
    總結來說,MCP 才是賦予我們專案「智慧」的關鍵。講簡單一點就是MCP 會幫我們挑選工具,且它讓一群各自獨立的 API,能夠為了一個共同的目標(使用者的需求)而協同工作,最終完成一個複雜的任務。
    https://ithelp.ithome.com.tw/upload/images/20250916/20178023SmSSABNi29.png

結語

今天我們把這兩個的名詞 —— API  和 MCP 的概念釐清清楚了。

你可能會覺得今天都在講觀念有點枯燥,但相信我這絕對是必要的打底。少了這兩個概念,我在介紹的時候你們將會ㄇㄨˉ撒撒。

現在,我們的腦中已經有了概念。明天我將會介紹我們 AI 助理的系統架構

你會清楚地看到,經理 (MCP) 是如何指揮每一位服務生 (API),讓整個系統流暢地運作起來。你會發現今天學到的所有概念,都會讓你在理解架構的時候幫上不少的忙。請各位不要急,慢慢來比較快。

那我們明天見!


上一篇
Day 1 | 實戰簡介,你需要的都在這 !
下一篇
Day 3 | Notion × AI agent 整體系統架構
系列文
生成式AI 與 Notion 的碰撞 ?! 你還在 ctrl+c ctrl+v ?5
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言