구글이 기존 API를 AI 에이전트가 찾아 호출할 수 있는 도구로 바꾸는 기능을 Apigee의 자체 운영형 환경에도 제공한다. 자체 데이터센터나 다른 클라우드에서 API를 운영하는 팀은 실행 환경을 옮기지 않고 에이전트의 요청을 자기 클러스터 안에서 처리할 수 있게 됐다.

1. API를 도구로 바꾸는 방식은 유지한다

이번 지원은 2026년 9월 14일 출시된 Apigee hybrid 1.17.0에 포함됐다. 구글은 앞서 2025년 12월 Apigee의 MCP 지원을 미리보기로 발표했다. MCP는 AI 에이전트가 사용할 도구를 찾고 호출하는 통신 규약이다.

개발자가 OpenAPI 3.0.x 명세로 API를 설명하고 MCP Discovery Proxy를 만들면, 명세의 각 작업이 도구가 된다. 프록시는 에이전트의 호출을 기존 API 요청으로 바꿔 주는 창구다. 별도 MCP 서버 코드를 작성하거나 독립 소프트웨어로 운영할 필요는 없다.

에이전트는 tools/list로 도구를 찾고 tools/call로 호출한다. Apigee가 통신 규약 처리와 요청 변환을 맡는다는 점은 기존 방식과 같다.

2. 요청 처리와 설정 전달의 경로를 나눈다

달라진 것은 실행 위치다. MCP 요청을 실제로 처리하는 부분은 사용자의 Kubernetes 클러스터 안에서 동작한다. 호출의 수신, 권한 확인, 백엔드 전달이 자체 인프라 안에서 이뤄지며, 요청 처리 시 MCP 요청과 응답은 Google Cloud로 넘어가지 않는다.

반면 도구 설정은 설정을 관리하는 영역인 Google Cloud의 제어 평면에서 생성된다. 클러스터 안의 보조 프로세스가 이를 주기적으로 가져오므로, 구글이 내부로 연결을 시작하도록 수신 경로를 열 필요는 없다. 요청이 내부에 머문다는 설명을 설정 관리까지 외부와 단절된다는 뜻으로 읽어서는 안 된다.

3. 기존 권한 정책과 관측 체계를 재사용한다

MCP 엔드포인트는 Apigee 프록시이므로 기존 인증과 정책을 적용받는다. 클라이언트에게 허용할 도구를 API product라는 권한 묶음에 지정하고, 필요하면 도구별 호출 한도도 설정한다. 도구 목록 역시 해당 클라이언트에게 허용된 항목만 보여 준다.

배포한 도구는 API hub에 자동 등록돼 검색할 수 있다. API insights에서는 에이전트 트래픽을 일반 API 트래픽과 구분하고 도구별 성능과 오류, 지연을 살펴본다. 요청이 하나의 경로로 모여도 Apigee가 도구 이름을 붙이므로 개별 도구의 사용량과 백엔드 처리 시간을 구분해 볼 수 있다.

4. 활성화 순서와 운영 부담을 함께 확인한다

기능은 기본적으로 꺼져 있으며 1.17.0 이상 클러스터가 필요하다. 배포 도구인 Helm으로 활성화한다.

설정 파일 overrides.yaml의 최상위에 enableMcpServer: true를 둔다.

Helm의 배포 패키지인 차트는 apigee-operator를 먼저, apigee-org를 나중에 업그레이드한다. 순서를 바꾸면 업그레이드는 성공해도 MCP 실행 단위가 생성되지 않는다.

설정을 가져오려면 기존 apigee-watcher 신원에 조직별로 한 차례 제어 평면 접근 권한을 부여해야 한다. 새 Google 서비스 계정이나 IAM 역할을 만들 필요는 없다.

기본 실행 복제본은 2개이며 최대 10개까지 자동 확장한다.

이익은 별도 MCP 서버 운영을 덜고 기존 보안 정책을 재사용하면서 요청을 내부에서 처리하는 것이다. 대신 클러스터가 복제본과 보조 프로세스를 수용해야 한다. 활성화와 비활성화 모두 실행 프로세스를 단계적으로 교체하므로 원문은 승인된 유지보수 시간에 작업하도록 안내한다.

5. 호출 추적은 계측 조건을 갖춰야 한다

분산 추적은 여러 서비스를 지난 요청에 같은 꼬리표를 붙여 지연이 생긴 구간을 찾는 방식이다. Apigee는 MCP 메시지의 _meta에서 추적 정보를 꺼내 일반 HTTP 헤더로 전달한다. 이미 추적 계측이 된 백엔드는 코드 수정 없이 같은 흐름에 참여할 수 있다.

다음은 원문 호출 예시에서 추적 정보를 담은 부분이다.

          "_meta": {
            "traceparent": "00-3ad8012d970b3971cb16cda653a1a370-df3047d1d0830dc0-01"
          }

원문의 예시는 Apigee에서 OpenTelemetry 기반 분산 추적을 활성화하고, 호출 경로의 서비스가 같은 Google Cloud Trace로 보고한다는 조건을 둔다. 따라서 클러스터 내부 실행만으로 전체 호출 추적까지 자동 완성되는 것은 아니다.

관련 전달 방식의 표준화를 추진하는 SEP-2028은 아직 공개 제안이다.

이번 지원의 가치는 API 실행 위치와 기존 통제 체계를 유지한 채 에이전트 접근을 여는 데 있으며, 도입 판단에는 클러스터 자원과 변경 작업 부담도 함께 넣어야 한다.