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: remote-mcp-server-authless

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. 이제 Playground에서 MCP 도구를 직접 사용할 수 있습니다!

Claude Desktop을 MCP 서버에 연결하기

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

Claude Desktop에서 MCP 서버에 연결하려면 Anthropic의 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를 다시 시작하면 도구를 사용할 수 있게 됩니다.