Cloudflare의 원격 MCP 서버

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

지역적으로 개발하다

지엑스피1

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

Related MCP server: Remote MCP Server on Cloudflare

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

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

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

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

• 베어러 토큰을 추가하고 "연결"을 클릭하세요.

• "목록 도구"를 클릭하세요

• 검사기에서 설정한 Authorization 헤더를 반환해야 하는 "getToken" 도구를 실행하세요.

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

{
  "mcpServers": {
    "remote-mcp-server-bearer-auth": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ]
    },
    "env": {
      "AUTH_TOKEN": "..."
    }
  }
}

Cloudflare에 배포

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 서버에 연결되었습니다. 위에서 언급한 것처럼 Bearer 토큰을 전달할 수 있습니다.

디버깅

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

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

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

rm -rf ~/.mcp-auth