Cloudflare에서 원격 MCP 서버 구축하기 (인증 없이)

이 예제를 사용하면 Cloudflare Workers에서 인증이 필요 없는 무상태(stateless) 원격 MCP 서버를 배포할 수 있습니다. 일반적인 도구 호출을 위한 레거시 클라이언트와도 호환성을 유지하면서 MCP 2026-07-28 사양을 구현합니다.

시작하기:

이렇게 하면 MCP 서버가 remote-mcp-server-authless.<your-account>.workers.dev/mcp와 같은 URL로 배포됩니다.

또는 아래 명령줄을 사용하여 로컬 머신에 원격 MCP 서버를 생성할 수 있습니다:

npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

Related MCP server: Cloudflare Remote MCP Server

MCP 서버 커스터마이징

MCP 서버에 고유한 도구를 추가하려면 src/index.ts의 createServer() 함수에서 생성된 McpServer에 server.registerTool(...)을 사용하여 각 항목을 등록하세요.

Cloudflare AI Playground에 연결

Cloudflare AI Playground는 원격 MCP 클라이언트이므로, 여기에서 MCP 서버에 연결할 수 있습니다:

1. https://playground.ai.cloudflare.com/로 이동합니다.

2. 배포된 MCP 서버 URL(remote-mcp-server-authless.<your-account>.workers.dev/mcp)을 입력합니다.

3. 이제 플레이그라운드에서 MCP 도구를 직접 사용할 수 있습니다!

Claude Desktop을 MCP 서버에 연결

로컬 MCP 클라이언트에서도 mcp-remote 프록시를 사용하여 원격 MCP 서버에 연결할 수 있습니다.

Claude Desktop에서 MCP 서버에 연결하려면 Anthropic's Quickstart 가이드를 따르고, Claude Desktop에서 Settings > Developer > Edit Config로 이동하세요.

이 구성으로 업데이트하세요:

{
	"mcpServers": {
		"calculator": {
			"command": "npx",
			"args": [
				"mcp-remote",
				"http://localhost:8787/mcp" // or remote-mcp-server-authless.your-account.workers.dev/mcp
			]
		}
	}
}

Claude를 다시 시작하면 도구를 사용할 수 있게 됩니다.