Google Cloud API Gateway 支援將 REST API 轉換為 MCP 工具

Google Cloud API Gateway 現已進入公開測試階段，原生支援將 REST API 轉換為 Model Context Protocol（MCP）工具。這項功能由軟體工程師 Sanjay Pujare、Paul Howell 與產品經理 Geir Sjurseth 共同推動，用來解決企業能力通常被封鎖在 REST API 背後、AI Agent 難以直接存取的問題。過去開發者若要讓現有 API 能被 Agent 呼叫，通常得建立並維護一個獨立的 MCP 伺服器，重新實作路由、驗證與配額邏輯，這不只增加營運負擔，也跟閘道器原本就在處理的功能重複。

無縫轉換與政策共用

Google Cloud API Gateway 這次更新縮小了這個落差。在公開測試期間，開發者只要對現有的 OpenAPI 規格書加入特定註解，就能把現有的 REST 操作直接暴露為可供 Agent 使用的 MCP 工具，不需要額外建置中介軟體或基礎設施。API Gateway 接受標準的 MCP JSON-RPC 請求，轉譯成對應的 REST 請求，同時套用既有的政策，最後把回應轉換回 MCP 格式。

由於轉譯後的請求跟一般 REST 呼叫沒有分別，開發者先前為該操作配置的 JWT 或 API Key 驗證、配額限制以及日誌記錄政策，都能繼續正常運作。也就是說，MCP 與 REST 流量走的是完全相同的政策路徑，不管呼叫來源是誰，單一操作都只消耗一份配額，流量管理維持一致。

規格註解與部署流程

要啟用這功能，開發者必須使用 OpenAPI 3.0.x 或 3.1.x 規格，OpenAPI 2.0 不支援，所以如果閘道器還在跑舊版規格，得先遷移。在文件層級，透過設定 `x-google-api-management.mcp` 為 `true` 來選擇加入，也可以針對個別操作使用 `x-google-mcp-tool` 進行自訂或跳過。每個要暴露的操作都需要後端設定，以及非空的描述字段。

舉例來說，在訂單服務的案例中，開發者可以定義一個名為 `get_order_status` 的工具，描述寫明用於查詢訂單狀態、運送商與預計到達時間。工具的描述是大型語言模型判斷是否要呼叫該工具的主要依據，所以建議寫使用情境，而不是只描述回傳內容。部署閘道器時，系統會自動生成支援 MCP 的配置，並在 `/mcp` 這個基礎路徑開始服務，不需要額外配置基礎設施。

安全控制與 Agent 連接

在工具發現方面，預設情況下 `tools/list` 方法不需要驗證，這樣雖然方便開發，但也代表工具名稱與輸入架構會公開給所有查詢者。生產環境建議要求 JWT 驗證，要注意 API Key 沒辦法用來保護這個方法。不管有沒有保護發現功能，`tools/call` 都會強制執行底層 REST 操作所需的驗證機制。

開發者可以把任何 MCP 用戶端指向閘道器的 `/mcp` 端點。以 Agent Development Kit（ADK）為例，只要設定工具集與閘道器預期的憑證，就能建立 Agent。閘道器會把工具的參數映射到操作的 REST 路徑、查詢、主體與標頭，執行請求並套用現有政策，最後把後端回應當成 MCP 結果回傳。用 `curl` 這類工具就能驗證 JSON-RPC 請求與回應的格式。

可發現性與限制說明

把 MCP 服務放在閘道器上，可以透過 API Hub 連接，讓 MCP 伺服器發布帶有 MCP 特定中繼資料的資訊，並自動出現在 Agent Registry 中，方便 Agent 與開發者找到這些工具。這次公開測試涵蓋支援 REST 與 OpenAPI 3.x 的後端，並沿用現有驗證機制。未來路線圖包含對 MCP 資源、提示、回應串流以及 Model Armor 負載檢查的支援。

目前有幾個限制：回傳空主體的操作（如 HTTP 204）不會被暴露；深度嵌套的物件架構可能在 `tools/list` 中無法完全呈現；單一閘道器最多支援 1,000 個工具；MCP 與模型路由功能無法在同一個 API 配置中同時啟用。開發者可以參考官方文件了解目前範圍的詳細資訊，開始把 API 轉換成 Agent 可用的工具。