Google Cloud API Gateway, REST API를 MCP 도구로 공개하는 기능 Public Preview 제공

API Gateway는 단일 엔드포인트에서 표준 MCP JSON-RPC 요청을 받아 각 tools/call을 대응하는 REST 호출로 변환한다. 기존 정책을 적용한 뒤 응답을 다시 MCP 형식으로 돌려준다. 변환된 요청은 일반 REST 호출과 구별되지 않으므로, MCP와 REST는 같은 정책 경로를 공유하며 하나의 작업은 호출 방식과 관계없이 같은 쿼터를 사용한다.

설정은 4단계로 진행된다. 먼저 OpenAPI 3.0.x 또는 3.1.x 사양에 주석을 단다. OpenAPI 2.0은 지원되지 않으므로 먼저 마이그레이션해야 한다. 문서 단위에서는 `x-google-api-management.mcp`로 활성화하고, 개별 작업은 `x-google-mcp-tool`로 커스터마이즈하거나 제외한다. 공개하는 작업에는 백엔드와 비어 있지 않은 description이 필요하며, LLM이 도구를 호출할지 판단하는 데 쓰이므로 무엇을 반환하는지뿐 아니라 언제, 왜 사용하는지도 적을 것을 권장한다. 다음으로 API 구성을 평소처럼 배포하면 /mcp 기본 경로에서 MCP 제공이 시작된다.

tools/list는 기본적으로 인증이 필요 없다. 개발에는 편리하지만 도구 이름과 입력 스키마가 누구에게나 보인다. 운영 환경에서는 JWT를 요구하도록 설정할 수 있으며, 이 방식에서는 API 키를 사용할 수 없다. tools/call은 탐색을 보호하는지와 관계없이 원래 REST 작업이 요구하는 인증을 항상 적용한다. MCP 클라이언트는 /mcp를 가리키도록 설정하면 되며, ADK에서는 McpToolset과 StreamableHTTPConnectionParams에 게이트웨이가 요구하는 인증 정보를 전달하는 예시가 제공된다.

API hub와 연동하면 MCP 전용 메타데이터와 함께 공개되며, Agent Registry에도 자동으로 표시된다. Public Preview의 대상은 REST와 OpenAPI 3.x 백엔드이며, MCP 리소스와 프롬프트, 응답 스트리밍, Model Armor를 통한 페이로드 검사는 로드맵에 있다. 제약으로는 HTTP 204처럼 본문이 비어 있는 작업은 공개되지 않으며, 깊게 중첩된 객체 스키마는 tools/list에서 완전히 표시되지 않을 수 있다. 하나의 게이트웨이에서 제공할 수 있는 도구는 최대 1,000개이며, MCP와 모델 라우팅은 같은 API 구성에서 함께 사용할 수 없다.

위치 면에서 API Gateway는 Google Cloud 게이트웨이 제품군의 경량 진입점이다. 수명 주기 관리, 고급 트래픽 정책, 수익화까지 포함하는 본격적인 API 및 MCP 플랫폼에는 Apigee를, 에이전트가 외부로 호출하는 대상을 통제하려면 Agent Gateway를 사용하라고 설명하고 있다.