← 블로그로
Ai약 12 분 읽기

Azure Application Gateway for Containers, MCP 트래픽 지원

게시일 2026년 11월 11일
Azure Application Gateway for Containers, MCP 트래픽 지원

Azure가 11월 2일, 쿠버네티스에서 에이전트를 돌리는 많은 팀이 몇 달째 손으로 만들어온 기능을 추가했다. Application Gateway for Containers가 Model Context Protocol 트래픽을 이해한다.

AZ576388로 추적되는 이번 업데이트는 세 기능이 함께 들어왔다. 프로토콜을 인식하는 MCP 라우팅, JWT 검증, 공인 IP가 없는 프라이빗 프런트엔드. 개별로 보면 평범한 게이트웨이 기능이다. 합치면 단일 서버를 넘어선 MCP 배포의 형태를 그린다.

리소스

핵심은 MCPRoute라는 사용자 정의 리소스이고 API 그룹은 alb.networking.azure.io/v1alpha1이다. 표준 Gateway API의 Gateway에 붙는다. 이미 Gateway API를 쓰는 사람에게 중요하다. 병행 인그레스 체계를 들이는 게 아니라 라우트 유형 하나를 더하는 것이다.

건너뛰면 반나절이 날아가는 설정 단계가 있다. 리스너가 이 라우트 유형을 명시적으로 허용해야 하고, allowedRoutes.kinds에서 그룹을 alb.networking.azure.io, kind를 MCPRoute로 지정한다. 이게 없으면 라우트는 그냥 붙지 않고, 오류는 이유를 쉬운 말로 알려주지 않는다.

라우트 자체는 평범하다. parentRefs가 리스너를 가리키고, hostnames가 공개 도메인을 담고, path가 공개 경로이며 기본값은 /mcp, backendRefs가 쿠버네티스 서비스와 포트를 가리킨다. 백엔드가 다른 경로에서 MCP 엔드포인트를 제공하면 backendRefs[].path가 다시 쓴다. /engineering을 공개하고 내부의 /mcp로 넘길 수 있다.

집계가 곧 제품

백엔드 참조가 하나면 통과다. 게이트웨이는 들어온 MCP 요청을 그대로 전달한다. 한 팀이 모든 기능을 갖고 있거나 그 서버가 이미 하류를 집계했을 때 맞다.

백엔드 참조가 여러 개면 이건 배관이 아니다. 게이트웨이가 그것들을 하나의 논리 엔드포인트로 합친다. 클라이언트가 tools/list, resources/list, prompts/list를 보내면 게이트웨이는 모든 백엔드로 팬아웃하고 응답을 하나의 카탈로그로 합친다.

기능 이름은 충돌을 피하려고 네임스페이스가 붙는다. contoso-tools라는 서비스의 get_order 도구는 클라이언트에게 contoso-tools__get_order로 보인다. 접두사가 붙은 이름으로 호출하면 게이트웨이가 접두사를 떼고 소유한 백엔드로 라우팅한다.

세 가지 결과가 따른다. 문서도 명시한다.

서비스 이름이 클라이언트가 보는 네임스페이스가 된다. 즉 라우트를 공개하면 그 이름이 고정된다. 서비스 이름을 바꾸면 클라이언트가 아는 모든 도구 이름이 바뀌기 때문이다. 매니페스트에서는 겉모양처럼 보이고 18개월 뒤 파괴적 변경이 되는 종류의 결정이다.

라우트 하나가 참조할 수 있는 백엔드는 최대 64개. 실제 상한이고, 여기에 닿으면 팀 단위가 아니라 도메인 단위로 쪼개게 된다.

백엔드는 프로토콜 호환이어야 한다. 하나가 잘못된 디스커버리 응답을 내는 MCP 구현이면 합쳐진 카탈로그가 나빠지고, 장애는 백엔드 하나가 비준수인 게 아니라 게이트웨이가 깨진 것처럼 보인다. 느린 하류에는 넉넉한 타임아웃을 줘라. 합쳐진 엔드포인트는 가장 느린 구성원보다 빠를 수 없다.

상태를 가진 서버와 세션 어피니티

initialize 뒤에도 메모리에 상태를 두는 MCP 서버가 있다. 그런 경우 백엔드에서 sessionAffinity를 지원해 핸드셰이크를 수행한 파드에 세션을 고정한다.

문서는 이것이 최선 노력이라고 솔직히 적는다. 고정된 파드가 삭제되거나 사용 불가가 되면 요청은 실패하지 않고 일반 부하 분산으로 돌아간다. 논리적 결론은 MCP 서버가 세션 상실을 견뎌야 하고, 중요한 것은 파드 밖에 두어야 한다는 것이다.

반대 방향 권고도 인용할 만하다. 백엔드에 어피니티가 필요 없으면 켜지 마라. 무상태 서비스는 꺼둔 쪽이 더 예측 가능하게 확장되고 복구된다.

JWT와 처리 순서

