본문으로 건너뛰기
MCP 도구 호출을 코드로 옮긴 Cloudflare Code Mode
목차

MCP 도구 호출을 코드로 옮긴 Cloudflare Code Mode (2025-09)

원문 정보

  • 원문: Code Mode: The better way to use MCP
  • 매체 · 게시일: The Cloudflare Blog · 2025-09-26
  • 저자: Kenton Varda, Sunil Pai
  • 원문 내용을 바탕으로 재구성한 요약입니다.

Cloudflare는 MCP 도구를 TypeScript API로 바꾸고, LLM에게 그 API를 호출할 코드를 쓰게 했습니다. 에이전트는 도구를 직접 제공받았을 때보다 더 많고 복잡한 도구를 다뤘습니다. Code Mode는 모델이 잘하는 코드 작성을 MCP 호출에도 활용하는 방식입니다.

호출 사이에서 LLM을 다시 거치는 데이터

일반적인 MCP 에이전트는 도구를 LLM에 직접 보여 줍니다. 각 도구는 매개변수를 받고 응답을 반환하는 RPC 함수입니다. 모델이 특수 토큰 사이에 호출 내용을 출력하면, 실행 프로그램이 해당 도구를 부른 뒤 결과를 모델 입력으로 돌려줍니다.

연속 호출에서는 이 왕복이 부담입니다. 앞선 도구의 응답을 다음 호출의 입력으로 복사하는 데도 LLM의 신경망을 거치며 시간과 에너지, 토큰을 쓰기 때문입니다. Code Mode에서는 코드가 중간 결과를 다음 호출로 넘깁니다. 모델은 자신에게 필요한 최종 결과만 읽도록 코드를 작성할 수 있습니다.

도구를 고르는 단계에도 어려움이 있습니다. 도구가 너무 많거나 복잡하면 LLM이 알맞은 도구를 선택하거나 제대로 사용하는 데 애를 먹습니다. MCP 서버 설계자가 개발자용 API보다 훨씬 단순한 인터페이스를 제공하도록 권장받는 배경입니다. 그런데 같은 모델이 복잡한 개발자용 API를 사용하는 코드를 작성할 때는 그만큼 어려워하지 않습니다.

Cloudflare는 이 상황을 Shakespeare에게 중국어를 한 달 가르친 뒤 그 언어로 희곡을 쓰게 하는 일에 빗댑니다. LLM은 수많은 실제 코드를 학습했지만, 도구 호출에 쓰는 특수 토큰은 별도의 합성 데이터로 배웁니다. TypeScript API에서 더 나은 결과가 나온 이유도 풍부한 실제 TypeScript 학습 데이터에 있을 수 있다고 봅니다. 다만 도구 수나 성능 개선율을 수치로 비교한 결과는 제시하지 않았습니다.

문서까지 담아 변환한 TypeScript API

Code Mode에서도 MCP의 통일된 연결 방식은 유용합니다. MCP는 에이전트가 외부 작업을 수행하도록 API와 설명 문서를 제공하고, 인증은 별도로 처리하는 표준 프로토콜입니다. 기존 API는 연결 방법과 인증, 문서 형식이 제각각입니다. MCP를 쓰면 에이전트 개발자와 서버 개발자가 서로의 구현을 미리 알지 못해도 연결할 수 있고, 생성 코드 밖에서 연결과 인증을 관리할 수 있습니다.

Cloudflare Agents SDK는 MCP 서버의 스키마를 가져와 설명 주석이 달린 TypeScript API로 변환합니다. 이 정의를 에이전트 문맥에 넣습니다. LLM에 실행 도구로 제공하는 것은 연결된 서버들의 개별 도구 목록 대신 TypeScript 코드를 실행하는 도구 하나입니다.

모델이 작성한 코드는 샌드박스에서 실행됩니다. 코드가 TypeScript API를 호출하면 RPC가 에이전트 루프로 돌아오고, SDK가 알맞은 MCP 서버에 요청을 전달합니다. 결과를 모델에 돌려주는 방법은 익숙한 console.log()입니다. 스크립트가 끝나면 여기에 기록한 출력 전체를 에이전트가 받습니다. 필요한 결과만 읽게 하려면 코드도 그 결과만 출력하면 됩니다.

이 기능은 Agents SDK에 이미 추가되었습니다. ai-sdk를 사용하는 앱에서는 codemode 도우미로 기존 시스템 프롬프트와 도구 정의를 감싸면, MCP 서버를 포함한 도구들을 코드로 호출하는 방식이 적용됩니다.

생성 코드에 키를 넘기지 않는 바인딩

