Cloudflare Workers와 Stripe를 활용한 유료 MCP 서버 구축 가이드

핵심 기술

본 문서는 AI 모델과의 상호작용을 표준화하는 Model Context Protocol (MCP)을 Cloudflare Workers의 서버리스 환경과 Stripe의 결제 시스템을 결합하여 유료 서비스로 구축하는 실용적인 방법을 제시합니다.

기술적 세부사항

• MCP 서버 구축: McpServer 클래스를 인스턴스화하고 init() 메소드에서 도구를 정의합니다.
• 유료 도구 정의: paidTool 메소드를 사용하여 도구 이름, 파라미터 스키마, 실행 함수, 그리고 결제 설정을 구성합니다.
  • 예시: wporg_query_themes 도구의 파라미터 정의 (z.string().optional().describe(...)) 및 실행 로직.
• Stripe 통합: experimental_PaidMcpAgent 클래스를 통해 Stripe 인스턴스 초기화, 고객 ID 관리, 결제 상태 확인, 결제 세션 생성 기능을 제공합니다.
• 인증: GitHub OAuth를 OAuthProvider를 통해 구현하여 사용자 식별 및 개인화된 결제를 지원합니다.
• 결제 상태 관리: Cloudflare Workers의 Durable Objects를 사용하여 사용자별 결제 상태 (구매한 도구, 구독 정보, 고객 ID 등)를 추적합니다.
• 결제 설정 구성: generatePaidToolConfig 함수를 사용하여 가격 ID, 성공 URL, 미터링 이벤트 등을 쉽게 정의합니다.
• 하이브리드 도구 지원: 무료 도구와 유료 도구를 동일한 MCP 서버 내에서 혼합하여 사용할 수 있습니다.
• 사용량 기반 과금: meterEvent 파라미터를 사용하여 API 사용량에 따른 과금 모델을 구현할 수 있습니다.

개발 임팩트

• 서버리스 환경에서의 확장 가능하고 관리 용이한 유료 API 서비스 구축이 가능합니다.
• AI 모델 생태계에서 API 제공자의 수익화 모델을 간소화합니다.
• MCP 프로토콜 표준화에 따라 관련 서버 구현의 중요성이 증대될 것으로 예상됩니다.

커뮤니티 반응

문서 자체에는 구체적인 커뮤니티 반응이 언급되지 않았지만, 관련 GitHub 링크 (agent-toolkit, remote-mcp-github-oauth)를 제공하여 실제 구현 및 활용에 대한 정보를 공유하고 있습니다.