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

Google Cloud API Gateway 原生支援 MCP 協議

Google Cloud API Gateway 現已進入公開預覽階段，可將現有 REST API 轉換為 Model Context Protocol (MCP) 工具。企業能力通常鎖在 REST API 後方，AI Agent 無法直接存取，這項更新就是要處理這個問題。過去開發者若要讓 API 能被 Agent 呼叫，通常得另外建立並維護一個 MCP 伺服器，重新實作路由、驗證與配額邏輯。現在只要在已部署的 OpenAPI 規格中加入特定註解，就能把現有的 REST 操作直接暴露成 Agent 可用的 MCP 工具，不必額外建置中介軟體或基礎設施。

技術實作與 OpenAPI 註解

API Gateway 是 Google Cloud 閘道產品線中較輕量的入口，適合需要快速保護、管理 Cloud Run 上的服務 API，並將其開放給 Agent 的場景。如果需要完整的企業級 API 與 MCP 平台（包含生命週期管理、進階流量政策或貨幣化），建議使用 Apigee；若要治理 Agent 的出站呼叫，則可搭配 Agent Gateway。

要啟用這項功能，開發者必須使用 OpenAPI 3.0.x 或 3.1.x 規格，OpenAPI 2.0 不支援，需先遷移。在文件層級，可透過 `x-google-api-management.mcp` 選擇啟用。針對個別操作，可用 `x-google-mcp-tool` 自訂或跳過。每個暴露的操作都必須有後端設定與非空的描述。例如在訂單服務中，可以把 `getOrderStatus` 操作映射成名為 `get_order_status` 的 MCP 工具，並寫上詳細的使用情境描述，因為大型語言模型主要就是依據工具描述來決定是否呼叫該工具。

部署流程與安全機制

部署過程與一般 API 配置相同。API Gateway 會自動產生支援 MCP 的配置，並在 `/mcp` 基礎路徑上提供服務。安全方面，`tools/list` 方法預設不需驗證，方便開發測試，但所有請求者都能看到工具名稱與輸入架構。為確保正式環境安全，建議要求 JWT 驗證，API Key 則無法用來保護這個方法。無論是否保護工具探索功能，`tools/call` 一律會執行底層 REST 操作所需的驗證。

流量轉譯與現有政策沿用

API Gateway 接受標準的 MCP JSON-RPC 請求，並把每個 `tools/call` 轉譯成對應的 REST 請求。轉譯後的請求與一般 REST 呼叫無法區分，因此開發者已配置的 JWT 或 API Key 驗證、配額及日誌政策都能繼續運作。MCP 與 REST 流量走完全相同的政策路徑，同一個操作不論以何種方式被呼叫，都只消耗一份配額。Gateway 會把工具參數映射回 REST 的路徑、查詢、主體與標頭，執行請求後再把後端回應當作 MCP 結果回傳。

可發現性與限制

將 Gateway 連接到 API Hub 後，其 MCP 伺服器會以 MCP 專屬的中繼資料發布，並自動出現在 Agent Registry 中，方便 Agent 與開發者找到工具。目前公開預覽版本涵蓋 REST 與 OpenAPI 3.x 後端，並支援現有驗證機制。不過仍有一些限制：回傳空主體（如 HTTP 204）的操作不會被暴露；深度嵌套的物件架構可能無法在 `tools/list` 中完整呈現；單一 Gateway 最多支援 1,000 個工具；同一個 API 配置中也無法同時啟用 MCP 與模型路由。MCP 資源、提示、回應串流及 Model Armor 負載檢查等功能已列入開發路線圖。