Cloudflare MCP 서버

Model Context Protocol(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하기 위한 새로운 표준화된 프로토콜입니다. 이 저장소에서는 MCP 클라이언트(예: Cursor, Claude)에서 Cloudflare 서비스에 연결하고 자연어를 사용하여 Cloudflare 계정을 통해 작업을 수행할 수 있도록 하는 여러 MCP 서버를 찾을 수 있습니다.

이러한 MCP 서버를 사용하면 MCP 클라이언트가 계정에서 구성을 읽고, 정보를 처리하고, 데이터를 기반으로 제안을 하며, 제안된 변경 사항을 직접 적용할 수도 있습니다. 이러한 모든 작업은 애플리케이션 개발, 보안 및 성능을 포함한 Cloudflare의 다양한 서비스 전반에서 수행될 수 있습니다.

이 서버들은 /mcp를 통한 streamable-http 전송과 /sse를 통한 sse 전송(사용 중단 예정)을 모두 지원합니다.

이 저장소에는 다음 서버들이 포함되어 있습니다:

어떤 Cloudflare MCP 서버를 사용해야 할까요?

Cloudflare는 두 가지 범주의 MCP 서버를 제공합니다:

• 코드 모드 서버 (mcp.cloudflare.com) - cloudflare/mcp: 코드 실행을 통해 Cloudflare API 전반에 걸쳐 광범위한 액세스가 필요할 때 가장 좋습니다.

• 도메인별 서버 (*.mcp.cloudflare.com) - 이 저장소: 특정 Cloudflare 제품 영역에 대해 큐레이팅되고 유형이 지정된 도구가 필요할 때 가장 좋습니다.

각각 언제 사용해야 할까요?

다음의 경우 코드 모드 서버를 사용하세요:

• 많은 Cloudflare 제품 전반에 걸쳐 광범위한 API 커버리지가 필요한 경우

• 더 적은 수의 범용 도구를 선호하는 경우

• 워크플로우가 코드 실행에 더 적합한 경우

다음의 경우 이 저장소의 도메인별 서버를 사용하세요:

• 특정 제품 영역을 위해 특별히 제작된 도구를 원하는 경우

• 더 안내가 잘 되고 유형이 지정된 상호 작용을 원하는 경우

• 관측 가능성, 바인딩, Radar 또는 브라우저 렌더링과 같은 하나의 Cloudflare 도메인 내에서 주로 작업하는 경우

코드 모드 서버에 대한 자세한 내용은 여기에서 확인하세요: cloudflare/mcp.

Related MCP server: Azure MCP Server

모든 MCP 클라이언트에서 원격 MCP 서버에 액세스

사용 중인 MCP 클라이언트가 원격 MCP 서버를 기본적으로 지원하는 경우, 클라이언트 인터페이스 내에서 직접 서버 URL을 수락하는 방법을 제공합니다(예: Cloudflare AI Playground).

클라이언트가 아직 원격 MCP 서버를 지원하지 않는 경우, mcp-remote(https://www.npmjs.com/package/mcp-remote)를 사용하여 클라이언트가 액세스할 수 있는 서버를 지정하도록 해당 구성 파일을 설정해야 합니다.

{
	"mcpServers": {
		"cloudflare-observability": {
			"command": "npx",
			"args": ["mcp-remote", "https://observability.mcp.cloudflare.com/mcp"]
		},
		"cloudflare-bindings": {
			"command": "npx",
			"args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/mcp"]
		}
	}
}

OpenAI Responses API에서 Cloudflare의 MCP 서버 사용하기

Cloudflare의 MCP 서버 중 하나를 OpenAI의 Responses API와 함께 사용하려면, 해당 특정 MCP 서버에 필요한 범위(권한)가 있는 API 토큰을 Responses API에 제공해야 합니다.

예를 들어, Browser Rendering MCP 서버를 OpenAI와 함께 사용하려면 Cloudflare 대시보드 여기에서 다음 권한을 가진 API 토큰을 생성하세요:

더 많은 Cloudflare 도구에 대한 액세스가 필요하신가요?

저희는 이 원격 MCP 서버 저장소에 더 많은 기능을 계속 추가하고 있습니다. 피드백을 남기거나, 버그를 신고하거나, 기능 요청을 하려면 이 저장소에 이슈를 열어주세요.

문제 해결

"Claude의 응답이 중단되었습니다 ..."

이 메시지가 표시되면 Claude가 컨텍스트 길이 제한에 도달하여 응답 도중에 중단된 것입니다. 이는 관측 가능성 서버와 같이 많은 연쇄 도구 호출을 트리거하는 서버에서 가장 자주 발생합니다.

이 문제가 발생할 가능성을 줄이려면:

• 구체적으로 질문하고 쿼리를 간결하게 유지하세요.

• 단일 요청이 여러 도구를 호출하는 경우, 응답을 짧게 유지하기 위해 여러 개의 작은 도구 호출로 나누어 보세요.

유료 기능

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

기여

기여에 관심이 있거나 이 서버를 로컬에서 실행하고 싶으신가요? 시작하려면 CONTRIBUTING.md를 참조하세요.