이 소식은 무엇인가요?
배경부터 차근차근 살펴보기
AI 에이전트가 일반화되면서 기업들은 자신의 기존 시스템을 에이전트가 사용할 수 있는 도구로 노출하려는 필요성이 커지고 있습니다. 그동안 이를 위해서는 REST API를 MCP(Model Context Protocol) 형식으로 변환해주는 커스텀 미들웨어를 직접 구축해야 했는데, 이 과정이 복잡하고 비용이 많이 들었습니다.
Google Cloud는 이 문제를 API Gateway 차원에서 해결했습니다. 이제 개발팀은 기존 OpenAPI 3.x 스펙에 특정 어노테이션(x-google-api-management.mcp)을 추가하기만 하면, API Gateway가 자동으로 MCP 서버로 동작하여 AI 에이전트의 요청을 REST 호출로 변환합니다.
이 변화의 핵심은 간편함과 일관성입니다. 개발팀이 복잡한 미들웨어를 구축할 필요가 없고, 기존 API에 적용된 인증 정책, 요금 제한, 감시 로깅이 에이전트 요청에도 그대로 적용되므로 보안과 거버넌스 측면에서 일관성을 유지할 수 있습니다.
REST API는 이미 거의 모든 기업 소프트웨어(CRM, ERP, 데이터 웨어하우스, 회의실 예약 등)에서 기본 표준입니다. 이 기능이 확산되면 조직들이 더 쉽고 빠르게 자신의 도구를 에이전트와 연결할 수 있게 되어, 시작 장벽이 크게 낮아집니다.
결과적으로 AI 에이전트의 활용 범위가 개별 작은 도구를 넘어 기업 전체 워크플로우로 확대될 것으로 예상됩니다.
공식 발표에서 확인된 내용
구체적으로 무엇이 달라졌나
- 01
Google Cloud API Gateway가 MCP 네이티브 서버로 동작하여, 별도의 커스텀 미들웨어 없이 REST API를 에이전트 도구로 변환합니다.
- 02
OpenAPI 3.x 스펙에 x-google-api-management.mcp 어노테이션을 추가하기만 하면 자동으로 변환이 이루어집니다.
- 03
API Gateway가 MCP JSON-RPC 요청을 자동으로 REST 호출로 변환(트랜스코딩)하므로, 기존 REST API 코드 수정이 불필요합니다.
- 04
기존 API에 적용된 인증, 요금 정책, 감시 로깅이 에이전트 요청에도 자동으로 적용되어, 별도의 보안 또는 거버넌스 설정이 최소화됩니다.
- 05
이를 통해 기업들이 자신의 REST API를 신속하게 에이전트 도구 에코시스템에 노출할 수 있게 됩니다.
사용자에게 미치는 영향
누구에게 어떤 의미가 있나
기술팀·개발자
기존 REST API를 에이전트 도구로 변환하는 작업이 크게 단순화되어, 개발 시간과 비용을 절감할 수 있습니다. OpenAPI 스펙만 준비되어 있다면 어노테이션 추가만으로 완료되므로, 커스텀 미들웨어 구축과 유지보수 부담이 사라집니다.
일반 사용자(에이전트 활용자)
앞으로 더 많은 기업 시스템(CRM, 회의실 예약, 데이터 분석 도구 등)이 AI 에이전트로 직접 연결되어, 자신이 사용하는 에이전트의 기능과 자동화 범위가 크게 확대될 것입니다.
IT·보안 담당자
기존 API 보안·요금·감시 정책이 에이전트 요청에도 자동 적용되므로, 에이전트 통합 시 별도의 보안 검토나 거버넌스 설정을 최소화할 수 있습니다.
조직의 경영진·PM
기업 시스템의 에이전트 통합 장벽이 낮아져, 자동화 도입 속도와 범위가 크게 증가할 수 있으며, 이는 업무 효율성 개선과 의사결정 속도 향상으로 이어질 수 있습니다.
실제 활용 장면
어디에 어떻게 써볼 수 있나
기업 CRM을 에이전트 영업 도구로 활용
Salesforce 같은 CRM의 기존 REST API를 OpenAPI 스펙으로 정의하고, Google Cloud API Gateway에 MCP 어노테이션을 추가하면, AI 에이전트가 CRM 데이터를 직접 조회·수정할 수 있는 도구로 노출됩니다. 판매팀이나 고객 서비스 팀원은 에이전트에게 고객 정보 조회나 계약 상태 업데이트를 요청할 수 있습니다.
- 예를 들면
- 사용자가 에이전트에게 "서울 지역 고객 중 계약이 90일 이상 갱신되지 않은 곳들을 찾아 팔로우업 메일 초안을 만들어줘"라고 요청합니다.
- 확인할 결과
- 에이전트가 CRM API를 통해 필터링된 고객 목록을 조회하고, 각 고객별 맞춤형 팔로우업 메일 초안을 생성하여 사용자에게 제시합니다.
조직 내부 예약 시스템을 에이전트 도구로 제공
조직의 회의실, 차량, 장비 예약 시스템이 REST API로 구현되어 있다면, 이를 MCP로 변환하여 에이전트가 직접 예약을 생성·수정·취소할 수 있도록 만듭니다. 직원은 자연스러운 언어로 에이전트에게 예약을 요청하기만 하면 됩니다.
- 예를 들면
- 사용자: "이번 주 목요일 2시부터 4시까지 10명 이상 수용 가능한 회의실 예약하고 팀 캘린더에 공유해줘"
- 확인할 결과
- 에이전트가 예약 API를 호출하여 조건에 맞는 회의실을 확인하고 예약을 완료하며, 팀 캘린더에 자동 등록합니다.
데이터 분석 API를 에이전트 자문 도구로 변환
기업의 데이터 웨어하우스나 BI 도구가 REST API로 쿼리를 받는다면, 이를 에이전트 도구로 만들어 직원들이 자연어로 데이터를 분석하도록 할 수 있습니다. 통계 지식 없이도 에이전트가 데이터를 조회하고 해석해줍니다.
- 예를 들면
- 사용자: "지난 분기 지역별 판매액 상위 5개 지역과 전년도 대비 성장률을 보여줘"
- 확인할 결과
- 에이전트가 데이터 API를 호출하여 필요한 데이터를 조회하고, 시각화와 함께 해석된 인사이트를 제시합니다(예: "특정 지역의 성장이 두드러졌다").
직접 적용해 보기
처음부터 무리하지 말고, 이 순서로 확인하세요
조직의 REST API 목록과 용도 파악
자신의 조직이 현재 사용 중인 REST API가 무엇인지, 누가 관리하고 있는지 파악합니다. CRM, ERP, 회의실 예약, 데이터 분석 등 일상 업무에 쓰이는 시스템을 중심으로 정리합니다. IT팀이나 개발팀과 협력하여 각 API의 보안 수준, 인증 방식, 공개 범위를 확인합니다.
확인: 조직 내 REST API 목록이 명확하고, 각 API의 용도·관리자·보안 등급이 기록되어 있는가? 에이전트로 노출해도 괜찮은 API는 무엇인가?
선택한 API의 OpenAPI 3.x 스펙 준비
에이전트로 변환할 API의 OpenAPI 3.x 스펙을 준비합니다. 기존 문서가 있다면 3.x 형식으로 업데이트하고, 없다면 API의 모든 경로, HTTP 메서드, 입력 파라미터, 응답 형식을 스펙으로 작성합니다. 이 단계에서 API 문서의 정확성과 완전성을 보증해야 합니다.
확인: OpenAPI 스펙이 3.x 버전이고, API의 모든 엔드포인트와 파라미터가 정의되어 있는가? API 응답 형식이 명확하고 일관성 있는가?
Google Cloud API Gateway에 MCP 어노테이션 추가
OpenAPI 스펙에 Google Cloud의 MCP 어노테이션(x-google-api-management.mcp)을 추가합니다. Google Cloud 공식 문서의 예시를 참조하여 어노테이션 문법을 정확히 따릅니다. 필요하면 기존 인증 설정(API 키, OAuth 등)이 유지되는지 확인합니다.
확인: 어노테이션의 문법이 올바르고, Google Cloud API Gateway에 스펙이 정상적으로 업로드되었는가? 기존 API 인증이 그대로 유지되는가?
테스트 에이전트로 변환된 도구 시험
작은 규모의 테스트 에이전트로 변환된 API 도구를 호출해봅니다. 실제 데이터가 아닌 테스트 데이터로 시작하여, 요청 형식의 변환이 정상인지, 응답이 예상대로 오는지 확인합니다. 오류가 발생하면 OpenAPI 스펙이나 어노테이션을 수정합니다.
확인: 에이전트의 요청이 정상적으로 REST API로 변환되는가? API의 응답이 에이전트에게 올바르게 전달되는가? 기존 인증 정책이 작동하는가?
프로덕션 배포 및 모니터링 설정
테스트가 완료되면 프로덕션 환경에 배포합니다. Google Cloud API Gateway의 로깅·요금 추적 기능이 에이전트 요청에도 적용되는지 확인하고, 이상 활동 감지를 위한 알림을 설정합니다. 처음 몇 주간은 실시간 모니터링으로 예상 밖의 사용 패턴이 있는지 확인합니다.
확인: 로깅에 에이전트 요청이 정상적으로 기록되는가? 요금 청구에 추가 비용 항목이 있는가? 보안 정책이 예상대로 작동하는가?
해석할 때 주의할 점
확인된 범위와 아직 모르는 내용을 구분하세요
Google Cloud 공식 블로그는 API Gateway의 MCP 네이티브 지원, OpenAPI 어노테이션을 통한 변환 방식, 기존 인증·요금·로깅의 자동 적용을 명확히 확인했습니다. 다만 성능 벤치마크(레이턴시, 처리량), MCP 변환으로 인한 비용 변화, 다른 클라우드 플랫폼에서의 유사 기능 계획, MCP 표준의 산업 전체 채택 전망 등은 현 발표 자료에서 확인할 수 없습니다.
- Google Cloud API Gateway 한정 서비스 - 이 기능은 Google Cloud에서만 사용 가능하므로, AWS, Azure 같은 다른 클라우드 플랫폼이나 자체 인프라에서 API Gateway를 운영하는 조직은 이 방법을 사용할 수 없습니다.
- OpenAPI 3.x 스펙 필수 - REST API를 OpenAPI 3.x 형식으로 문서화해야 하는데, 레거시 시스템의 경우 스펙 작성에 상당한 노력이 필요할 수 있습니다.
- MCP 표준의 미완성 상태 - MCP는 Anthropic이 주도하고 있지만, 아직 공식 표준화 완료 단계가 아니며 다른 AI 플랫폼(OpenAI, Meta 등)의 채택 정도가 불명확합니다.
- 비용 영향 미공개 - 원문에서 API Gateway 사용 비용에 MCP 기능이 미치는 영향을 명시하지 않아, 규모가 큰 조직의 경우 추가 비용을 검증해야 합니다.
- 데이터 민감도 높은 API의 추가 검증 필요 - 자동 적용되는 인증·요금·로깅 정책이 충분한지, 데이터 민감도가 높은 API(급여, 의료 정보, 재무 데이터 등)의 경우 별도 보안 검토가 필요합니다.
출처와 확인일
원문에서 다시 확인하기
이 글은 Google Developers Blog의 공식 발표를 바탕으로 정리했습니다. 기능 범위와 제공 조건은 바뀔 수 있으므로 실제로 적용하기 전에는 원문을 다시 확인해 주세요.
- 마지막 확인
- 2026-09-27
- 다음 검토
- 2026-10-27