도구 2,594개가 2개로 줄었다: Cloudflare가 Vectorize 기반 AutoRAG MCP 서버를 접은 Code Mode 전환 체크리스트

RAG 전담 MCP 서버가 사라진 이유

Cloudflare는 2026년 초부터 AutoRAG를 포함해 AI Gateway·Audit Logs·DNS Analytics·GraphQL·Logpush·Observability·Radar·Workers Bindings·Workers Builds 등 제품별 MCP 서버 10개를 공식 저장소(cloudflare/mcp-server-cloudflare)의 "폐기(Deprecated)" 목록으로 옮겼습니다. AutoRAG는 Vectorize 인덱스를 검색해 RAG 질의에 답하던 전담 서버였고, list_rags·ai_search 같은 전용 도구를 노출했습니다. 폐기 공지는 "가능한 빨리 마이그레이션하라"고만 적혀 있을 뿐 종료일을 밝히지 않았습니다.

대체재는 단일 통합 서버 mcp.cloudflare.com/mcp 입니다. Vectorize를 포함한 Cloudflare API 전체를 코드 실행 방식으로 노출하므로 RAG 전담 도구 없이도 같은 질의를 처리할 수 있지만, 전용 도구가 주던 "타입이 보장된 호출" 경험은 사라지고 모델이 OpenAPI 스펙을 코드로 직접 탐색해야 합니다.

도구 2,594개를 2개로 묶는 계산

통합 서버가 네이티브 MCP 방식으로 전체 스키마를 노출하면 도구 2,594개에 토큰 1,170,523개가 들어 200K 컨텍스트의 585%를 차지합니다. 필수 파라미터만 남긴 축소판도 244,047개(122%)로 한도를 넘습니다. 반면 search·execute·docs·whoami 네 도구로 묶은 Code Mode는 약 1,100개(0.5%)만 씁니다.

search 도구가 OpenAPI 스펙(spec.paths)을 코드로 훑어 엔드포인트를 찾고, execute 도구가 cloudflare.request()를 호출해 실제 API를 실행합니다. 스펙 자체는 서버에 남고 코드 실행 결과만 모델에 돌아오므로 엔드포인트 수가 늘어도 노출 토큰은 고정됩니다. 호출 코드는 Dynamic Worker Loader API로 격리된 Worker 안에서 실행됩니다.

전환 전에 확정해야 할 4가지: 운영 체크리스트

전환 전에 토큰 예산을 수치로 선언합니다. 목표는 컨텍스트 사용률 1% 이하(Code Mode 기준 0.5%), 네이티브 모드로 되돌리는 "?codemode=false" 호출은 비상 디버깅용으로만 제한, 결과 캡은 기본 약 6,000토큰이므로 대용량 응답이 필요한 호출만 truncate: false로 예외 처리하는 기준을 미리 정해 둡니다.

실패 패턴은 네 가지입니다. 전환 공지만 보고 호출 방식을 그대로 두면 네이티브 스키마가 1,170,523토큰을 요구해 컨텍스트가 585%까지 치솟고, 폐기 목록 10개 서버 URL을 방치하면 종료일 없는 공지 뒤에 연결이 갑자기 끊깁니다. IP 필터링을 켠 API 토큰은 통합 서버가 지원하지 않아 인증이 조용히 실패하며, Account Resources:Read 권한이 없는 계정 토큰은 execute 호출이 거부됩니다.

복구 분기는 두 단계입니다. 인증 실패가 뜨면 즉시 OAuth 경로로 바꿔 토큰 스코프 문제를 피하고, 응답이 캡에 걸려 잘리면 truncate 옵션을 끄고 재시도하는 순서를 코드로 고정합니다.

운영 체크리스트에는 호출 로그에 tool_count, context_pct, truncate 설정, 인증 방식 네 필드를 필수로 남기고, 폐기된 10개 서버 엔드포인트를 분기마다 전수 점검해 연결 가능 여부를 표로 관리합니다. 전환 직후에는 ?codemode=false와 true 양쪽 응답을 한 주간 병행 비교해 회귀가 없는지 확인합니다.

지속 개선 루프는 벤더의 폐기 공지 패턴을 추적하는 데서 시작합니다. 종료일이 없는 "가능한 빨리" 문구가 반복되면 재확인 주기(월 1회)를 정해, 공지와 실제 차단 사이의 공백을 운영팀이 스스로 메웁니다.

한눈에 보는 적용 포인트

Cloudflare가 Vectorize 기반 AutoRAG를 비롯한 제품별 MCP 서버 10개를 접고 search·execute 중심 Code Mode로 합친 결정은 도구 설계의 기준을 "타입 안전성"에서 "토큰 예산"으로 옮겼습니다. 전환 목표를 컨텍스트 사용률 1% 이하로 수치화하고 인증 실패·응답 캡·종료일 없는 폐기 공지라는 세 실패 지점을 체크리스트에 박아두면 다음 통합 발표에도 같은 절차로 대응할 수 있습니다.

참고 링크

Cloudflare API MCP Server — cloudflare/mcp

Cloudflare MCP Servers(제품별, 폐기 목록) — cloudflare/mcp-server-cloudflare