왓츠앱 대화 검색용 MCP 서버 공개

ai.euno.news 자동 뉴스 요약

개인 왓츠앱 대화를 인공지능(AI) 에이전트가 검색하고 읽을 수 있게 하는 오픈소스 MCP(Model Context Protocol) 서버 whatsapp-mcp가 공개됐다. 사용자가 자신의 클라우드플레어(Cloudflare) 계정에 서버를 배포하고 휴대전화를 한 번 연결하면, 클로드 코드·클로드 데스크톱을 비롯한 MCP 클라이언트가 대화 내용을 검색하거나 요약할 수 있다. 메시지를 보내는 기능은 없는 읽기 전용 도구다.¹

가령 “Dana가 항공편에 관해 뭐라고 했지?”, “모든 채팅에서 임대 계약을 언급한 메시지를 찾아줘”, “이번 주 가족 단체방에서 놓친 내용을 요약해줘”처럼 질문할 수 있다. 전화번호에 이름을 붙여 저장하는 기능도 제공한다. 왓츠앱이 연결 기기에 모든 연락처 이름을 전달하지 않아 일부 대화가 번호로만 표시되기 때문이다. 다만 서버가 연락처 서비스에 직접 접속하지는 않는다. 이름을 확인하려면 AI 에이전트에 구글 연락처나 지메일 같은 별도 연동 수단이 있어야 한다.¹

필요할 때만 접속하는 구조#

휴대전화는 계속 원본 데이터의 기준으로 남고, 서버는 왓츠앱 웹처럼 연결 기기로 동작한다. 서버는 상시 접속하지 않는다. 에이전트가 요청할 때와 하루에 한 번 왓츠앱에 연결해, 이전 접속 이후 대기 중이던 메시지를 받아온 뒤 연결을 끊는다. 수집한 메시지는 사용자 클라우드플레어 계정의 듀러블 오브젝트(Durable Object) 안에 있는 SQLite 데이터베이스에 저장되며, 개발자는 다른 곳으로 전송되지 않는다고 설명한다.¹

설치에는 Node.js 20 이상과 휴대전화, 클라우드플레어 Workers 유료 요금제가 필요하다. 저장소를 내려받아 의존성을 설치한 뒤 인증 토큰용 KV 네임스페이스와 12자 이상의 소유자 암호를 설정하고 배포한다. 이후 웹 화면에서 QR 코드나 전화번호로 왓츠앱을 연결하고, 발급된 /mcp 주소를 MCP 클라이언트에 등록한다. 최초 연결 때는 대화 기록을 한꺼번에 해독하므로 기본 CPU 한도가 부족할 수 있다. 설정 파일은 이를 위해 한도를 높였으며, 개발자는 무료 요금제를 시험하지 않았다고 밝혔다.¹

비공식 연동이 남기는 제약#

이 서버는 왓츠앱 공식 기능이 아니다. 개인 메시지를 읽는 공식 API가 없어, 오픈소스 라이브러리 베일리스(Baileys)로 왓츠앱 웹과 같은 프로토콜을 사용한다. 이는 왓츠앱 이용약관에 어긋나며, 개발자는 읽기 전용 연결의 실질적 위험이 낮다고 보면서도 위험이 전혀 없지는 않다고 명시했다.¹

가져올 수 있는 기록도 왓츠앱이 새 연결 기기에 제공하는 범위로 제한돼 전체 대화가 아닐 수 있다. 다시 연결하면 기존 저장분을 유지하면서 누락분을 보충할 수 있다. 사진·음성 메시지·문서는 내려받지 않으며 [image], [voice note 12s] 같은 표시와 설명만 남는다. 음성 변환도 지원하지 않는다. 배포 하나가 왓츠앱 계정 하나와 소유자 한 명만을 위한 구조라는 점 역시 운영 범위를 분명히 한다.¹

읽기 목록은 이 브라우저에 저장됩니다.