Google Cloud API Gateway hỗ trợ chuyển đổi REST API thành công cụ MCP

24 THÁNG 9, 2026

Hầu hết các năng lực doanh nghiệp đều nằm sau các REST API mà các tác nhân (agent) không thể nhìn thấy. Để một API có thể được gọi bởi tác nhân hiện nay, các nhóm thường phải thiết lập và vận hành một máy chủ MCP riêng biệt, thực hiện lại logic định tuyến, xác thực và hạn mức mà cổng kết nối (gateway) của họ vốn đã xử lý. Model Context Protocol (MCP) đã trở thành tiêu chuẩn để các tác nhân khám phá và gọi công cụ, đồng thời các framework như Agent Development Kit (ADK) và Gemini Enterprise đều hỗ trợ giao thức này một cách tự nhiên.

Google Cloud API Gateway hiện đã thu hẹp khoảng cách đó. Trong bản Public Preview, API Gateway có thể đóng vai trò như một máy chủ MCP từ xa: chỉ cần chú thích (annotate) đặc tả OpenAPI mà bạn đang triển khai, sau đó triển khai nó, và các thao tác REST hiện có của bạn sẽ trở thành các công cụ MCP sẵn sàng cho tác nhân — mà không cần phải xây dựng, lưu trữ hay duy trì thêm máy chủ nào khác.

API Gateway là giải pháp nhập môn nhẹ nhàng trong dòng sản phẩm gateway của Google Cloud. Nếu bạn có một dịch vụ trên Cloud Run và muốn API của nó được bảo mật, quản lý và hiển thị cho các tác nhân trong vài phút, đây chính là con đường nhanh nhất. Đối với một nền tảng API và MCP doanh nghiệp toàn diện — bao gồm quản lý vòng đời, chính sách lưu lượng nâng cao, kiếm tiền — hãy sử dụng Apigee. Để kiểm soát những gì tác nhân của bạn gọi ra bên ngoài, bao gồm cả các máy chủ MCP như thế này, hãy sử dụng Agent Gateway. Model routing, cung cấp cho bạn một điểm cuối ổn định cho các lệnh gọi LLM đi ra, là năng lực bổ trợ cho hướng lưu lượng AI còn lại.

Cách thức hoạt động

API Gateway chấp nhận các yêu cầu JSON-RPC theo tiêu chuẩn MCP trên một điểm cuối duy nhất, chuyển mã (transcode) mỗi công cụ/lệnh gọi thành yêu cầu REST tương ứng, áp dụng các chính sách hiện có của bạn và dịch phản hồi ngược trở lại. Vì yêu cầu đã chuyển mã không khác biệt so với một lệnh gọi REST thông thường, nên việc xác thực bằng JWT hoặc API-key, hạn mức và ghi nhật ký mà bạn đã cấu hình cho thao tác đó vẫn hoạt động bình thường — lưu lượng MCP và REST chia sẻ chung một lộ trình chính sách, và một thao tác nhất định sẽ sử dụng một hạn mức phân bổ bất kể nó được gọi theo cách nào.

1. Chú thích đặc tả OpenAPI của bạn. MCP yêu cầu OpenAPI 3.0.x hoặc 3.1.x; OpenAPI 2.0 không được hỗ trợ, vì vậy nếu gateway của bạn vẫn đang chạy đặc tả 2.0, hãy di chuyển nó trước. Chọn tham gia ở cấp độ tài liệu với x-google-api-management.mcp, và tùy chỉnh hoặc bỏ qua các thao tác riêng lẻ với x-google-mcp-tool. Mỗi thao tác được hiển thị cần có một backend và một mô tả không để trống.

openapi: 3.0.4
info:
  title: Order Service
  version: 1.0.0

x-google-api-management:
  mcp: true                 # expose this spec's operations as MCP tools
  backends:
    orders-backend:
      address: https://orders-a1b2c3-uc.a.run.app

paths:
  /orders/{orderId}:
    get:
      operationId: getOrderStatus
      description: Returns the current status, carrier, and ETA for an order.
      x-google-backend: orders-backend
      x-google-mcp-tool:
        name: get_order_status
        description: "Look up the delivery status and ETA of a customer order.
          Use this when the user asks where an order is or when it will arrive."
      parameters:
        - name: orderId
          in: path
          required: true
          schema:
            type: string

