Tratopedia
BM
設定

文字大小

佈景

高對比

中文排版

豎排會把內文排成由右至左的直行,如同台灣的實體書籍。

版本

v1.230.2

本頁建置時的版本編號,也是 service worker 快取所依據的版本。

簡報

返回

REST、SOAP、gRPC、GraphQL 與 MCP:看誰來呼叫

選 API 先看誰來呼叫:外部開發者用 REST,自家服務之間用 gRPC,畫面多的前端用 GraphQL,SOAP 只留給舊系統。MCP 屬於另一類:它把前四者包成 AI 代理可用的工具,2026 年 7 月起核心改為無狀態。

  1. API 指南 · 2026年10月27日

    軟體與軟體溝通的五種方式

    REST、SOAP、gRPC、GraphQL 與 MCP,寫給初學者與專業人士。

    REST · SOAP · gRPC · GraphQL · MCP1 / 15

  2. 基礎

    什麼是 API?

    API 是一個程式向另一個程式要東西、並得到可預期回答的約定方式。想像在餐廳點餐。

    你

    用戶端:想要某樣東西的 App、網站或 AI 代理。

    服務生

    API:菜單與點餐規則。

    廚房

    伺服器:保存資料、實際做事的系統。

    REST · SOAP · gRPC · GraphQL · MCP2 / 15

  3. 基礎

    五者一覽

    名稱是什麼可以想成
    REST網址加上標準動作圖書館目錄
    SOAP附嚴格契約的正式 XML 訊息掛號信
    gRPC服務之間快速的二進位呼叫同事之間的專線
    GraphQL單一端點,只要你需要的欄位客製化訂單
    MCP讓 AI 代理使用工具與資料的標準插頭萬用轉接頭

    REST · SOAP · gRPC · GraphQL · MCP3 / 15

  4. 五者 · 第 1 之 5

    REST:放在網址上的資源

    最適合:公開 Web API、網站與行動 App。

    步驟範例
    請求GET /orders/42
    回應200 OK,附上 JSON 格式的訂單
    • 一切都是資源,各有自己的網址,例如訂單、使用者或照片。
    • 標準動詞:GET 讀取、POST 建立、PUT 或 PATCH 更新、DELETE 刪除。
    • 容易快取:瀏覽器與 CDN 可以儲存 GET 的結果。

    REST · SOAP · gRPC · GraphQL · MCP4 / 15

  5. 五者 · 第 2 之 5

    SOAP:正式的信封

    最適合:串接既有的銀行、保險與政府系統。新的 API 不要用。

    部分內容
    Envelope(XML)整則訊息
    Header安全、路由與其他附加資訊
    Body實際的請求或回覆
    • 嚴格契約:WSDL 檔與 XML schema 描述每一則訊息。
    • 訊息層級安全:WS-Security 可以對訊息本身簽章與加密。
    • 笨重:XML 冗長,速度慢,在行動裝置上也不好用。

    REST · SOAP · gRPC · GraphQL · MCP5 / 15

  6. 五者 · 第 3 之 5

    gRPC:服務之間的快速呼叫

    最適合:內部微服務、低延遲與即時串流。

    在 .proto 契約中
    rpc GetOrder(OrderId) returns (Order);
    • 契約優先:一份 .proto 檔就能產生多種語言的用戶端與伺服器程式碼。
    • 精簡快速:透過 HTTP/2 傳送二進位訊息,有四種串流模式。
    • 瀏覽器限制:網頁需要 gRPC-Web 或 JSON 閘道。

    REST · SOAP · gRPC · GraphQL · MCP6 / 15

  7. 五者 · 第 4 之 5

    GraphQL:只要你需要的

    最適合:畫面眾多、或多個用戶端共用同一份資料圖的 App。

    一次查詢,一個端點
    查詢 order(id: 42),只取其中的 status 與每個品項的 name
    • 由用戶端挑選欄位,不會擷取過多,往返次數也較少。
    • 強型別 schema,工具可以自動探索與檢查。
    • 需要多加留意:快取要額外處理,伺服器需要深度與成本限制。

    REST · SOAP · gRPC · GraphQL · MCP7 / 15

  8. 五者 · 第 5 之 5

    MCP:AI 代理的標準插頭

    建一個 MCP 伺服器,任何相容的 AI 應用都能使用,不必為每個產品各寫一個連接器。

    Tools(工具)

    AI 可以執行的動作,例如建立工單。

    Resources(資源)

    應用程式可讀取的資料,例如檔案或一筆紀錄。

    Prompts(提示範本)

    使用者可以選用的現成範本。

    • 以 JSON-RPC 2.0 運作,走 stdio(本機)或 Streamable HTTP(遠端)。

    REST · SOAP · gRPC · GraphQL · MCP8 / 15

  9. 如何搭配

    MCP 疊在其他四者之上

    MCP 不取代它們,而是把既有 API 包成工具,讓 AI 代理以標準方式發現並呼叫。雲端閘道已經能把 REST、OpenAPI 與 GraphQL 服務轉成 MCP 工具。

    層是什麼
    上層AI 代理或聊天應用
    中層MCP 伺服器:tools · resources · prompts
    下層REST · GraphQL · gRPC · SOAP

    REST · SOAP · gRPC · GraphQL · MCP9 / 15

  10. 比較

    並排比較

    RESTSOAPgRPCGraphQLMCP
    訊息格式以 JSON 為主XMLProtobuf(二進位)JSONJSON-RPC 2.0
    傳輸HTTP多為 HTTPHTTP/2HTTP,通常是 POSTstdio 或 Streamable HTTP
    契約OpenAPIWSDL 與 XSD.proto 檔Schema(SDL)每個工具一份 JSON Schema
    串流有限無四種模式訂閱伺服器事件(SSE)
    HTTP 快取內建幾乎沒有無需額外處理自 2026-07-28 起清單可快取
    主要呼叫者任何開發者企業系統其他服務前端應用AI 代理

    REST · SOAP · gRPC · GraphQL · MCP10 / 15

  11. 比較

    速度取決於工作負載

    • 77%小酬載下 gRPC 比 REST 低的延遲,2.3 毫秒對 10.1 毫秒
    • 15%大酬載下低的延遲
    • 訊息越大,差距越小。這只是 2026 年的一份基準測試,若要為了速度選協定,請先測你自己的工作負載。
    • 對 MCP 來說,瓶頸通常是 AI 上下文視窗中的 token,而不是線路格式。

    REST · SOAP · gRPC · GraphQL · MCP11 / 15

  12. 比較

    安全:靠什麼保護,要注意什麼

    MCP 最大的風險在語意,不在傳輸:工具輸出一律視為不可信。

    選項主要防護要檢查
    RESTTLS、OAuth 2.x、API key每個物件的存取檢查、速率限制
    SOAPWS-Security 簽章與加密XML 解析器的強化
    gRPCTLS 或雙向 TLS、每次呼叫的權杖每次呼叫都設 deadline
    GraphQL深度與成本限制、逾時高成本查詢與批次濫用
    MCPOAuth 2.1、最小權限、人工核准提示注入、權杖轉傳

    REST · SOAP · gRPC · GraphQL · MCP12 / 15

  13. 決策

    我該用哪一個?

    情境首選原因
    給外部開發者的公開 APIREST + OpenAPI最容易採用與快取
    內部服務之間的呼叫gRPC快速且強型別
    畫面眾多的 AppGraphQL只擷取需要的欄位
    舊的銀行或政府系統SOAP包在 REST 後面
    讓 AI 代理使用你的工具MCP一個插頭對應多個 AI 應用

    REST · SOAP · gRPC · GraphQL · MCP13 / 15

  14. 決策

    一家公司,多種風格

    風格服務對象
    REST合作夥伴與第三方開發者
    GraphQL自家的 Web 與行動前端
    gRPC微服務之間的互相呼叫
    SOAP舊系統,隔離在整合層之後
    MCPAI 代理,經由處理身分、政策與稽核的閘道

    REST · SOAP · gRPC · GraphQL · MCP14 / 15

  15. 重點

    要記住的三件事

    • 依呼叫者挑選:外部開發者、自家服務、自家前端,或 AI 代理。
    • MCP 疊在其他四者之上,並不取代它們。
    • 用自己的工作負載測試,並保護每一層。

    REST · SOAP · gRPC · GraphQL · MCP15 / 15