샌드박스의 인터넷 접근은 막혀 있습니다. Code Mode에서 전역 fetch()와 connect()를 호출하면 오류가 납니다. 외부와 통신하는 경로는 연결된 MCP 서버를 나타내는 TypeScript API뿐입니다.

이 제한을 가능하게 하는 것이 Workers의 바인딩입니다. env에는 문자열뿐 아니라 실제 동작하는 객체도 넣을 수 있으며, 이 객체가 특정 자원에 접근하는 인터페이스를 제공합니다. Code Mode는 연결된 MCP 서버의 바인딩을 샌드박스에 전달합니다. 일반 네트워크 접근을 열지 않아도 지정된 서버에는 요청을 보낼 수 있습니다.

네트워크 필터나 HTTP 프록시로 접근을 제한하면 허용 범위를 판단하기 어려울 수 있습니다. 감독 프로그램은 API 사용에 꼭 필요한 트래픽을 식별해야 하고, LLM은 어떤 요청이 막힐지 예상해야 합니다. 바인딩에서는 경계가 분명합니다. 제공된 JavaScript 인터페이스가 곧 사용할 수 있는 범위입니다.

접근 토큰은 에이전트 감독 프로그램이 보관합니다. 바인딩의 호출은 먼저 감독 프로그램에 도착하고, 감독 프로그램이 MCP 서버로 보내는 요청에 토큰을 붙입니다. 생성 코드에는 이미 권한이 부여된 클라이언트 인터페이스만 전달합니다. 코드가 해당 API 키를 받지 않으므로 그 키를 유출할 수도 없습니다.

코드 조각마다 새로 띄우는 V8 isolate

이 코드를 실행하는 단위는 Workers의 기반인 V8 isolate입니다. V8 엔진으로 구동하는 격리된 JavaScript 런타임으로, 수 밀리초 안에 시작하고 수 MB의 메모리를 사용합니다. 코드 조각마다 새로 만들어 실행한 뒤 버릴 만큼 가볍습니다.

재사용 풀이나 사전 예열도 필요하지 않습니다. Cloudflare는 실행 부담이 거의 직접 eval()을 하는 것처럼 작으면서도 보안을 갖춘 방식이라고 설명합니다. 임의의 생성 코드를 실행할 때마다 새 샌드박스를 준비하는 설계가 이 가벼운 실행 단위에서 출발합니다.

기존 Workers의 배포 방식은 이 용도에 맞지 않았습니다. Worker 코드를 Cloudflare API로 업로드하고 전 세계에 배포해야 했기 때문입니다. 에이전트에 필요한 것은 자신이 있는 위치에서 방금 작성한 코드를 바로 실행하는 기능이었습니다.

Worker Loader API가 그 경로를 제공합니다. Worker가 필요할 때 코드를 불러오며, 코드 모듈과 실행 환경, 부모 Worker의 RPC 인터페이스로 연결되는 바인딩을 지정할 수 있습니다. 외부 통신을 부모 Worker로 중계해 감시하거나 필터링하는 설정도 지원합니다. globalOutbound에 null을 지정하면 인터넷 접근을 완전히 차단합니다.

비공개 베타에 들어간 Worker Loader API

2025-09-26 게시 시점에 Dynamic Worker Loading은 Wrangler와 workerd를 사용하는 로컬 개발에서 이용할 수 있었습니다. Worker Loader API의 production 사용은 비공개 베타였습니다.

Agents SDK는 당시 변환한 API 전체를 에이전트 문맥에 넣었습니다. 코딩 에이전트처럼 필요한 API를 동적으로 검색하고 탐색하게 만드는 방식은 향후 개선 가능성으로 제시되었습니다. 다른 라이브러리용 변형도 제공할 예정이라고 밝혔습니다.

Worker Loader API의 가격은 확정되지 않았습니다. Cloudflare는 isolate를 기반으로 하므로 컨테이너 방식보다 상당히 낮은 비용을 제공할 수 있을 것으로 전망했습니다.

실행 자원과 제공 상태의 세부 조건
항목값
새 isolate 시작 시간원문 설명상 수 밀리초
isolate 메모리 사용량원문 설명상 수 MB
샌드박스 수명에이전트가 실행하는 코드 조각마다 생성하고 실행 후 폐기
LLM에 노출하는 실행 도구TypeScript 코드를 실행하는 도구 1개
일반 외부 통신 차단 설정Worker Loader API의 globalOutbound에 null 지정
로컬 제공 상태게시 시점 Wrangler와 workerd에서 사용 가능
production 제공 상태게시 시점 비공개 베타
Worker Loader API 가격미확정이며, 컨테이너 기반 방식보다 상당히 낮은 비용 제공을 전망
마지막 수정 일자