Văn bản thuần

Đã sao chép

Mô tả của một công cụ là tín hiệu chính mà LLM sử dụng để quyết định khi nào nên gọi nó, vì vậy hãy viết rõ khi nào và tại sao nên sử dụng công cụ đó, thay vì chỉ nêu những gì nó trả về.

2. Triển khai gateway. Triển khai cấu hình API như bình thường. API Gateway tạo ra một cấu hình hỗ trợ MCP và bắt đầu phục vụ MCP trên đường dẫn cơ sở /mcp, không cần cung cấp thêm cơ sở hạ tầng nào.

3. Quyết định ai có thể khám phá các công cụ của bạn. Theo mặc định, tools/list không yêu cầu xác thực, điều này thuận tiện cho việc phát triển nhưng sẽ công khai tên công cụ và lược đồ đầu vào của bạn cho bất kỳ ai truy vấn. Đối với môi trường sản xuất, hãy yêu cầu JWT — lưu ý rằng API key không thể bảo mật phương thức này:

x-google-api-management:
  mcp:
    tools-list:
      security:
        orderServiceJwt: []   # the object form also enables MCP globally

Văn bản thuần

Đã sao chép

tools/call luôn thực thi bất kỳ xác thực nào mà thao tác REST cơ bản yêu cầu, bất kể bạn có bảo mật việc khám phá hay không.

4. Kết nối tác nhân của bạn. Trỏ bất kỳ client MCP nào vào điểm cuối /mcp của gateway. Trong ADK, đó là bộ công cụ cộng với thông tin xác thực mà gateway của bạn đã yêu cầu:

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams

order_tools = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev/mcp",
        headers={"x-api-key": API_KEY},
    )
)

agent = Agent(
    model="gemini-2.5-flash",
    name="order_support_agent",
    instruction="Help the user check on their orders.",
    tools=[order_tools],
)

Python

Đã sao chép

Gateway ánh xạ các đối số của công cụ trở lại đường dẫn, truy vấn, nội dung (body) và tiêu đề (header) REST của thao tác, chạy yêu cầu thông qua các chính sách hiện có của bạn và trả về phản hồi của backend dưới dạng kết quả MCP. Để kiểm tra điều đó trên đường truyền:

curl -X POST "https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev/mcp" \
  -H "content-type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -H "x-api-key: $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_order_status","arguments":{"orderId":"A-1042"}}}'

Shell

Đã sao chép

{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text",
  "text":"{\"orderId\":\"A-1042\",\"status\":\"IN_TRANSIT\",\"eta\":\"2026-09-24\"}"}],
  "isError":false}}

JSON

Đã sao chép

Tại sao nên phục vụ MCP từ gateway

• Khả năng khám phá. Kết nối gateway của bạn với API hub và máy chủ MCP của nó sẽ được xuất bản ở đó với siêu dữ liệu dành riêng cho MCP, đồng thời tự động xuất hiện trong Agent Registry, giúp các tác nhân và nhà phát triển có thể tìm thấy các công cụ mà nó hiển thị.
• Không có gì mới để vận hành. Đặc tả, gateway, xác thực, hạn mức và ghi nhật ký hiện có của bạn vẫn thực hiện công việc — lưu lượng MCP và REST vẫn nhất quán vì chúng chia sẻ chung một lộ trình chính sách.

Bản Public Preview hỗ trợ các backend REST và OpenAPI 3.x với xác thực hiện tại của bạn. Các tài nguyên và lời nhắc (prompt) MCP, truyền phát phản hồi (response streaming) và kiểm tra tải trọng Model Armor đang nằm trong lộ trình phát triển. Một vài giới hạn cần lưu ý trước: các thao tác trả về nội dung trống như HTTP 204 sẽ không được hiển thị, các lược đồ đối tượng lồng nhau sâu có thể không hiển thị đầy đủ trong tools/list, một gateway phục vụ tối đa 1.000 công cụ, và MCP cùng model routing không thể được kích hoạt trong cùng một cấu hình API. Xem tài liệu để biết phạm vi hiện tại.

Bắt đầu

Hỗ trợ MCP hiện đã có sẵn trong bản Public Preview. Xem tài liệu và biến API đầu tiên của bạn thành một công cụ sẵn sàng cho tác nhân ngay hôm nay.

Trước

Tiếp theo