Cloudflare MCP 서버 — 설명

개요

AI 어시스턴트(Claude, Cursor 등)가 자연어로 Cloudflare 서비스와 대화할 수 있게 해주는 여러 MCP 서버가 포함된 리포지토리입니다. MCP(Model Context Protocol)는 AI 모델이 외부 시스템과 컨텍스트를 교환하기 위한 표준화된 방법입니다.

기능

이 서버들을 통해 AI 어시스턴트는 Cloudflare 계정 설정을 읽고, 정보를 처리하며, 이를 기반으로 제안하고, 변경 사항을 적용할 수 있습니다. 이는 애플리케이션 개발, 보안, 성능 도구 등 Cloudflare 제품 전반에 걸쳐 작동합니다.

기술적 작동 방식

• 각 서버는 /mcp 경로에서 무상태 HTTP 핸들러를 노출합니다(새 SDK v2 서버 팩토리로 구축).
• 이전 /sse URL은 폐기되었으며, 모든 요청에 새 /mcp URL을 가리키는 410 Gone 오류로 응답하므로 MCP 클라이언트는 연결 시 해당 메시지를 표시합니다.
• 모던(2026) 및 무상태(2025) 요청은 동일한 요청 범위 구현을 공유합니다. 영구적인 MCP 프로토콜 세션은 없습니다.
• OAuth, 자격 증명, 계정 선택, 애플리케이션 캐시, 제품 Durable Objects 등은 필요에 따라 애플리케이션/보안 상태로 유지됩니다.

두 가지 서버 유형

1. Cloudflare API MCP 서버(권장, mcp.cloudflare.com에서 호스팅, 별도 리포지토리 cloudflare/mcp에서 유지 관리) — 코드 실행을 통한 광범위한 액세스에 가장 적합하며 여러 Cloudflare API에 액세스할 수 있습니다. 소수의 범용 도구를 사용합니다.
2. 도메인별 서버(이 리포지토리, *.mcp.cloudflare.com에서 호스팅) — 특정 제품 영역을 위한 선별된 유형화된 도구에 가장 적합합니다. 더 안내된 상호 작용을 제공하며 주로 단일 Cloudflare 도메인에서 작업할 때 이상적입니다.

이 리포지토리의 서버

서버	기능	URL
Documentation	Cloudflare에 대한 최신 참조 정보 제공	https://docs.mcp.cloudflare.com/mcp
Container	샌드박스 개발 환경 시작	https://containers.mcp.cloudflare.com/mcp
Browser Run	웹 페이지 가져오기, 마크다운 변환, 스크린샷 촬영	https://browser.mcp.cloudflare.com/mcp
Digital Experience Monitoring	조직의 중요한 애플리케이션에 대한 빠른 통찰력 제공	https://dex.mcp.cloudflare.com/mcp
Cloudflare One CASB	SaaS 앱의 보안 구성 오류 식별	https://casb.mcp.cloudflare.com/mcp
Cloudflare Blog	Cloudflare 블로그 게시물 검색 및 읽기	https://blog.mcp.cloudflare.com/mcp
Demo Day	최소 Cloudflare MCP 서버 데모	https://demo-day.mcp.cloudflare.com/mcp

더 이상 사용되지 않는 서버(Cloudflare API MCP 서버로 마이그레이션): AI Gateway, Audit Logs, AutoRAG, DNS Analytics, GraphQL, Logpush, Observability, Radar, Workers Bindings, Workers Builds.

연결 방법

원격 서버를 지원하는 모든 MCP 클라이언트를 위 표의 URL에 직접 연결합니다. Cloudflare AI Playground도 인터페이스에서 서버 URL을 허용합니다.

OpenAI Responses API와 함께 사용

해당 특정 MCP 서버에 필요한 **범위(권한)**가 있는 API 토큰이 필요합니다. 예: OpenAI와 함께 Browser Run 서버를 사용하려면 Cloudflare 대시보드에서 적절한 권한으로 API 토큰을 생성합니다(정확한 설정은 README의 스크린샷에 있음).

문제 해결

"Claude의 응답이 중단되었습니다..." 메시지가 표시되면 Claude가 응답 중에 컨텍스트 길이 제한에 도달했을 가능성이 높습니다. 이는 연결된 여러 도구 호출(예: 관찰 가능성 서버)을 트리거하는 서버에서 가장 일반적입니다. 줄이려면:

• 구체적이고 간결하게 질의하세요.
• 큰 요청을 더 작은 도구 호출 여러 개로 나누세요.

유료 기능

일부 기능에는 유료 Cloudflare Workers 플랜이 필요할 수 있습니다. 계정에 필요한 구독 수준이 있는지 확인하세요.

기여

기여 방법과 로컬에서 서버 실행 방법은 CONTRIBUTING.md를 참조하세요.