Cloudflare의 원격 MCP 서버

Cloudflare Workers에서 OAuth 로그인을 포함한 원격 MCP 서버를 구동해 보겠습니다!

지역적으로 개발하다

지엑스피1

브라우저에서 http://localhost:8787/ 열 수 있어야 합니다.

Related MCP server: Remote MCP Server

MCP 검사기를 서버에 연결하세요

새로운 MCP API를 살펴보려면 MCP Inspector를 사용하세요.

• npx @modelcontextprotocol/inspector 로 시작하세요

• 검사기 내에서 전송 유형을 SSE 로 전환하고 연결할 MCP 서버의 URL로 http://localhost:8787/sse 입력한 후 "연결"을 클릭합니다.

• (가상) 사용자/비밀번호 로그인 화면으로 이동합니다. 이메일 주소와 비밀번호를 입력하여 로그인하세요.

• MCP 검사기로 다시 돌아가서 정의된 도구를 나열하고 호출할 수 있습니다!

Claude Desktop을 로컬 MCP 서버에 연결하세요

MCP 검사기는 훌륭하지만, Claude에 연결하고 싶습니다! Anthropic의 빠른 시작을 따라 Claude Desktop에서 설정 > 개발자 > 구성 편집으로 이동하여 구성 파일을 찾으세요.

텍스트 편집기에서 파일을 열고 다음 구성으로 바꾸세요.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

이렇게 하면 로컬 프록시가 실행되고 Claude가 HTTP를 통해 MCP 서버와 통신할 수 있습니다.

Claude를 열면 브라우저 창이 열리고 로그인할 수 있습니다. 오른쪽 하단에 사용 가능한 도구가 표시됩니다. 오른쪽 프롬프트가 나타나면 Claude가 도구를 호출할지 묻습니다.

Cloudflare에 배포

1. npx wrangler kv namespace create OAUTH_KV

2. wrangler.jsonc 에 kv 네임스페이스 ID를 추가하려면 지침을 따르세요.

3. npm run deploy

원격 MCP 클라이언트에서 새로 배포된 원격 MCP 서버를 호출합니다.

위의 "로컬에서 개발"에서 한 것처럼 MCP 검사기를 실행합니다.

npx @modelcontextprotocol/inspector@latest

그런 다음 검사기에 Worker의 workers.dev URL(예: worker-name.account-name.workers.dev/sse )을 연결할 MCP 서버의 URL로 입력하고 "연결"을 클릭합니다.

이제 원격 MCP 클라이언트에서 MCP 서버에 연결되었습니다.

Claude Desktop을 원격 MCP 서버에 연결합니다.

Claude 구성 파일을 업데이트하여 workers.dev URL(예: worker-name.account-name.workers.dev/sse )을 가리키고 Claude를 다시 시작합니다.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://worker-name.account-name.workers.dev/sse"
      ]
    }
  }
}

디버깅

문제가 발생하면 Claude를 다시 시작하거나 다음 명령을 사용하여 명령줄에서 MCP 서버에 직접 연결을 시도하면 도움이 될 수 있습니다.

npx mcp-remote http://localhost:8787/sse

드물지만 ~/.mcp-auth 에 추가된 파일을 지우는 것이 도움이 될 수 있습니다.

rm -rf ~/.mcp-auth