개발자가 단일 세션에서 Claude Code로 WhatsApp 비즈니스 MCP 서버 구축

한 개발자가 단일 코딩 세션에서 Claude Code를 사용하여 완전한 WhatsApp Business MCP 서버를 구축했습니다. 이 서버는 Claude를 WhatsApp Business API와 연결하여 사용자가 Claude에게 WhatsApp 메시지를 보내도록 요청하고 해당 명령을 실행할 수 있게 합니다.

기술적 구현

이 프로젝트는 다음과 같은 아키텍처와 기능으로 구축되었습니다:

• 아키텍처: Cloudflare Workers + D1 + KV + Durable Objects
• 도구 핸들러: Zod 검증을 포함한 35개의 도구 핸들러
• 테스트: 72개의 단위 및 통합 테스트
• 결제 시스템: Lemonsqueezy 웹훅 및 API 키 생성
• 다중 테넌트 지원: 각 사용자에게 고유한 WhatsApp 자격 증명 제공
• 보안 감사: 다중 병렬 에이전트가 16개의 취약점을 발견하고 수정
• 배포: 터미널에서 Cloudflare Workers로 직접 배포

서버 기능

MCP 서버는 8개의 모듈을 포함합니다:

• 메시지
• 인터랙티브 버튼/목록
• 템플릿
• 미디어
• 웹훅 (메시지 수신)
• 비즈니스 프로필
• WhatsApp Flows
• 분석

웹훅 모듈은 독특합니다 — 다른 WhatsApp MCP 서버는 실제로 수신 메시지를 받을 수 없습니다.

기술적 세부사항

• TypeScript 엄격 모드
• 72개 테스트 통과
• 웹훅 검증을 위한 타이밍 안전 HMAC
• 미디어 업로드에 대한 SSRF 보호
• 별도의 Durable Object 인스턴스를 통한 테넌트 격리
• API 키별 속도 제한

이 프로젝트는 5개의 도구와 API 키 없이 무료로 사용해 볼 수 있습니다. 개발자는 Claude Code로 MCP 서버를 구축하는 것에 대한 질문에 기꺼이 답변하겠다고 언급했습니다.