인증은 AuthPolicy 리소스를 거치고, MCPRoute, 부모 게이트웨이, 관리되는 ApplicationLoadBalancer 중 어디에나 붙일 수 있다. 게이트웨이는 MCP 트래픽을 전달하기 전에 토큰의 서명, 발급자, 만료, 오디언스를 검증한다.

실행 순서는 세 계층으로 고정된다. WAF가 먼저 평가하고, JWT 검증이 신원을 확인하고, MCP 라우팅이 처리해 전달한다. 실무적 결과 하나. WAF가 원래 요청을 보고 로그도 그렇다.

범위 함정이 둘. 리스너에 MCP 라우트가 여러 개일 때 한 라우트에 붙인 WAF 정책이 나머지를 자동으로 보호하지 않는다. 정책은 라우트별로 적용해야 한다. 그리고 다른 네임스페이스의 서비스를 참조하는 라우트는 namespace 필드와 서비스 쪽 네임스페이스의 ReferenceGrant가 모두 필요하다. 없으면 라우트는 ResolvedRefs=False, 이유 reference-not-permitted를 보고한다.

설계 문서에 복사할 문장

게이트웨이는 OAuth 보호 리소스 메타데이터를 게시할 수 있어 MCP 클라이언트가 인가 서버와 지원 스코프를 발견할 수 있다. 그 설명 직후에 문서는 액자에 넣을 만한 문장을 덧붙인다.

스코프를 게시하는 것은 인가를 강제하는 것과 같지 않다. 역할, 스코프, 권한, 리소스 소유권을 확인할 책임은 MCP 서버에 남는다.

정직한 경계다. 게이트웨이는 네가 누구인지 답할 수 있다. 이 레코드에 이 행위가 허용되는지는 답할 수 없다. 오디언스 클레임의 엣지 검증은 여전히 옳다. MCP 스펙은 토큰 통과를 금지하고, 서버는 자신을 위해 발급되지 않은 토큰을 받아들여서는 안 된다. 오디언스 검증 실패는 혼동된 대리인과 깨진 감사 추적을 낳는다. 하지만 엣지에서의 검증이 인가 결정을 그곳으로 옮기지는 않는다.

'인증은 게이트웨이에 두었다'를 '인증은 끝났다'로 읽는 사람은 토큰이 닿는 모든 도구를 호출할 수 있는 에이전트를 출하한다.

프라이빗 프런트엔드와 토폴로지 함정

세 번째 기능은 게이트웨이 프런트엔드에서 공인 IP를 완전히 없앤다. 프런트엔드는 승인된 Azure Private Link 프라이빗 엔드포인트로만 닿을 수 있고, 각각 수동으로 승인하거나 거부할 수 있다.

가치는 경계를 넘는 데 있다. 프라이빗 엔드포인트는 가상 네트워크, 구독, Entra 테넌트, 리전을 넘어 작동하고, VNet 피어링이 필요 없으며, 주소 공간 중복도 견딘다. 후자는 프라이빗 연결 프로젝트를 보통 죽이는 장애물이다. 게이트웨이 리소스 하나가 공인과 프라이빗 프런트엔드를 동시에 가질 수 있다.

다이어그램을 그리기 전에 알아야 할 함정이 하나. 게이트웨이 앞에 방화벽이 있으면 소스 NAT 때문에 게이트웨이는 클라이언트가 아니라 방화벽 IP를 본다. 로그와 속도 제한이 모두 상한다. 클라이언트 IP가 중요할 때는 게이트웨이를 방화벽 앞에 둔다.

왜 한 번의 릴리스여야 했나

MCPRoute는 라우팅 계층. AuthPolicy는 인증 계층. 프라이빗 프런트엔드는 네트워크 격리 계층. 함께 내놓아야 플랫폼 팀이 애그리게이터와 서비스 메시와 방화벽 규칙을 조립하는 대신 관리되는 HTTPS 엔드포인트 하나를 팀에 건넬 수 있다.

대안은 많은 팀이 지금 겪는, MCP 서버 목록을 들고 카탈로그를 합치고 새것이 생길 때마다 다시 만드는 자체 애그리게이터다. 다섯 개까지는 되고 스무 개에서 무너진다. 애그리게이터가 아무도 소유하지 않는 상태 저장 서비스가 되기 때문이다.

한 이름 뒤에 64개 백엔드는 정말 유용한 형태다. 네임스페이스 규약은 한 분기 안에 다른 모든 게이트웨이 벤더가 베낄 부분이다. 어려운 문제를 풀기 때문이다. 두 팀이 search라는 도구를 원하고 둘 다 이름을 바꾸고 싶지 않다.

쉽게 베껴지지 않는 것은 문서가 요구하는 규율이다. 카탈로그를 합치는 게이트웨이는 의도하지 않은 기능을 노출하는 일을 아주 쉽게 만든다. 백엔드를 붙이기 전에 그 도구가 라우트에 닿는 모든 클라이언트에게 닿아야 하는지 결정하라. 답이 아니오라면 라우트 경계가 인가 경계이고, 그것은 기본값이 아니라 결정이다.

관련 글