개요
Cloudflare MCP는 수천 개의 Cloudflare API 엔드포인트를 각각 MCP 도구로 등록하는 대신, search()로 OpenAPI 작업을 찾고 execute()로 격리된 Worker 안에서 TypeScript를 실행하는 Code Mode 서버다. Cloudflare는 2026년 2월 발표에서 이 방식이 대규모 API의 도구 정의 컨텍스트를 크게 줄인다고 설명했다.
구조
- OpenAPI 스펙을
$ref까지 미리 해소해 R2에 저장하고, 제품·작업 메타데이터를 검색 가능한 형태로 유지한다. search실행은 네트워크 없는 Worker Loader 격리 환경에서 이뤄지고,execute의 outbound는 Cloudflare API URL로 제한한다.- OAuth(PKCE)와 직접 API 토큰 모드를 구분하고, 요청별 인증·허용 Origin/Host·응답 토큰 제한·Analytics Engine 메트릭을 둔다.
- Code Mode SDK는 기존 MCP 서버를
code()하나로 감싸거나 OpenAPI 스펙에서search()/execute()서버를 생성하는 재사용 계층을 제공한다.
다른 Cloudflare MCP와의 관계
이 저장소는 넓은 API를 코드 실행으로 다루는 범용 서버다. 제품별로 타입이 정해진 원격 도구가 필요하면 2026-08-09-github-cloudflare-mcp-server-cloudflare를 선택한다. 에이전트 런타임에 Code Mode를 내장하려면 2026-08-09-github-cloudflare-agents의 @cloudflare/codemode를 함께 본다. 인증·격리·실제 API 호출은 이 노트에서 실행하지 않았다.
출처
- GitHub 저장소 —
AGENTS.md와 소스 구조를 기준으로 정리. - Code Mode: give agents an entire API in 1,000 tokens — 2026-02-20 발표.
- moc-mcp · moc-cloudflare-open-source