본문으로 건너뛰기

Cloudflare의 MCP 서버 구축 전략: 거대한 API를 에이전트용 도구로 변환하기

Cloudflare가 230만 토큰 규모의 방대한 REST API를 MCP 서버로 효율적으로 변환하기 위해 탐색한 코드 생성 및 도구 검색 기술을 다룹니다.

챕터별 상세

00:00

대규모 API와 MCP의 충돌: Mega Context Problem

Cloudflare의 REST OpenAPI 명세는 230만 토큰에 달하며, 이는 개별 에이전트의 컨텍스트 제한을 훨씬 초과하는 규모이다. 초기에는 팀별로 주요 엔드포인트만 선별하여 별도의 MCP 서비스를 구축했으나, 이는 전체 API의 극히 일부만 커버하는 한계가 있었다. 도구 설명 자체가 많은 컨텍스트를 소모하기 때문에 MCP는 'Model Context Protocol'이 아닌 'Mega Context Problem'처럼 느껴지는 상황이 발생했다. 결국 파편화된 서비스 유지보수와 컨텍스트 부족이라는 이중고를 겪게 되었다.

MCP(Model Context Protocol)는 AI 에이전트가 외부 데이터와 도구에 접근할 수 있도록 하는 개방형 표준 프로토콜이다.

05:30

컨텍스트 제한 해결을 위한 관점의 전환

컨텍스트 제한은 MCP 자체의 결함이 아니라 에이전트가 도구를 다루는 방식의 문제로 정의했다. CLI 도구가 자체 발견(Self-discoverable) 및 문서화 기능을 기본으로 갖춘 것처럼, API도 에이전트가 필요할 때 도구를 찾을 수 있도록 도와야 한다. 모든 도구 정의를 한 번에 주입하는 대신 온디맨드 방식으로 도구를 발견하는 클라이언트 측 변화가 필요하다. 서버 측에서도 이러한 발견 메커니즘을 지원하기 위한 구조적 개선이 요구된다.
11:15

Cloudflare의 기술적 접근: Codemod와 도구 검색

방대한 API를 MCP로 변환하기 위해 Codemod 기술을 활용하여 자동화된 코드 변환을 시도했다. 에이전트가 수천 개의 엔드포인트 중 필요한 것을 찾을 수 있도록 '도구 검색(Tool Search)' 기능을 구현하여 전체 API 접근성을 높였다. 수동으로 도구 정의를 작성하는 대신 OpenAPI 스펙에서 직접 MCP 도구 정의를 생성하는 파이프라인을 구축했다. 결과적으로 개발자의 개입 없이도 최신 API 상태를 MCP 서버에 반영할 수 있는 구조를 만들었다.

Codemod는 소스 코드를 자동으로 변환하는 도구로, 대규모 코드베이스의 리팩터링이나 API 마이그레이션에 주로 사용된다.

17:40

Stateless 서버와 MCP TypeScript SDK 활용

Cloudflare는 MCP TypeScript SDK를 사용하여 상태가 없는(Stateless) 서버를 기본 아키텍처로 채택했다. Stateless 서버는 별도의 인프라 관리 부담을 줄이고 확장성을 극대화하며 Cloudflare Workers와 같은 서버리스 환경에 적합하다. SDK의 기능을 활용해 서버가 클라이언트의 요청에 따라 동적으로 도구 목록을 제공하도록 설계했다. 이를 통해 서버 유지보수 비용을 최소화하면서도 에이전트에게 강력한 도구 세트를 제공한다.

Stateless 서버는 클라이언트의 상태 정보를 서버에 저장하지 않아 각 요청이 독립적으로 처리되는 구조를 의미한다.

언급된 리소스

AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 04. 26.수집 2026. 04. 26.출처 타입 YOUTUBE

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.