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

Google Cloud API Gateway 原生支援 MCP 協議

Google Cloud API Gateway 現已進入公共預覽階段，可以把現有的 REST API 直接轉換成 Model Context Protocol (MCP) 工具。這項更新要解決的是：企業的應用程式介面通常不在 AI 智能體（Agent）的可見範圍內。過去，開發團隊想讓智能體呼叫這些介面，得另外建置並運作一個獨立的 MCP 伺服器，重新實作閘道器已經處理的路由、驗證與配額邏輯。現在只要在已部署的 OpenAPI 規格中加入特定註解，開發者就能讓現有的 REST 操作直接成為智能體可用的工具，不必再建構、託管或維護任何中介伺服器。

技術實作與配置方式

API Gateway 是 Google Cloud 閘道器產品線中較輕量的入口，適合需要快速保護、管理並暴露 Cloud Run 服務介面的場景。要啟用這項功能，開發者必須使用 OpenAPI 3.0.x 或 3.1.x 規格；OpenAPI 2.0 目前不支援，使用舊版規格的團隊需先遷移。在文件層級，透過 `x-google-api-management.mcp` 選擇啟用；在個別操作層級，則可用 `x-google-mcp-tool` 自訂或跳過特定工具。每個暴露的操作都必須定義後端地址和非空的描述文字，因為大型語言模型是依據工具描述來決定要不要呼叫該工具，描述應說明使用時機，而不是只寫回傳內容。

部署閘道器後，系統會自動產生支援 MCP 的配置，並在 `/mcp` 基礎路徑上提供服務，不需要額外配置基礎設施。安全性方面，`tools/list` 方法預設不需驗證，方便開發測試，但會向所有請求者暴露工具名稱與輸入架構；生產環境建議要求 JWT 驗證，API 金鑰則無法用來保護這個方法。不論是否啟用發現驗證，`tools/call` 方法一律會執行底層 REST 操作所設定的驗證機制。

流量轉譯與政策共用機制

API Gateway 接受標準的 MCP JSON-RPC 請求，並透過單一端點把每個 `tools/call` 請求轉譯成對應的 REST 請求。轉譯後的請求與一般 REST 呼叫無法區分，所以開發者現有的 JWT 或 API 金鑰驗證、配額限制與日誌政策都能照常運作，不必變更。MCP 與 REST 流量走完全相同的政策路徑，無論以何種方式呼叫，特定操作都使用同一份配額分配。閘道器會把工具參數對應到 REST 路徑、查詢參數、主體與標頭，執行既有政策後，再把後端回應轉成 MCP 結果回傳。

此外，閘道器連接 API Hub 後，其 MCP 伺服器會附上 MCP 專屬中繼資料發布，並自動出現在 Agent Registry 中，方便智能體與開發者找到工具。現有的規格、閘道器、驗證、配額與日誌系統直接負責這些工作，MCP 與 REST 流量的處理也因此保持一致。

公共預覽限制與未來規劃

目前的公共預覽版本支援 REST 與 OpenAPI 3.x 後端，並沿用現有驗證機制。不過，MCP 資源、提示、回應串流以及 Model Armor 有效負載檢查等功能仍在規劃路線圖上。已知限制包括：回傳空主體（如 HTTP 204）的操作不會被暴露；深度嵌套的物件架構在 `tools/list` 中可能無法完整呈現；單一閘道器最多支援 1,000 個工具；同一個 API 配置也無法同時啟用 MCP 與模型路由功能。開發者可參考官方文件取得最新範圍資訊，並立即開始把 API 轉換成智能體可用的工具。